douyin/
video-search

The Douyin Video Search API searches one fixed first page of public Douyin videos by text query, with normalized captions, author context, media, duration, timestamps, and visible engagement when available.

Douyin Video Search API

Text query
Fixed first page
Normalized videos
0.1 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Douyin Video Search

Douyin Video Search turns a non-empty text query into a bounded public-video dataset. Each task makes one fixed provider request for page 1 at offset 0, then stores the returned records in SocQ's reel-video shape for consistent downstream reading.

Douyin Video Search API Features

  • One-field search contractSubmit only query. The endpoint rejects undeclared inputs such as results_limit and does not require a provider token or internal identifier.
  • Bounded source requestEvery task asks the provider for page 1 at offset 0, without exposing provider pagination controls to the caller.
  • Normalized reel-video recordsRead the available text, author, media, duration, timestamps, and visible play, like, comment, and share counts that the Douyin Video Search API returns through a consistent result schema.
  • Asynchronous stored-result readsSubmit once, poll the task, and use SocQ's result cursor only when the completed task stored more records than one response page returns.

Douyin Video Search API Parameters

ParametersRequiredDescription
queryRequiredA required, non-empty text query. It is mapped to the provider's keyword field while page and offset remain fixed by the backend.

How to Use the Douyin Video Search API

Provide a non-empty query to the Douyin Video Search API, wait for the asynchronous task, and read the normalized records stored for that task.

  1. Choose a specific text query that describes the public videos you want to discover.
  2. POST query to /v1/douyin/video-search and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or reports a failure.
  4. Read data.results.items. If has_more is true, pass next_cursor to the task-result request to continue through stored SocQ records.
curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"street food"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor pages stored SocQ results only

Douyin Video Search API Use Cases

  • Topic-led video discovery: Create a bounded snapshot of public videos returned by the Douyin Video Search API for one product, theme, event, or research phrase.
  • Creator-context review: Connect returned captions and media with the available public author fields for qualitative research and dataset enrichment.
  • Format and media analysis: Review available video media, thumbnails, dimensions, and duration alongside the source record and query context.
  • Visible engagement snapshots: Compare available play, like, comment, and share counts while preserving collected_at as the observation time.

Douyin Video Search API Pro Tips

  • Require meaningful non-whitespace query text in your own interface before submitting the task.
  • Do not send results_limit, page, offset, search_id, or a provider cursor; they are not part of the public SocQ request schema.
  • Treat the returned set as one provider response, not an exhaustive search index or a caller-controlled ranking window.
  • Use GET /v1/tasks/{task_id} cursor and limit only for stored-result reads; limit defaults to 50 and accepts 1 through 500.
  • Keep collected_at and handle optional author, media, publication, duration, and individual metric fields without substituting zero for missing values.

Beyond the Douyin Video Search API, use these APIs when you need a different type of public Douyin data.

Explore other platforms

Combine Douyin data with public data from other supported social platforms.

Douyin Video Search API — FAQ

Douyin Video Search API searches the fixed first page of public Douyin videos with one text query and returns normalized reel-video records.

Only query is accepted, and it must be a non-empty string. The endpoint does not accept results_limit, page, offset, or a caller-supplied provider cursor.

No. The backend always sends page 1 and offset 0 in one provider request, and it does not expose source-pagination controls.

A next_cursor returned by GET /v1/tasks/{task_id} advances through records already stored by SocQ for the completed task. It does not fetch another Douyin source page.

Results use the reel-video schema and can include ID, URL, text, public author context, media, duration, publication and collection times, hashtags, mentions, audio, and visible play, like, comment, and share counts. Optional fields can be null or empty.

Each successful task costs a fixed 0.10 SocQ credits, independent of the number of records returned by the single provider request.