TikTok Product Search From Name
Search TikTok products by product name, title keyword, words contained in a title, seller ID, brand, or creator. Set query_type from 1 to 6 respectively and put the corresponding query in name; mode 1 is the default and uses fuzzy product-name matching. In mode 3, separate words with commas; all must appear in the title. In mode 5, provide full brand names separated by commas, up to 10 brands. Seller mode finds products on sale by that seller; creator mode finds products promoted by that creator. Select site from US, MY, PH, VN, TH, ID, GB, JP, or the default Unknow. page defaults to 1, with up to 20 products per page. The provider does not specify the result fields.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call is charged 1 AE credits.
Each request queries a single page. The same charge applies to all search modes and does not depend on the number of products returned.
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 name): product name keyword, example: power bank; QueryType=2 (by title keyword): product title keyword, example: Magnetic Power Bank; QueryType=3 (by contained words): multiple words separated by commas, returns products whose title contains all words, example: power,bank,apple; QueryType=4 (by seller): seller ID, queries products on sale by this seller, example: 7494349590325003646; QueryType=5 (by brand): full brand name, multiple brands separated by commas, up to 10 brands, example: Anker,Baseus; QueryType=6 (by creator): creator name, queries products promoted by this creator, example: xmw_us. Example: power bank. | — |
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 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 name (default), 2=by title keyword, 3=by contained words, 4=by seller, 5=by brand, 6=by creator. Example: 1. | 1 |
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_product_search_from_name' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"name": "ペット",
"query_type": 1,
"site": "JP"
}
}'"No data available."Guides using this tool
See how this tool fits into real workflows

