WellbyteWellbyte

POST /v1/douyin/search/fetch_video_search_v4

Fetch video search V4

stable · 13 credits per success

Search videos by title/keyword (V4), with cursor pagination.;The keyword matches the video title; a video ID or a video share link can also be passed;to locate one specific video.;Notes;This endpoint has no sorting, publish time, duration or content type filters —;only the keyword and pagination parameters.;Page size is fixed at 12 and cannot be changed.;Set `cursor` to 0 for the first request, t…

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

Request

curl -s -X POST 'https://api.wellbyte.net/v1/douyin/search/fetch_video_search_v4' \
  -H "Authorization: Bearer dg_live_…" \
  -H "Content-Type: application/json" \
  -d '{"cursor":null,"keyword":"咖啡"}'

Response

Sample captured 2026-08-27

data{
code:0
data{
cursor:12
hasMore:true
itemList[ 2 items ]
}
meta{
endpoint:"douyin.search.fetch_video_search_v4"
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,之后传上一页响应里的 cursordemo
    keywordstringbodyno视频标题咖啡

    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 from upstream that fails the quality gate — costs 0.

    Search

    Search endpoints and docs