TikTok Shop Product Detail
12 credits/call
ae_tiktok_shop_product_detail
Retrieve detailed information and performance metrics for a specific TikTok Shop product, such as product details, pricing, sales and revenue, and promotion activity. Data is provided by Kalodata. Select the country with region and choose a date range for time-based metrics. The response may include product_description as structured text/image blocks; this can be empty when unavailable.
12 credits/call
Pricing
12 credits/call
| Condition | Charge |
|---|---|
| Each call | 12 credits/call |
A fixed charge of 12 credits applies to each call.
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 | Country whose TikTok Shop product data to query. Select one of the listed country codes; coverage is not limited to the US. | — |
currency | enum (CNY | USD | IDR | VND | THB | MYR | JPY | PHP | GBP | SGD | MXN | EUR | BRL | PLN | CZK | HUF) | Yes | Currency to use for revenue and price fields. Select one of the listed currency codes. | — |
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 text fields in the response. Select one of the listed language codes. | — |
date_range | string | Yes | Time range for product performance metrics. Select a supported named range (lastDay, last7Day, last30Day, last60Day, last90Day, last180Day, or last365Day), a date range in yyyy-MM-dd~yyyy-MM-dd form, or a month in yyyy-MM form. Availability may vary by endpoint; use a range supported by this endpoint. | — |
need_extra | boolean | No | Whether to request additional product information. | — |
need_image | integer | No | Controls the main image URL returned: 0 does not request a URL, 1 requests the official URL, and 2 requests a Kalodata-hosted image URL. | — |
product_id | string | Yes | ID of the TikTok Shop product to look up. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_shop_product_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"currency": "USD",
"date_range": "last7Day",
"language": "zh-CN",
"need_image": 0,
"product_id": "1732506453676692122",
"region": "US"
}
}'Response exampleresponse.json
{
"cached": null,
"code": null,
"data": {
"commission_rate": 10.0,
"creator_number": 39,
"delivery_type": "local",
"launch_date": "2026-09-03",
"live_number": 0,
"live_revenue": 0.0
},
"message": null,
"success": true
}This example shows part of the response. Copied content is valid JSON.

