抖音（Douyin）API：動画検索、コメント、動画 URL の解決

2026-10-25 時点の仕様スナップショットに基づく

要点

抖音（Douyin）API には 3 種類の非同期タスク（動画のキーワード検索、1 本の動画のコメント、公開アカウントの投稿タイムライン）と、収集済みの抖音投稿をダウンロード URL に解決する同期型の POST /douyin/videos があります。ダウンロード URL は抖音の現在の公開再生 URL へリダイレクトするだけで、当社は動画をホスティングも保存もしません。コメントは既定で動画あたり 50 件を収集し、max_items または get_all で調整できます。データは抖音で公開されているコンテンツをウェブクローラーで収集したものです。

取得できるデータ

フィールドは 2026-10-25 時点の仕様スナップショットに基づきます。検索結果の投稿フィールドはスナップショットに列挙されていないため、「サンプル」と記した行は下のサンプルデータから取っています。正式なフィールドはトライアルデータでご確認ください。また、post_id や parent_id などの関連フィールドはスナップショットで必須とされていないため、実際の有無もトライアルデータでご確認ください。

エンドポイント一覧

Base URL は https://api.infominer.io/api/v2 です。API キーは auth-header リクエストヘッダーで送信します。* の付いたパラメーターは必須です。

データ取得の流れ

1. POST /douyin/search/task に keyword と任意の start_date、end_date、max_pages を指定し、タスク id を受け取ります。
2. GET /douyin/search/task/{task_id} をポーリングします。INIT または RUNNING の間は待ち、DONE になると同じレスポンスに動画投稿と total_count が含まれ（pageSize は最大 100）、FAILED なら停止して失敗に対処します。
3. 動画 URL で POST /douyin/pushs/task を呼び、コメントタスクを作成します。指定がなければ最大 50 件を収集し、max_items で上限を設定でき（0 または負の値は上限なし）、get_all を true にすると既定の 50 件制限がなくなります。
4. GET /douyin/pushs/task/{task_id} でコメントを取得します。タスク完了後（成功レコードがある部分完了・タイムアウトのタスクを含む）は、その動画の保存済みコメント（以前の収集分を含む場合があります）を page と pageSize（最大 1000）でページ単位に返し、order_type=hot または time で読み出し順を指定できます。
5. 動画ファイルが必要な場合は、完全な douyin.com の /video/{id} または /note/{id} URL で POST /douyin/videos を呼び、post_id と download_url を受け取ります。MP4 はリダイレクトをたどった後に取得されます。

curl の例

キーワード検索タスクを作成

curl -X POST https://api.infominer.io/api/v2/douyin/search/task \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "亲子露营", "start_date": "2026-06-01", "end_date": "2026-06-30", "max_pages": 3}'

タスク ID でポーリング

curl "https://api.infominer.io/api/v2/douyin/search/task/$TASK_ID?page=1&pageSize=100" \
  -H "auth-header: YOUR_API_KEY"

収集済み動画をダウンロード URL に解決

curl -X POST https://api.infominer.io/api/v2/douyin/videos \
  -H "auth-header: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"post_url": "https://www.douyin.com/video/0000000000000001"}'

サンプル JSON

以下は手作業で作成したサンプルデータ（架空）です。アカウントは sample_user_n、ID は明らかな仮の値で、実在の投稿ではありません。

タスク作成時のレスポンス：サンプルデータ（架空）

{
  "id": "00000000-0000-4000-8000-000000000001",
  "keyword": "亲子露营",
  "status": "INIT"
}

タスク完了後のポーリングレスポンス：サンプルデータ（架空）

{
  "keyword": "亲子露营",
  "status": "DONE",
  "total_count": 2,
  "task": {
    "id": "00000000-0000-4000-8000-000000000001",
    "status": "DONE"
  },
  "data": [
    {
      "source": "douyin.search",
      "platform": "douyin",
      "url": "https://www.douyin.com/video/0000000000000001",
      "post_id": "0000000000000001",
      "content": "第一次带孩子露营，帐篷搭建与行李清单整理给大家 #亲子露营",
      "author": "sample_user_1",
      "tm": 1781056800,
      "date": "2026-06-10",
      "metadata_tags": [
        "亲子露营",
        "露营新手"
      ],
      "like_count": 230,
      "comment_count": 18,
      "share_count": 9,
      "video_length": 95
    },
    {
      "source": "douyin.search",
      "platform": "douyin",
      "url": "https://www.douyin.com/video/0000000000000002",
      "post_id": "0000000000000002",
      "content": "露营区的早餐怎么准备比较轻松，三个小技巧",
      "author": "sample_user_2",
      "tm": 1781060400,
      "date": "2026-06-10",
      "metadata_tags": [
        "露营",
        "早餐"
      ],
      "like_count": 77,
      "comment_count": 6,
      "share_count": 3,
      "video_length": 48
    }
  ]
}

