WellbyteWellbyte

GET /v1/tiktok/web/fetch_general_search

Get general search list

stable · 2 credits per success

Get general search list;keyword: Search keyword;offset: Page cursor, 0 for the first request, need to provide for the second paging, generally the keyword of this value is offset or cursor.;search_id: Search id, empty for the first request, need to provide for the second paging, need to get it from the return response of the last request.;- For example: search_id = "20240828035554C02011379EBB6A00…

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

Request

curl -s 'https://api.wellbyte.net/v1/tiktok/web/fetch_general_search?cookie=demo&offset=NaN&keyword=TikTok&search_id=demo' \
  -H "Authorization: Bearer dg_live_…"

Response

Sample captured 2026-08-27

data{
code:0
data{
qc:""
data[ 2 items ]
extra{ 5 items }
cookie:"tt_chain_token=KXWr6pb8NswOOSJDYjwPtw==;"
cursor:12
log_pb{ 1 item }
ad_info{ 0 items }
has_more:1
backtrace:""
status_code:0
tt_chain_token:"KXWr6pb8NswOOSJDYjwPtw=="
global_doodle_config{ 1 item }
}
meta{
endpoint:"tiktok.web.fetch_general_search"
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
    cookiestringqueryno用户cookie(按需提供)demo
    offsetintegerqueryno翻页游标demo
    keywordstringqueryyes搜索关键词TikTok
    search_idstringqueryno搜索id,翻页时需要提供demo

    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 2 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.

    Search

    Search endpoints and docs