Skip to main content

POST /v1/douyin/search/fetch_challenge_search_v2

Fetch hashtag search V2

stable · 13 credits per success

Fetch hashtag/challenge search results from Douyin App using V2 API.;Supports searching by keyword and returns detailed challenge information, including name, cover image, view count, and participant count.;Notes;This API focuses on searching challenges (hashtags), not including videos or live streams.;Set `cursor` to 0 and `search_id` to an empty string for the first request. For pagination, use…

Sign up for 500 credits and run with your own API key. Sign up free

Request

curl
curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_challenge_search_v2' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"cursor":0,"keyword":"猫咪","backtrace":"demo","search_id":"demo","sort_type":"0","content_type":"0","publish_time":"0","filter_duration":"0"}'

Response

Sample captured 2026-09-23

data{
code:0
data{
log{ 3 items }
extra{ 6 items }
log_pb{ 2 items }
time_cost{ 1 item }
status_code:0
business_data[ 2 items ]
global_config{ 1 item }
business_config{ 14 items }
}
meta{
endpoint:"douyin.search.fetch_challenge_search_v2"
cache_hit:false
elapsed_ms:0
request_id:"req_sample"
credits_charged:0
}
message:"ok"
}

No calls yet. Get one green run first, then switch to your own data.

    Request parameters

    NameTypeInRequiredDescriptionExample
    cursorintegerbodyno偏移游标,用于翻页,从上一次请求返回的响应中获取0
    keywordstringbodyno关键词猫咪
    backtracestringbodyno翻页回溯标识,用于翻页,从上一次请求返回的响应中获取demo
    search_idstringbodyno搜索ID,用于翻页,从上一次请求返回的响应中获取demo
    sort_typestringbodyno排序方式:0=综合排序 1=最多点赞 2=最新发布0
    content_typestringbodyno内容类型:0=不限 1=视频 2=图片 3=文章0
    publish_timestringbodyno发布时间筛选:0=不限 1=最近一天 7=最近一周 180=最近半年0
    filter_durationstringbodyno视频时长过滤:0=不限 0-1=一分钟以内 1-5=一到五分钟 5-10000=五分钟以上0

    Response fields

    Field dictionary coming soon — the executable panel shows the live shape.

    Errors

    codeHTTPMeaningBilled
    40001400Invalid parametersno
    40102401Invalid or revoked API Keyno
    40201402Insufficient creditsno
    40402404Resource not foundno
    42201422Quality gate failedno
    42901429Rate limit exceededno
    50401504Upstream timeoutno
    50201502Upstream errorno

    Billing

    Success costs 13 credits. Any failure — including a 200 that fails the quality gate — costs 0.

    All Douyin endpoints →

    Search

    Search endpoints and docs