TikTok Shop Product Analysis

12 credits/call
ae_tiktok_shop_product_analysis

Retrieve TikTok Shop product highlights and attributes through Kalodata. Submit an AE asynchronous task with product_id, region, and language; AE returns a task_id and continues processing in the background with the same product_id, region, and language. Use ae_get_result with the original task_id to retrieve the analysis. Do not resubmit the analysis to wait for completion.

Social
12 credits/call

Pricing

12 credits/call
ConditionCharge
Each call12 credits/call

A fixed fee of 12 credits applies to each successful query.

If the product analysis is not yet available, the first request may trigger generation. Requests that return a generation-in-progress status or an upstream failure are not charged. Retry later with the same product ID, region and language.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
regionenum (US | BR | MX | ID | JP | MY | PH | SG | TH | VN | GB | ES | DE | FR | IT | PL | NL | BE | CZ | AT | GR | PT | HU | IE)YesData country code, e.g. US, BR, MX, ID, JP, MY, PH, SG, TH, VN, GB, ES, DE, FR, IT, PL, NL, BE, CZ, AT, GR, PT, HU, IE.—
languageenum (zh-CN | en-US | id-ID | th-TH | vi-VN | es-ES | ja-JP | pt-BR | ko-KR | fr-FR | de-DE | pl-PL | nl-NL | cs-CZ | el-GR | hu-HU | pt-PT | it-IT)YesLanguage for selling points and attributes. Currently supports zh-CN, en-US, id-ID, th-TH, vi-VN, es-ES, ja-JP, pt-BR, ko-KR, fr-FR, de-DE, pl-PL, nl-NL, cs-CZ, el-GR, hu-HU, pt-PT, it-IT.—
product_idstringYesTikTok product ID—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_product_analysis' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "language": "en-US",
    "product_id": "1732584135198478702",
    "region": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "1dd43781-6a29-465c-ad27-2792fa8bf459"
}

This example shows part of the response. Copied content is valid JSON.