TikTok Shop Request
1 credits/call
ae_tiktok_shop_request
Look up details of a TikTok seller by shop ID. Provide shop_id as a string; optionally select site from Unknow, US, MY, PH, VN, TH, ID, GB, or JP (default: Unknow). The provider does not specify the returned fields.
1 credits/call
Pricing
1 credits/call
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
shop_id | string | Yes | The Shop ID. Example: 8646932002846773930. | — |
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_request' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"shop_id": "7495669770456697723",
"site": "US"
}
}'Response exampleresponse.json
{
"data": {
"fans_count": 5183,
"max_category": {
"Name": "Decorations",
"NodeId": "819976"
},
"monthly_sale_amount": 0.0,
"monthly_sale_count": 0,
"new_product_count": 0,
"photo": "https://p16-oec-general.ttcdn-us.com/tos-maliva-i-o3syd03w52-us/7d13353c71ce46eca48d6cf82e76769a~tplv-fhlh96nyum-resize-webp:300:300.webp?dr=12185&t=555f072d&ps=933b5bde&shp=905da467&shcp=607f11de&idc=useast5&from=2422056039"
},
"doc": {
"fans_count": "Follower count.",
"max_category": "Top business category, as a JSON object.",
"max_category.Name": "Category name.",
"max_category.NodeId": "Category nodeId.",
"monthly_sale_amount": "Monthly sales amount of the seller's Top-300 products, in the site's local currency.",
"monthly_sale_count": "Monthly sales count of the seller's Top-300 products."
}
}This example shows part of the response. Copied content is valid JSON.

