TikTok Video Tag Search

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

SocialVideo
1 credits/call

Pricing

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

ParameterTypeRequiredDescriptionDefault
pageintegerNoPagination, up to 20 tags per page. Defaults to page 1 (page index starts from 1, not 0).1
siteenum (Unknow | US | MY | PH | VN | TH | ID | GB | JP)NoTikTok site.Unknow
tag_namestringYesThe tag name to query. Example: fashion.—

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_video_tag_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "site": "US",
    "tag_name": "warehouse"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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