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.
2.07 credits/call
Pricing
2.07 credits/call
| Condition | Charge |
|---|---|
| Each call | 2.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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
ch_id | string | Yes | 话题id/Hashtag id | — |
count | integer | No | 数量/Number | 10 |
cursor | integer | No | 游标/Cursor | 0 |
region | string | No | 地区/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-KeyRequest 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
{
"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.

