TikTok Product Search From Name

1 credits/call
ae_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.

Social
1 credits/call

Pricing

1 credits/call
ConditionCharge
Each call1 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.

ParameterTypeRequiredDescriptionDefault
namestringNoQuery 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.—
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
query_typeintegerNoQuery 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.

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_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"
  }
}'
Response exampleresponse.json
JSON
"No data available."

Guides using this tool

See how this tool fits into real workflows