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.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
shop_idstringYesThe Shop ID. Example: 8646932002846773930.—

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_request' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "shop_id": "7495669770456697723",
    "site": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.