logo
EN

Douyin Video Details

Submit up to 200 Douyin video IDs and retrieve public video, creator, engagement, and media details

Data collection
Developer
meme_today
Pricing
From $0.0015 / record
Last updated
2026-09-16

Overview

Public Douyin video details bring together the visible content, creator identity, engagement snapshot, and media references for videos you already know. This Data App turns a batch of video IDs into consistent records that are ready for review, comparison, enrichment, or storage.

Instead of opening videos one by one and transcribing what is visible, teams can use the result as a structured research dataset. It is especially useful when a shortlist of videos has already been identified and the next step is to compare creative themes, creator context, publishing patterns, or public engagement.

Data notes

The data covers publicly available Douyin video details for the supplied IDs. Each valid, deduplicated video ID returns at most one record, identified by Content ID. Invalid, duplicate, deleted, private, restricted, or login-only videos may return no record.

Like count, Comment count, Favorite count, Share count, View count, Follower count, verification details, and Content status are snapshots observed at collection time and may change later. Count values, Hot status, Video duration, and several rich values such as Music information, Content tags, Image URL list, Cooperation information, and Place information are retained in the source text form. Published at and Collected at preserve source timestamps without inferring a timezone.

What the results look like

Each record represents the public details captured for one Douyin video.

Content IDContent titleAccount namePublished atLike countComment count
7675002361652376997#2027款新福特探险者#大型长途穿越旗舰SUV#智能座舱颜西枣A2026-08-17T22:09:0043.026.0
7675769027507108197暑假没报辅导班居然效果还更好🌈木有糖2026-08-19T23:44:030.00.0

Additional values include creator identifiers and profile links, cover and playback URLs, speech and on-screen text, location details, verification information, media metadata, and the collection timestamp.

Use cases

  • Compare Like count, Comment count, Favorite count, Share count, and View count to identify videos with stronger visible engagement.
  • Review Content title, Content text, Content tags, Speech transcript, and Recognized on-screen text to classify creative themes and messaging.
  • Use Account ID, Account name, Verification status, and Follower count to add creator context to a selected video set.
  • Compare Published at, Collected at, Content status, and Content URL across repeated collections to monitor availability and metric changes.

Scope and boundaries

Each run accepts 1-200 Douyin video IDs; every valid deduplicated ID returns at most one publicly available detail record.

  • Good for
  • Use when you need detailed public metadata and engagement snapshots for a known set of Douyin video IDs
  • Use when you need up to 200 video detail records in one background task
  • Do not use for
  • Do not use to discover videos by keyword or account; supply known Douyin video IDs
  • Do not use for private, deleted, restricted, or login-only videos

Failure handling

Failure and retry behavior declared by the developer. We recommend including it in your system prompt when integrating.

  1. 1Retry temporary task or service failures with the same video IDs
  2. 2If only part of the task succeeds, use the returned records and retry the missing video IDs
  3. 3An empty result can mean that an ID is invalid, duplicated, unavailable, or no longer public

Input

Parameters required to call this App, generated from the input.schema in manifest.json.

  • Douyin video IDsvideo_itemsRequiredarray<object>
    Add 1-200 entries. In each entry, put the numeric Douyin video ID in the Video ID field; invalid, duplicate, or inaccessible IDs may return no record.
    Itemsup to 200 itemsExample[{"kw":"7675002361652376997"}]

Output

Field structure of a single record, generated from the output.schema in manifest.json.

  • Account IDaccount_idstring
    The Douyin account ID associated with the public content
    Example3751974819070941
  • Account nameaccount_namestring
    The public display name of the Douyin account
    Example颜西枣A
  • Account secIdaccount_sec_idstring
    The secId identifier of the Douyin account
    ExampleMS4wLjABAAAAbnnzFkIU-IDPDNKbU3MYQMMDIlfyPjZofUNSFnnpIpczzacMXip5FXmnyMhIjZW7
  • Account short IDaccount_short_idstring
    The account's short identifier as supplied by the source

Sample data

Generated from output.schema. Fields without a sample value use structural placeholders.

output.example
{
  "account_id": "3751974819070941",
  "account_name": "颜西枣A",
  "account_sec_id": "MS4wLjABAAAAbnnzFkIU-IDPDNKbU3MYQMMDIlfyPjZofUNSFnnpIpczzacMXip5FXmnyMhIjZW7",
  "account_short_id": "<account_short_id>",
  "account_unique_id": "<account_unique_id>",
  "account_url": "https://www.douyin.com/user/MS4wLjABAAAAbnnzFkIU-IDPDNKbU3MYQMMDIlfyPjZofUNSFnnpIpczzacMXip5FXmnyMhIjZW7",
  "accurate_location_cities": "<accurate_location_cities>",
  "accurate_location_provinces": "<accurate_location_provinces>",
  "anchor_info": "<anchor_info>",
  "asr_text": "<asr_text>",
  "avatar_url": "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/sample.jpeg",
  "biz_id": "7675002361652376997",
  "collection_count": "0.0",
  "comment_count": "26.0",
  "content_id": "7675002361652376997",
  "content_text": "<content_text>",
  "content_title": "#2027款新福特探险者#大型长途穿越旗舰SUV#智能座舱",
  "content_url": "https://www.douyin.com/video/7675002361652376997",
  "cooperation_infos": "[]",
  "cover_url": "https://p3-pc-sign.douyinpic.com/sample-cover.jpeg",
  "crawl_time": "2026-08-18T19:33:51",
  "digg_count": "43.0",
  "download_count": "0.0",
  "fans": "211",
  "forward_count": "0.0",
  "image_url_list": "[]",
  "is_hot": "false",
  "keyword": "7675002361652376997",
  "music": "{\"audition_duration\":\"21\",\"author\":\"颜西枣A\",\"id\":\"7675002312150060000\",\"title\":\"@颜西枣A创作的原声\"}",
  "ocr_text": "<ocr_text>",
  "poi_info": "<poi_info>",
  "publish_location": "{}",
  "publish_time": "2026-08-17T22:09:00",
  "share_count": "0.0",
  "status": "有效",
  "tags": "[\"2027款新福特探险者\",\"大型长途穿越旗舰suv\",\"智能座舱\"]",
  "verified": "<verified>",
  "verify_type": "<verify_type>",
  "video_duration": "21456.0",
  "video_url": "https://v26-web.douyinvod.com/example/video.mp4",
  "view_count": "0.0"
}

Integration

This App can be integrated via MCP, API, SDK, or file export. All channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API key (long-lived, created in the Data Hub Console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way. This App runs asynchronously and can be canceled midway: After you cancel, the run stops. Records already delivered are kept and billed.

With the MCP (Model Context Protocol), you can call this App directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "octoparse_datahub": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=meme_today/douyin-video-detail",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}
View my API Keys →

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client. It will complete the setup its own way. (The prompt asks the AI to request your API key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

Task start

Charged once per submitted run, regardless of how many records are returned.

$0.0001/ run
Returned detail record

Charged by the number of records successfully returned. Failed runs are not charged.

$0.0015/ record

Multiple billing events accumulate independently. See each item for details. Failed runs are not charged.

View credits

Try it now

Fill in the parameters and run. Results come from a real call.

Example
Parameters are validated against input.schema before submission
From $0.0015 / record