TikTok Shop Category Detail
12 credits/call
ae_tiktok_shop_category_detail
Retrieve performance details for a specific TikTok Shop category, including sales, revenue, growth, active product and shop counts, and revenue by channel. Data is provided by Kalodata; `region` selects the country, so the data is not limited to the US. Provide the category ID, currency, language, country, and date range. **`date_range`** accepts only `last7Day`, `last30Day`, `last90Day`, `last180Day`, or `last365Day`; custom date ranges, calendar months, and `lastDay` are not supported. The request is synchronous; use the returned response directly.
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 | 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. | — |
currency | enum (CNY | USD | IDR | VND | THB | MYR | JPY | PHP | GBP | SGD | MXN | EUR | BRL | PLN | CZK | HUF) | Yes | Currency unit for revenue and price fields. Currently supports CNY, USD, IDR, VND, THB, MYR, JPY, PHP, GBP, SGD, MXN, EUR, BRL, PLN, CZK, HUF. | — |
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. 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. | — |
date_range | enum (last7Day | last30Day | last90Day | last180Day | last365Day) | Yes | Category queries support only last7Day, last30Day, last90Day, last180Day or last365Day. Custom date ranges, natural months and lastDay are not supported. | — |
category_id | string | Yes | Category ID to query. | — |
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_category_detail' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"category_id": "601450",
"currency": "USD",
"date_range": "last7Day",
"language": "en-US",
"region": "US"
}
}'Response exampleresponse.json
{
"cached": null,
"code": null,
"data": {
"active_product_number": 137212,
"affiliate_revenue": 90962031.75,
"average_shop_revenue": 6586.49,
"category_id": "601450",
"category_name": "Beauty & Personal Care",
"live_revenue": 18954383.03
},
"message": null,
"success": true
}This example shows part of the response. Copied content is valid JSON.

