Douyin Fetch Hashtag Video List
Retrieve videos for a specified Douyin hashtag, with pagination and a choice of sorting order. Inputs: - ch_id (required string): The hashtag ID, not its name or text. - cursor (optional integer, default 0): Use 0 for the first page. For the next page, use the cursor returned by the previous response. - sort_type (optional integer, default 0): 0 = comprehensive ranking, 1 = most likes, 2 = latest published. - count (optional integer, default 10): Keep the default value of 10; changing it is documented to cause errors. Returns: Video-list data for the specified hashtag in the response data payload. The documented response schema does not specify individual video fields. Example: ch_id = "1575791821492238", cursor = 0, sort_type = 0, count = 10.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
The fixed fee is 2.07 credits per call. Charges are per query. A successful query is billed even if it returns no results.
Fetching the next page requires another call, charged separately at the per-call rate.
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 |
sort_type | integer | No | 排序类型/Sort type | 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_douyin_fetch_hashtag_video_list' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"ch_id": "7690834868800620595",
"count": 10,
"cursor": 20,
"sort_type": 1
}
}'{
"code": 200,
"data": {
"aweme_list": [],
"cursor": 30,
"extra": {
"fatal_item_ids": [],
"logid": "202611101941109767CF1DAA7057B21125",
"now": 1794310872000
},
"has_more": 1,
"log_pb": {
"impr_id": "202611101941109767CF1DAA7057B21125"
},
"mix_list": [
{
"aweme_info": {
"activity_video_type": -1,
"ai_follow_images": null,
"anchors": null,
"authentication_token": "MS4wLjAAAAAABfqL0nzL5o5OPwzCWGmFQp-382IQgDDZJ7NrW4tKUfT6-YbZKnSQU0ypC0YZgwuDe_eI_Bncudo-dmrnUrLRBcXG2S8gwXDNAJ0oH9XPutxuwL4COmdNBaE1Ob5FEA5pCNpVx-RicZhoPfiobNxvSPg0-D2fy7Zg9fkUUoGkdWtEyri7LTEgP-55BesfNoSJkVyaFAPPvOtvQFLE5aUPfEfhGIyzP31e_XMB6YwZZ7JAyB4TAwHK",
"author": {
"accept_private_policy": false,
"account_region": "",
"ad_cover_url": null,
"allow_story_normal_like": false,
"apple_account": 0,
"authority_status": 0
},
"author_mask_tag": 0
}
}
]
},
"docs": "https://api.tikhub.io/#/Douyin-App-V3-API/fetch_hashtag_video_list_api_v1_douyin_app_v3_fetch_hashtag_video_list_get",
"message": "Request successful. This request will incur a charge.",
"message_zh": "请求成功,本次请求将被计费。",
"request_id": "f3b3d977-6f67-40c7-80e0-170e3ecc4653"
}This example shows part of the response. Copied content is valid JSON.

