douyin/
video-search

テキストの検索語で公開Douyin動画の固定1ページ目を検索し、取得可能な場合は正規化されたキャプション、投稿者情報、メディア、再生時間、タイムスタンプ、表示中のエンゲージメントを返します。

Douyin Video Search API

テキスト検索語
固定の1ページ目
正規化された動画
1リクエストあたり0.1クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Douyin Video Search

Douyin Video Searchは、空でないテキストの検索語を、範囲の限定された公開動画データセットに変換します。各タスクは、ページ1・オフセット0を指定してプロバイダーへの固定のリクエストを1回実行し、返されたレコードをSocQの reel-video 形式で保存するため、後続の処理で一貫して読み取れます。

Douyin Video Search API の主な機能

  • 1フィールドだけの検索仕様送信するのは query のみです。エンドポイントは results_limit などの未定義の入力を拒否し、プロバイダーのトークンや内部識別子は必要ありません。
  • 範囲を限定したソースリクエストすべてのタスクはプロバイダーにページ1・オフセット0を要求し、プロバイダーのページネーション操作は呼び出し側に公開しません。
  • 正規化された reel-video レコード取得可能なテキスト、投稿者、メディア、再生時間、タイムスタンプ、表示中の再生数・いいね数・コメント数・シェア数を、一貫した結果スキーマで読み取れます。
  • 保存済み結果の非同期読み取り1回送信してタスクをポーリングし、完了したタスクが1回のレスポンスで返せる以上のレコードを保存した場合にのみ、SocQの結果カーソルを使用します。

Douyin Video Search API のパラメータ

パラメータ必須説明
query必須必須。空でないテキストの検索語です。プロバイダーのキーワードフィールドに対応付けられ、page と offset はバックエンドで固定されます。

Douyin Video Search API の使い方

空でない query を指定して非同期タスクの完了を待ち、そのタスクに保存された正規化レコードを読み取ります。

  1. 見つけたい公開動画を表す、具体的なテキストの検索語を選びます。
  2. query を /v1/douyin/video-search に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。has_more が true の場合は、タスク結果のリクエストに next_cursor を渡して、SocQに保存されたレコードの続きを読み取ります。
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 の主なユースケース

  • トピック起点の動画発見: 1つの商品、テーマ、イベント、調査用フレーズに対して返された公開動画について、範囲を限定したスナップショットを作成します。
  • クリエイターのコンテキスト確認: 返されたキャプションやメディアを取得可能な公開投稿者フィールドと結び付け、定性調査やデータセットの補完に活用します。
  • フォーマットとメディアの分析: 取得可能な動画メディア、サムネイル、サイズ、再生時間を、ソースレコードや検索語のコンテキストとあわせて確認します。
  • 表示中のエンゲージメントのスナップショット: collected_at を観測時刻として保持しながら、取得可能な再生数・いいね数・コメント数・シェア数を比較します。

Douyin Video Search API 活用のヒント

  • タスクを送信する前に、自社のインターフェース側で空白だけではない意味のある検索語を必須にしてください。
  • results_limit、page、offset、search_id、プロバイダーのカーソルは送信しないでください。これらはSocQの公開リクエストスキーマに含まれていません。
  • 返された結果は、網羅的な検索インデックスや呼び出し側で制御できるランキング範囲ではなく、プロバイダーの1回分のレスポンスとして扱ってください。
  • GET /v1/tasks/{task_id} の cursor と limit は、保存済み結果の読み取りにのみ使用してください。limit はデフォルトが50で、1〜500を受け付けます。
  • collected_at を保持し、任意の投稿者、メディア、公開日時、再生時間、個々の指標のフィールドは、欠損値を0で置き換えずに扱ってください。

Douyin Video Search API 以外に別の種類の公開Douyinデータが必要な場合は、これらのAPIをご利用ください。

他のプラットフォームを見る

Douyinのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Douyin Video Search API — よくある質問

Douyin Video Search APIは、テキストの検索語1つで公開Douyin動画の固定1ページ目を検索し、正規化された reel-video レコードを返すAPIです。

受け付けるのは query のみで、空でない文字列である必要があります。このエンドポイントは results_limit、page、offset、呼び出し側が指定するプロバイダーのカーソルを受け付けません。

できません。バックエンドは常に1回のプロバイダーリクエストでページ1・オフセット0を送信し、ソースのページネーション操作は公開していません。

GET /v1/tasks/{task_id} が返す next_cursor は、完了したタスクについてSocQがすでに保存したレコードを先に進めるものです。Douyinの別のソースページを取得することはありません。

結果は reel-video スキーマを使用し、ID、URL、テキスト、公開投稿者情報、メディア、再生時間、公開日時と取得日時、ハッシュタグ、メンション、音声、表示中の再生数・いいね数・コメント数・シェア数が含まれる場合があります。任意のフィールドは null または空になることがあります。

成功したタスク1件につき固定で0.10 SocQクレジットです。1回のプロバイダーリクエストで返されるレコード数には左右されません。