TikTok Brand Search From Name

1 credits/call
ae_tiktok_brand_search_from_name

Search TikTok brands by product, brand name, or shop. For product-related brands, set query_type to 1 and enter a product ID or a keyword from the product title in name; Chinese keywords are supported. For a fuzzy brand-name search, set query_type to 2 and enter the brand name. To find brands associated with products a shop has on sale, set query_type to 3 and enter the shop ID. Use site to select a supported TikTok market and page to navigate results, starting at page 1. Supported site values are Unknow, US, MY, PH, VN, TH, ID, GB, and JP; the default is Unknow. Although query_type defaults to 0 in the input schema, its documented modes are 1, 2, and 3, so choose a mode explicitly.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 credits/call

Searches by product, brand name, or shop are charged per call. Fetching another page requires another call and incurs the same per-call charge.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
namestringNoQuery keyword; the content varies by QueryType: QueryType=1 (by product): product ID or keyword contained in the product title (Chinese supported), queries brands related to the product, example: 1729532560217314285; QueryType=2 (by name): brand name, fuzzy match, example: DJI; QueryType=3 (by seller): shop ID, queries brands involved in products on sale by this seller, example: 7495830785034323995.—
pageintegerNoPagination, up to 100 brands per page. Defaults to page 1 (page index starts from 1, not 0).1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
query_typeintegerNoQuery mode: 1=by product (default), 2=by name, 3=by seller. 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_brand_search_from_name' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "name": "Yoofoss",
    "query_type": 2,
    "site": "US"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "data": [
    {
      "brand_name": "YOOFOSS",
      "max_category": {
        "MonthlySaleCount": 1009,
        "Name": "Bibs & Burp Cloths",
        "NodeId": "890760"
      },
      "monthly_sale_amount": 39617.72,
      "monthly_sale_count": 1347,
      "photo": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/e6d3ad8329644a15bfc85346712713c7~tplv-fhlh96nyum-crop-webp:600:600.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839>https://p16-oec-general-",
      "product_count": 6
    }
  ],
  "doc": {
    "brand_name": "Brand name; entries without a brand are not returned.",
    "max_category": "Top sales category, as a JSON object.",
    "max_category.MonthlySaleCount": "Monthly sales count of the brand's products in this category.",
    "max_category.Name": "Category name.",
    "max_category.NodeId": "Category nodeId.",
    "monthly_sale_amount": "Monthly sales amount of the brand's Top-300 products, in the site's local currency."
  }
}

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