TikTok Shop Store Detail
12 credits/call
ae_tiktok_shop_store_detail
Retrieve profile and performance details for a TikTok Shop, including revenue, sales volume, average unit price, revenue trends and breakdowns, and counts of products, affiliate creators, videos, and livestreams for a selected country and reporting period. Data is provided by Kalodata. Select the country with `region`; the public tool name describes the TikTok Shop capability.
12 credits/call
Pricing
12 credits/call
| Condition | Charge |
|---|---|
| Each call | 12 credits/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 | TikTok Shop 数据所属国家/地区代码。请从该接口支持的国家代码中选择。 | — |
shop_id | string | Yes | 要查询的店铺 ID。 | — |
currency | enum (CNY | USD | IDR | VND | THB | MYR | JPY | PHP | GBP | SGD | MXN | EUR | BRL | PLN | CZK | HUF) | Yes | 营收和价格字段使用的货币单位。 | — |
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 | 响应中文本字段的语言。 | — |
date_range | string | Yes | 统计日期范围。已确认支持 last7Day 和自然月值 2026-10;其他日期范围本轮未验证,不作承诺。 | — |
need_extra | boolean | No | 是否请求供应商可提供的额外信息;可省略,实际附加字段依数据可用性而定。 | — |
category_ids | array | No | 可选的类目 ID 列表,用于限制营收归因的类目。 | — |
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_store_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"currency": "IDR",
"date_range": "last7Day",
"language": "en-US",
"region": "ID",
"shop_id": "7495818627816589392"
}
}'Response exampleresponse.json
{
"cached": null,
"code": null,
"data": {
"affiliate_revenue": 0.0,
"creator_number": 0,
"live_number": 0,
"product_number": 12,
"region": "ID",
"revenue": 22967076.69
},
"message": null,
"success": true
}This example shows part of the response. Copied content is valid JSON.