投稿とコメントの関連付け

コメントタスクは動画 URL（post_url）から作成し、コメントレコードは post_id フィールドで所属する動画を指します。order_type=hot は保存済みコメントをいいね数の多い順、同数なら公開日時の新しい順に並べます。これは読み出し時の並び順であり、収集したコメントがプラットフォーム全体で最もいいねの多いものであることは保証しません。total_count には以前の収集分が含まれる場合があります。第 2 階層の返信は現在提供しておらず、crawl_second_layer は false のみ対応です。

取得期間と制限

• コメントは既定で動画あたり 50 件です。max_items を明示した場合はそれが優先され、get_all を true にすると件数上限はなくなりますが、ページの安全上限と取得元の状況による制限は残ります。完全に収集できなかった場合は partial=true が付きます。
• 公開アカウントの投稿タイムライン：max_items は既定 50、上限 1000 です。0 は件数上限なしで、クロールのページ上限のみが適用されます。補助的なタイムラインのバックエンドに一時的に接続できない場合も、タスクは完了として error_message 付きで返されます。
• 動画 URL の解決は完全な douyin.com の /video/{id} と /note/{id} URL のみ受け付け、v.douyin.com の短縮 URL には対応していません。収集済みの投稿にのみ使え、呼び出してもクロールタスクの作成や収集は行われず、返すのは MP4 ファイルではなくダウンロード URL です。
• ダウンロード URL は抖音の現在の公開 HTTPS 再生 URL への 302 リダイレクトを返すため、クライアントはリダイレクトをたどる必要があります。当社はリダイレクトするだけで、動画をホスティング・プロキシ・保存せず、リダイレクト先はクライアントから見えます。可用性はベストエフォートで、動画の削除、地域や IP の制限、抖音の再生側の変更により取得できなくなる場合があります。
• キーワード検索で遡れる期間と更新頻度はプロジェクトの範囲に応じて確認します。

納品形式

検索・コメント・タイムラインは JSON を返し、DONE になったタスクのポーリングレスポンスにデータが含まれます。補助的なタイムラインのバックエンドに一時的に接続できない場合、タイムラインのレスポンスは error_message で知らせます。動画 URL の解決は JSON で download_url を返し、動画ファイル自体は抖音の再生 URL から提供されます。バッチファイルなど他の納品方法はプロジェクトの範囲に応じて確認します。

トライアルの申し込み

下のフォームで抖音を選び、キーワードやアカウント、動画あたりに必要なコメント数、動画のダウンロード URL の要否をお知らせください。範囲を確認し、トライアルと API キーの進め方についてご連絡します。

よくある質問

抖音 API で動画をダウンロードできますか？

POST /douyin/videos は収集済みの投稿をダウンロード URL に解決し、リダイレクトをたどると抖音の現在の再生ファイルを取得できます。当社はリダイレクトするだけで動画をホスティング・保存しません。動画の削除や地域・IP の制限により取得できない場合があります。

v.douyin.com の短縮 URL は使えますか？

使えません。動画 URL の解決は完全な douyin.com の /video/{id} または /note/{id} URL のみ受け付けます。

動画あたり何件のコメントを収集できますか？

既定は 50 件です。max_items で上限を変えるか、get_all を true にして既定の上限をなくせますが、ページの安全上限と取得元の状況による制限は残ります。

抖音のコメントに第 2 階層の返信はありますか？

現在はありません。crawl_second_layer は false のみ対応です。

抖音のデータはどのように収集していますか？

抖音で公開されているコンテンツをウェブクローラーで収集しています。ご利用目的に適するかどうかは、用途と法域に応じて買い手側の法務部門でご判断ください。収集元と収集方法の説明はご提供できます。

関連リンク

• ソーシャルメディア API リファレンス一覧
• ソーシャルメディア API 製品ページ
• Weibo・小紅書・抖音データガイド
• api.infominer.io/docs の API ドキュメント