TikTok Video Search From Name
Search TikTok shopping videos by title keyword (fuzzy match), product ID, shop ID, brand name, creator ID, or tags. Select query_type 1–6 respectively and enter the matching value in name; separate multiple tags with commas. Choose a supported site and use page to browse results (default: 1). Specify the query mode explicitly, because the schema default of 0 has no confirmed meaning. The number of results per page and individual response fields are not guaranteed by the available documentation.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1.05 credits/call |
Each call is charged 1.05 AE credits.
The same charge applies to searches by title keyword, product, shop, brand, creator, or tag. Retrieving another page requires a separate call, charged individually.
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 title): shopping video title keyword, example: zip up jacket; QueryType=2 (by product): product ID, queries shopping videos related to the product, example: 1729396594741908129; QueryType=3 (by seller): shop ID, queries shopping videos related to this seller, example: 7495830785034323995; QueryType=4 (by brand): brand name, queries shopping videos related to the brand, example: medicube; QueryType=5 (by creator): creator ID, queries shopping videos posted by this creator, example: diegolinkk; QueryType=6 (by tag): video tag name, queries shopping videos containing the tag; multiple tags supported, separated by commas, example: #SummerFashion,#tiktokshop. | — |
page | integer | No | Pagination, up to 100 items per page, default 1. Example: 1. | 1 |
site | enum (Unknow | US | MY | PH | VN | TH | ID | GB | JP) | No | TikTok site. | Unknow |
query_type | integer | No | Query mode: 1=by title (default, fuzzy match), 2=by product, 3=by seller, 4=by brand, 5=by creator, 6=by tag. 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_video_search_from_name' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"name": "ฝาครอบกุญแจ PCX",
"page": 1,
"query_type": 1,
"site": "TH"
}
}'"TikTok platform author are only supported on the US sites."Guides using this tool
See how this tool fits into real workflows

