douyin/search/general-search-v2

Name: Fetch general search V2
Author: Douyin

Fetch search results from Douyin App's general search tab (not standalone video search).. This API may be less stable than V1, serving as a backup.. Supports filtering by keyword, sort type, publish time, video duration,...

Input

Backtrace(string)

Backtrace identifier (empty for first request, obtained from previous response for pagination)

Content Type(string)

Content type filter

Cursor(integer)

Pagination cursor (0 for the first page, use the last response cursor for subsequent pages)

Filter Duration(string)

Video duration filter

Keyword(string)

Search keyword, e.g., "cat"

Publish Time(string)

Publish time filter

Search Id(string)

Search ID (empty for first request, obtained from previous response for pagination)

Sort Type(string)

Sorting method

Idle

Example output — click Run to generate your own

Production endpoint

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

POSThttps://api.sandbase.ai/v1/run

Model IDdouyin/search/general-search-v2

Input Schema

8 parameters · 0 required · 8 optional

Parameter	Type	Required	Description
`cursor`	integer	Optional	Pagination cursor (0 for the first page, use the last response cursor for subsequent pages) · Default: 0
`keyword`	string	Optional	Search keyword, e.g., "cat" · Default: "猫咪"
`backtrace`	string	Optional	Backtrace identifier (empty for first request, obtained from previous response for pagination) · Default: ""
`search_id`	string	Optional	Search ID (empty for first request, obtained from previous response for pagination) · Default: ""
`sort_type`	string	Optional	Sorting method · Default: "0"
`content_type`	string	Optional	Content type filter · Default: "0"
`publish_time`	string	Optional	Publish time filter · Default: "0"
`filter_duration`	string	Optional	Video duration filter · Default: "0"

Output Schema

Field	Type	Description
`id`	string	Unique identifier for the generation task
`status`	string	Task status: pending, running, completed, failed, timeout
`model`	string	Model used for the generation
`outputs`	array	Array of output items
`outputs[].url`	string	URL of the generated artifact
`outputs[].content_type`	string	MIME type (e.g. image/png, video/mp4)
`error`	object \| null	Error details if failed, null on success
`error.type`	string	Machine-readable error type code
`error.message`	string	Human-readable error description

Code Examples

Ready-to-run snippets

curl -X POST https://api.sandbase.ai/v1/run \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "model": "douyin/search/general-search-v2",
  "cursor": 0,
  "keyword": "猫咪",
  "backtrace": "",
  "search_id": "",
  "sort_type": "0",
  "content_type": "0",
  "publish_time": "0",
  "filter_duration": "0",
  "prompt": "a beautiful sunset over mountains"
}'

← Back to Fetch general search V2

API README

Fetch general search V2

Fetch search results from Douyin App's general search tab (not standalone video search). This API may be less stable than V1, serving as a backup. Supports filtering by keyword, sort type, publish time, video duration, and content type. Supports pagination through cursor, search_id, and backtrace. It is suitable for douyin workflows.

Capability

Common use cases

Search and discover relevant records for research, monitoring, and product experiences.
Build media monitoring, content intelligence, and publishing-support workflows.
Create repeatable integrations that pass structured results to downstream business systems.