TikTok Shop Creator Detail

12 credits/call
ae_tiktok_shop_creator_detail

Retrieve detailed TikTok Shop creator profile and performance data from Kalodata. Depending on the requested country and period, results include creator profile and contact details, follower and video/livestream metrics, and category-attributed sales and revenue trends. Use the creator ID and select a supported country, currency, language, and date range; category and shop filters can narrow sales attribution.

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)YesRequired country code for the TikTok Shop data. Choose one of the listed supported countries; this is not limited to the US.—
shop_idstringNoOptional shop ID used to restrict sales attribution to products from that shop.—
currencyenum (CNY | USD | IDR | VND | THB | MYR | JPY | PHP | GBP | SGD | MXN | EUR | BRL | PLN | CZK | HUF)YesCurrency unit for revenue and price fields. Choose one of the listed supported currencies.—
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 requested for text fields in the response. Choose one of the listed supported language codes.—
creator_idstringYesRequired creator ID to look up.—
date_rangestringYesDate range for creator performance data. This operation's source documents named ranges (lastDay, last7Day, last30Day, last60Day, last90Day, last180Day, last365Day), a date interval in yyyy-MM-dd~yyyy-MM-dd form, or a month in yyyy-MM form.—
need_extrabooleanNoWhether to request extra information.—
category_idsarrayNoOptional category IDs used to restrict sales attribution to the selected categories.—

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_creator_detail' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "creator_id": "6699861101489914885",
    "currency": "USD",
    "date_range": "last7Day",
    "language": "zh-CN",
    "need_extra": true,
    "region": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "cached": null,
  "code": null,
  "data": {
    "creator_belonged_shop_id": "",
    "creator_bio": "https://linktr.ee/sallyscloset",
    "creator_contact_email": "sallys.closet11@gmail.com",
    "creator_contact_facebook": "",
    "creator_contact_ins": "sallyscloset.co",
    "creator_contact_line": ""
  },
  "message": null,
  "success": true
}

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