概要
既知のDouyin動画について、公開コンテンツ、クリエイター情報、エンゲージメントのスナップショット、メディア参照をまとめて取得できます。このData Appは、複数の動画IDを比較、補完、保存しやすい一貫したレコードに変換します。
動画を1件ずつ開いて内容を書き写す必要がなくなり、あらかじめ選定した動画のクリエイティブ、投稿者、公開時期、公開反応を調査するための基礎データとして利用できます。
データについて
指定したIDに対応する、公開されているDouyin動画の詳細が対象です。有効で重複しない動画IDごとに最大1件を返し、「コンテンツID」で識別します。無効、重複、削除済み、非公開、制限付き、ログイン必須の動画は結果がない場合があります。
「いいね数」「コメント数」「お気に入り数」「シェア数」「再生数」「フォロワー数」「認証状態」「コンテンツ状態」は収集時点のスナップショットで、後から変化する可能性があります。件数、「注目状態」「動画の長さ」「音楽情報」「コンテンツタグ」「画像URL一覧」などはソースのテキスト形式を保持します。「公開日時」と「収集日時」はタイムゾーンを推定せず、元の時刻表現を保持します。
結果の例
各レコードは1件のDouyin動画の公開詳細を表します。
| コンテンツID | コンテンツタイトル | アカウント名 | 公開日時 | いいね数 | コメント数 |
|---|---|---|---|---|---|
| 7675002361652376997 | #2027款新福特探险者#大型长途穿越旗舰SUV#智能座舱 | 颜西枣A | 2026-08-17T22:09:00 | 43.0 | 26.0 |
| 7675769027507108197 | 暑假没报辅导班居然效果还更好 | 🌈木有糖 | 2026-08-19T23:44:03 | 0.0 | 0.0 |
このほか、クリエイター識別子、プロフィールリンク、カバー画像、再生URL、音声文字起こし、画面認識テキスト、場所、認証、メディア情報、収集日時が含まれます。
利用例
- 「いいね数」「コメント数」「お気に入り数」「シェア数」「再生数」を比較し、公開反応の強い動画を見つけます。
- 「コンテンツタイトル」「コンテンツ本文」「コンテンツタグ」「音声文字起こし」「画面認識テキスト」からテーマや訴求を分類します。
- 「アカウントID」「アカウント名」「認証状態」「フォロワー数」で選定動画にクリエイター情報を加えます。
- 「公開日時」「収集日時」「コンテンツ状態」「コンテンツURL」を繰り返し比較し、公開状況と指標の変化を追跡します。
適用範囲と境界
1回の実行で1～200件のDouyin動画IDを受け付け、有効かつ重複しないIDごとに公開詳細レコードを最大1件返します。
- 適している用途
- 既知のDouyin動画IDについて、公開メタデータとエンゲージメントのスナップショットが必要な場合
- 1つのバックグラウンドタスクで最大200件の動画詳細が必要な場合
- 適さない用途
- キーワードやアカウントから動画を探す用途には使わず、既知のDouyin動画IDを指定してください
- 非公開、削除済み、制限付き、ログイン必須の動画には使用しないでください
失敗時の処理
開発者が宣言した失敗時と再試行の動作です。連携時にはシステムプロンプトに含めることをおすすめします。
- 1一時的なタスクまたはサービス障害は同じ動画IDで再試行してください
- 2一部のみ成功した場合は返されたレコードを使用し、不足した動画IDを再試行してください
- 3空の結果はIDが無効、重複、利用不能、または非公開になったことを示す場合があります
入力
この App の呼び出しに必要なパラメータで、manifest.json の input.schema から生成されています。
- Douyin動画ID
video_items必須array<object>1～200件を追加します。各項目の「動画ID」に数字のDouyin動画IDを入力してください。無効、重複、アクセス不能なIDは結果を返さない場合があります。件数最大 200 件例[{"kw":"7675002361652376997"}]
出力
1 件のレコードのフィールド構造で、manifest.json の output.schema から生成されています。
- アカウントID
account_idstringアカウントIDとして返されるソース値です。例3751974819070941 - アカウント名
account_namestringアカウント名として返されるソース値です。例颜西枣A - アカウントsecId
account_sec_idstringアカウントsecIdとして返されるソース値です。例MS4wLjABAAAAbnnzFkIU-IDPDNKbU3MYQMMDIlfyPjZofUNSFnnpIpczzacMXip5FXmnyMhIjZW7 - アカウント短縮ID
account_short_idstringアカウント短縮IDとして返されるソース値です。
サンプルデータ
output.schema から生成したサンプルです。サンプル値のないフィールドには構造上のプレースホルダーを使用しています。
{
"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"
}連携方法
この App は MCP、API、SDK、ファイルエクスポートのいずれでも連携でき、どのチャネルも同じ能力と料金を共有します。すべてのリクエストは Authorization: Bearer ヘッダーで認証し、認証情報には API Key（長期有効。Data Hub コンソールで作成）を使用します。MCP クライアントは OAuth によるキー不要のログインにも対応しています。CLI や Skill など、さらに多くの連携方法も準備中です。 この App は非同期で実行され、途中でキャンセルできます：キャンセル後、実行は停止します。納品済みのレコードは保持され、課金対象になります。
MCP（Model Context Protocol）を使うと、Claude や Cursor などの AI クライアントからこの App を直接呼び出せます。クライアントと認証方式を選び、下の設定をコピーしてください。
クライアント設定
Bearer の後の値を長期有効な API Key に置き換えてください。あらゆるクライアント、CI、ヘッドレス環境で利用できます。
{
"mcpServers": {
"octoparse_datahub": {
"type": "http",
"url": "https://mcp-v2.octoparse.com?pin=meme_today/douyin-video-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}AI に設定を任せる
設定を手作業で編集したくない場合は、インストールプロンプトをコピーして任意の AI クライアントに貼り付けてください。AI が自分のやり方でセットアップを完了します（プロンプトは AI があなたに API Key を尋ねる形になっているため、認証情報がチャット履歴や共有設定に残りません）。
detail.access.mcp.composeHint
料金
返される件数にかかわらず、実行の送信 1 回ごとに課金されます。
正常に返されたレコードの件数に応じて課金されます。失敗した実行には課金されません。
複数の課金イベントはそれぞれ独立して累計されます。詳細は各項目をご覧ください。失敗した実行には課金されません。
Credits を確認今すぐ試す
パラメータを入力して実行してください。結果は実際の呼び出しによるものです。