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.

Social
12 credits/call

Pricing

12 credits/call
ConditionCharge
Each call12 credits/call

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)YesTikTok Shop 数据所属国家/地区代码。请从该接口支持的国家代码中选择。—
shop_idstringYes要查询的店铺 ID。—
currencyenum (CNY | USD | IDR | VND | THB | MYR | JPY | PHP | GBP | SGD | MXN | EUR | BRL | PLN | CZK | HUF)Yes营收和价格字段使用的货币单位。—
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)Yes响应中文本字段的语言。—
date_rangestringYes统计日期范围。已确认支持 last7Day 和自然月值 2026-10;其他日期范围本轮未验证,不作承诺。—
need_extrabooleanNo是否请求供应商可提供的额外信息;可省略,实际附加字段依数据可用性而定。—
category_idsarrayNo可选的类目 ID 列表,用于限制营收归因的类目。—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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
JSONPartial content
{
  "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.