TikTok Shop Search From Name

1.05 credits/call
ae_tiktok_shop_search_from_name

Find TikTok Shop sellers by shop name, product keyword, or brand. Supply the search text in name and set query_type to 1 (shop name), 2 (product keyword, with fuzzy matching), or 3 (brand). Product and brand searches find sellers dealing in those products or brands, rather than returning product listings. Supported site values are Unknow, US, MY, PH, VN, TH, ID, GB, and JP; the default is Unknow. Use page for pagination (default 1). Select a query_type explicitly: the schema defaults to 0, but its behavior is undocumented. The number of sellers per page is not confirmed because the source descriptions disagree. Response fields are not documented.

Social
1.05 credits/call

Pricing

1.05 credits/call
ConditionCharge
Each call1.05 credits/call

Each call is charged 1.05 AE credits.

The same fixed charge applies to seller searches by shop name, product keyword, or brand. Fetching another page requires a separate call, charged individually.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
namestringNoQuery keyword; the content varies by QueryType: QueryType=1 (by seller name): seller (shop) name, example: FashionStore; QueryType=2 (by product name): product name keyword, fuzzy match, queries sellers dealing in such products, example: summer dress; QueryType=3 (by brand): brand name, queries sellers dealing in the brand, example: Anker.—
pageintegerNoPagination, up to 100 sellers per page, default 1. Example: 1.1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
query_typeintegerNoQuery mode: 1=by seller name (default), 2=by product name, 3=by brand. Example: 1.0

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_search_from_name' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "name": "VILILY",
    "page": 1,
    "query_type": 1,
    "site": "PH"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "fans_count": 10475,
      "max_category": {
        "Name": "Women's Fragrance",
        "NodeId": "855952"
      },
      "monthly_sale_amount": 0.00,
      "monthly_sale_count": 0,
      "new_product_count": 0,
      "photo": "https://p16-oec-sg.ibyteimg.com/tos-alisg-i-aphluv4xwc-sg/ad03bd8b53784c96a2c84f6c82ad1c9c~tplv-aphluv4xwc-resize-webp:300:300.webp?dr=15582&t=555f072d&ps=933b5bde&shp=905da467&shcp=607f11de&idc=my2&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.