WellbyteWellbyte

POST /v1/douyin/search/fetch_general_search_v3

Fetch general search V3

stable · 13 credits per success

Fetch Douyin general search results (V3), returning mixed cards: videos, users, related words, etc.；Compared with V1/V2 it has no sorting or filtering options, but pagination is simpler and the；response structure is unified (`config` + `items` + `pagination`).；Notes；For the first request set `offset` to 0, `page` to 1, and `search_id` / `backtrace` to empty strings.；For pagination, pass back `off…

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

Request

pageintegerbody

页码，取值 1~200，首次请求传 1，之后每次加 1

offsetintegerbody

翻页游标，从上一次响应的 data.pagination.offset 获取，首次请求传 0

keywordstringbody

搜索关键词

backtracestringbody

翻页回溯标识，从上一次响应的 data.pagination.backtrace 获取，首次请求传空字符串

search_idstringbody

搜索ID，从上一次响应的 data.pagination.search_id 获取，首次请求传空字符串

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

Response

Sample captured 2026-08-27

data{

code:0

data{

items[ 2 items ]

config{ 16 items }

pagination{ 6 items }

}

meta{

endpoint:"douyin.search.fetch_general_search_v3"

cache_hit:false

elapsed_ms:0

request_id:"req_sample"

credits_charged:0

}

message:"ok"

}

History

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

POST /v1/douyin/search/fetch_general_search_v3

Fetch general search V3

stable · 13 credits per success

Fetch Douyin general search results (V3), returning mixed cards: videos, users, related words, etc.；Compared with V1/V2 it has no sorting or filtering options, but pagination is simpler and the；response structure is unified (`config` + `items` + `pagination`).；Notes；For the first request set `offset` to 0, `page` to 1, and `search_id` / `backtrace` to empty strings.；For pagination, pass back `off…

Request parameters

Name	Type	In	Required	Description	Example
page	integer	body	no	页码，取值 1~200，首次请求传 1，之后每次加 1	demo
offset	integer	body	no	翻页游标，从上一次响应的 data.pagination.offset 获取，首次请求传 0	demo
keyword	string	body	no	搜索关键词	咖啡
backtrace	string	body	no	翻页回溯标识，从上一次响应的 data.pagination.backtrace 获取，首次请求传空字符串	demo
search_id	string	body	no	搜索ID，从上一次响应的 data.pagination.search_id 获取，首次请求传空字符串	demo

Response fields

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

Errors

code	HTTP	Meaning	Billed
40001	400	Invalid parameters	no
40102	401	Invalid or revoked API Key	no
40201	402	Insufficient credits	no
40402	404	Resource not found	no
42201	422	Quality gate failed	no
42901	429	Rate limit exceeded	no
50401	504	Upstream timeout	no
50201	502	Upstream error	no

Billing

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

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

Request

pageintegerbody

页码，取值 1~200，首次请求传 1，之后每次加 1

offsetintegerbody

翻页游标，从上一次响应的 data.pagination.offset 获取，首次请求传 0

keywordstringbody

搜索关键词

backtracestringbody

翻页回溯标识，从上一次响应的 data.pagination.backtrace 获取，首次请求传空字符串

search_idstringbody

搜索ID，从上一次响应的 data.pagination.search_id 获取，首次请求传空字符串

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

Response

Sample captured 2026-08-27

data{

code:0

data{

items[ 2 items ]

config{ 16 items }

pagination{ 6 items }

}

meta{

endpoint:"douyin.search.fetch_general_search_v3"

cache_hit:false

elapsed_ms:0

request_id:"req_sample"

credits_charged:0

}

message:"ok"

}

History

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