TikTok Get Hashtag Videos

2.07 credits/call
ae_tiktok_get_hashtag_videos

Retrieve videos associated with a hashtag. The required ch_id is the hashtag ID. Optional parameters are cursor (page cursor; defaults to 0), count (number of results; defaults to 10), and region (defaults to US; supported values: US, GB, FR, JP, VN, SG). Use the cursor returned in a previous response to request the next page when available. The response contains video result data and response metadata.

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
ch_idstringYes话题id/Hashtag id—
countintegerNo数量/Number10
cursorintegerNo游标/Cursor0
regionstringNo地区/Region (US, GB, FR, JP, VN, SG)US

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_get_hashtag_videos' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "ch_id": "1674069207729153",
    "count": 20,
    "region": "JP"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "detail": {
    "code": 400,
    "docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_hashtag_video_list_api_v1_tiktok_app_v3_fetch_hashtag_video_list_get",
    "headers": {},
    "message": "Request failed. Please retry. Check the docs below to verify your parameters, test with the default demo parameters, and send the response JSON to support. You won't be charged for this request.",
    "message_zh": "请求失败,请重试。请查看下方文档核对参数,使用默认演示参数测试,并将响应 JSON 提交给支持团队。本次请求不会被扣费。",
    "params": {
      "ch_id": "1674069207729153",
      "count": "20",
      "cursor": "0",
      "region": "JP"
    }
  }
}

This example shows part of the response. Copied content is valid JSON.