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.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
name | string | No | Query 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. | — |
page | integer | No | Pagination, up to 100 brands per page. Defaults to page 1 (page index starts from 1, not 0). | 1 |
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
query_type | integer | No | Query mode: 1=by product (default), 2=by name, 3=by seller. Example: 1. | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --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"
}
}'{
"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.

