Douyin Fetch Hashtag Video List

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

VideoSocial
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
ch_idstringYes话题id/Hashtag id—
countintegerNo数量/Number10
cursorintegerNo游标/Cursor0
sort_typeintegerNo排序类型/Sort type0

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_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
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "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.