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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 12 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
region | enum (US | BR | MX | ID | JP | MY | PH | SG | TH | VN | GB | ES | DE | FR | IT | PL | NL | BE | CZ | AT | GR | PT | HU | IE) | Yes | Data 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. | — |
language | enum (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) | Yes | Language 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_id | string | Yes | TikTok product ID | — |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-KeySubmit first, then query with the returned task_id until the task completes.
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"
}
}'{
"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.

