Douyin Search Fetch Challenge Search V1

20.65 credits/call
ae_douyin_search_fetch_challenge_search_v1

## Purpose Search Douyin for hashtag/challenge topics related to a keyword. Results are topic entries, not a list of individual videos or posts. ## Inputs Provide a required `request_body` object. All fields inside it are optional: - `keyword` (string): search term, for example `food`; default: `猫咪` (cats). - `cursor` (integer): pagination cursor; default `0` for the first request. - `search_id` and `backtrace` (strings): pagination identifiers; both default to an empty string. For later pages, reuse the values returned by the previous response when available, together with its cursor. - `sort_type` (string): `"0"` comprehensive, `"1"` most likes, `"2"` latest. - `publish_time` (string): `"0"` unrestricted, `"1"` last day, `"7"` last week, `"180"` last half year. - `filter_duration` (string): `"0"` unrestricted, `"0-1"` within one minute, `"1-5"` one to five minutes, `"5-10000"` over five minutes. - `content_type` (string): `"0"` all, `"1"` video, `"2"` image, `"3"` article. All sorting and filter fields default to `"0"`. Despite the available content filters, the documented output remains topic-only. ## Results Returns a response envelope with a status `code` and a `data` payload, which may be null. Documented search data can include: - `challenge_list`: topic entries. Each entry may contain `challenge_info` with `cid` (topic ID), `cha_name` (name), description, `view_count` (total views), `user_count` (participants), `hashtag_profile` (cover URL), and sharing/deep links. - `author`: creator information within a topic entry, such as user ID, nickname, follower count, verification status, region, and avatar URLs. - `cursor`: cursor for the next request; `has_more`: `1` if more results are available, `0` otherwise. The payload has no fixed detailed schema; listed fields describe common documented results and may not all be present. Use the actual response for pagination and available topic details.

Social
20.65 credits/call

Pricing

20.65 credits/call
ConditionCharge
Each call20.65 credits/call

20.65 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
request_bodyobjectYes抖音话题(挑战/标签)搜索的请求体对象,包含搜索关键词 keyword、翻页参数 cursor、search_id 和 backtrace,以及排序方式 sort_type、发布时间筛选 publish_time、视频时长筛选 filter_duration 和内容类型筛选 content_type。 / Request body object for Douyin hashtag/challenge search, containing the search keyword (keyword), pagination parameters (cursor, search_id, backtrace), sorting method (sort_type), publish time filter (publish_time), video duration filter (filter_duration), and content type filter (content_type).—
request_body.cursorintegerNo偏移游标,用于翻页,从上一次请求返回的响应中获取 / Offset cursor for pagination, obtained from the last response0
request_body.keywordstringNo关键词 / Keyword猫咪
request_body.backtracestringNo翻页回溯标识,用于翻页,从上一次请求返回的响应中获取 / Backtrace for pagination, obtained from the last response""
request_body.search_idstringNo搜索ID,用于翻页,从上一次请求返回的响应中获取 / Search ID for pagination, obtained from the last response""
request_body.sort_typestringNo排序方式:0=综合排序 1=最多点赞 2=最新发布 / Sort type: 0=Comprehensive, 1=Most Likes, 2=Latest0
request_body.content_typestringNo内容类型:0=不限 1=视频 2=图片 3=文章 / Content type: 0=All, 1=Video, 2=Picture, 3=Article0
request_body.publish_timestringNo发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年 / Publish time filter: 0=Unlimited, 1=Last day, 7=Last week, 180=Last half year0
request_body.filter_durationstringNo视频时长过滤:0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上 / Video duration filter: 0=Unlimited, 0-1=Within 1 minute, 1-5=1 to 5 minutes, 5-10000=More than 5 minutes0

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_search_fetch_challenge_search_v1' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "backtrace": "",
      "content_type": "0",
      "cursor": 0,
      "filter_duration": "0",
      "keyword": "泰式广告",
      "publish_time": "180",
      "search_id": "",
      "sort_type": "1"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "challenge_list": [
      {
        "challenge_info": {
          "author": {
            "avatar_larger": {},
            "avatar_medium": {},
            "avatar_thumb": {},
            "aweme_count": 0,
            "follow_status": 0,
            "follower_count": 18
          },
          "cha_name": "泰式广告",
          "cid": "1628696441304072",
          "collect_stat": 0,
          "is_challenge": 0,
          "type": 1
        }
      }
    ]
  },
  "docs": "https://api.tikhub.io/#/Douyin-Search-API/fetch_challenge_search_v1_api_v1_douyin_search_fetch_challenge_search_v1_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "3aee4a19-8e29-4e57-b2f2-bff522d04afc"
}

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