douyin/
video-detail

The Douyin Video Detail API turns one known Douyin video URL into a normalized record with video identity, caption, creator context, media, duration, timestamps, and visible engagement fields when available.

Douyin Video Detail API

Supported Douyin URL
One normalized video
0.10 credits per task
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 Detail

A Douyin video detail record connects a known public video URL with normalized content, creator, media, timing, and visible engagement fields. It is useful when a workflow already has an exact video link and needs one consistent record for enrichment, review, or later comparison.

Douyin Video Detail API Features

  • Supported Douyin URLAccept one URL on douyin.com, iesdouyin.com, or a supported subdomain. When /video/ appears, it must be followed by a numeric ID.
  • Bounded single-video resultRun one provider detail request and store at most one normalized video record without source pagination or results_limit.
  • Caption and creator contextThe Douyin Video Detail API returns available video text alongside normalized creator ID, username, display name, profile URL, avatar, and account flags.
  • Media and duration fieldsKeep available video or image references, previews, dimensions, media duration, and the normalized duration_seconds field.
  • Time-stamped engagement snapshotPair available like, comment, share, play, and view counts with published_at and collected_at instead of presenting them as live counters.

Douyin Video Detail API Parameters

ParametersRequiredDescription
urlRequiredRequired non-empty URL on douyin.com, iesdouyin.com, or a supported subdomain. If /video/ is present, it must be followed by a numeric ID; only one URL is accepted per task.

How to Use the Douyin Video Detail API

Submit one supported video URL to the Douyin Video Detail API, track the asynchronous task, and read its stored normalized result after success.

  1. Set DOUYIN_VIDEO_URL to a public URL whose host is douyin.com, iesdouyin.com, or a subdomain. A /video/ segment, when present, must be followed by a numeric ID.
  2. POST the url string to /v1/douyin/video-detail and save the returned task_id.
  3. Poll /v1/tasks/{task_id} until the task succeeds or fails; result fields are not available while it is incomplete.
  4. After success, read data.results.items. The provider produces at most one item, while limit and next_cursor belong to SocQ's stored-results reader.
curl -X POST "https://api.socq.ai/v1/douyin/video-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$DOUYIN_VIDEO_URL\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized video from data.results.items

Douyin Video Detail API Use Cases

  • Enrich known-video catalogs: Add normalized identity, caption, creator, publication time, duration, media, and source fields to approved Douyin video links.
  • Connect discovery to detail: Use a supported video URL retained from a Douyin user-video or video-search record as the exact input for a focused Douyin Video Detail API lookup.
  • Prepare point-in-time comparisons: Store repeated successful results with collected_at to compare available public engagement snapshots on a defined schedule.

Douyin Video Detail API Pro Tips

  • Use a direct public video reference on a supported hostname for meaningful provider resolution; if it contains /video/, keep the numeric video ID intact.
  • Leave the Playground field empty until you have a real public video URL; this endpoint has no reliable universal default.
  • Submit one URL per Douyin Video Detail API task and omit results_limit, cursor, and unrelated IDs because the public request accepts only url.
  • Treat missing creator, media, audio, hashtag, mention, or engagement fields as unavailable rather than as empty strings or zero.
  • Use collected_at for metric comparisons and published_at for content chronology; they describe different moments.
  • If you continue to video comments, pass an available supported video URL to that separate endpoint instead of assuming the detail task expands into comments.

Beyond the Douyin Video Detail 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 Detail API — FAQ

Douyin Video Detail API retrieves one public Douyin video from a supported URL, returning a normalized reel-video record with available identity, caption, creator, media, duration, timestamps, and visible engagement fields.

Use a URL whose hostname is douyin.com, iesdouyin.com, or a subdomain. If the URL contains /video/, the following identifier must be numeric.

Use a direct public video reference when possible. The input validator accepts supported Douyin hosts and checks a numeric ID whenever /video/ appears, while the provider still needs a resolvable video reference to return data.

The reel-video schema can contain base identity and timing fields, caption text, creator context, media, hashtags, mentions, shortcode, duration, audio, and available like, comment, share, play, and view counts. Optional fields may be null.

No. The provider performs one detail request and can store at most one item. limit, has_more, and next_cursor are part of the shared SocQ task-results reader, not provider pagination.

The POST returns a task_id. Poll /v1/tasks/{task_id}; data.results appears after the task succeeds, and a cursor is rejected while the task is incomplete.

Each successful task has a fixed charge of 0.10 SocQ credits. The charge does not scale with result count because this is a fixed, single-detail task.