TikTok Video Tag Search
Look up TikTok video tag statistics based on videos carrying a specified tag, supporting research into trending videos, new tags, tag-related views, and promoted product counts. Provide the required tag_name, such as fashion. Optionally select site from Unknow, US, MY, PH, VN, TH, ID, GB, or JP (default: Unknow). Use page for pagination: numbering starts at 1, defaults to 1, and supports up to 20 tags per page. The provider has not specified an output schema, so exact response fields and metric availability are not guaranteed.
Pricing
| Condition | Charge |
|---|---|
| Each call | 1 credits/call |
Each call queries one page. Querying additional pages requires separate calls, each charged individually. The number of tags returned, selected site, and page number do not affect the charge per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | Pagination, up to 20 tags 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 |
tag_name | string | Yes | The tag name to query. Example: fashion. | — |
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_tag_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"site": "US",
"tag_name": "warehouse"
}
}'{
"data": [
{
"is_new_tag": false,
"max_category": {
"Name": "Work & Safety Footwear"
},
"monthly_likes": 13335,
"monthly_views": 560296,
"related_product_count": 150,
"related_video_count": 303
}
],
"doc": {
"is_new_tag": "Whether this is a new tag.",
"max_category": "Top promo category, as a JSON object.",
"max_category.Name": "Category name.",
"max_category.NodeId": "Category nodeId.",
"monthly_likes": "Monthly likes of promo videos under the tag.",
"monthly_views": "Monthly views of promo videos under the tag."
}
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows

