API一覧に戻る
Douyinの公開データ

Douyin公開データAPI

公開プロフィールと動画の取得、動画の検索、コメントやクリエイターの動画の1ページ分の取得、既知のライブ配信ルームの確認ができます。

利用できるDouyin API

プロフィール、動画、コメント、検索、ライブ配信ルームのワークフローに対応する6つのAPIから選べます。

取得できるDouyinデータ

DouyinのAPIカタログは、公開ソースデータから正規化されたアカウント、ショート動画、コメント、ライブ配信ルームのレコードを返します。

プロフィールとクリエイターの動画

公開プロフィールを取得したり、対応するプロフィールURLまたは user_id から取得元の1ページ分の動画を取得したりできます。

動画の詳細、検索、コメント

対応する動画の参照から詳細を確認したり、クエリで取得元の固定の1ページ目を検索したり、コメントを1ページ分取得したりできます。

ライブ配信ルームの詳細

数字のみの room_id で既知のライブ配信ルームを1件取得し、取得可能な配信者、ステータス、メディア、表示中の視聴者のフィールドを返します。

Douyin APIの仕様一覧

各エンドポイントは取得元へのリクエスト範囲が限定されており、宣言されていないパラメータは受け付けません。

APIグループ入力の起点取得元の範囲
プロフィールとクリエイターの動画url または user_idプロフィール1件または取得元の1ページ分。クリエイターの動画は results_limit 1〜20に対応
動画の詳細とコメント対応するURL詳細レコード1件またはコメント1ページ分。コメントは results_limit 1〜20に対応
動画の検索空でないクエリ取得元の固定の1ページ目。results_limit なし
ライブ配信ルーム数字のみの room_idライブ配信ルームのレコード最大1件

Douyin APIの仕組み

6つのエンドポイントはすべて、送信、ポーリング、保存済み結果の読み取りという共通の非同期ワークフローを使用します。

  1. 1. エンドポイントを選ぶ

    手元にある公開データの参照に合わせて、プロフィール、動画、コメント、検索、ライブ配信ルームのエンドポイントを選択します。

  2. 2. 有効な入力を送信

    宣言されたフィールドのみをPOSTし、返された task_id を保存します。

  3. 3. 正規化された結果を読み取る

    タスクが終了状態になるまでポーリングしてから data.results.items を読み取ります。next_cursor は保存済み結果のページネーションにのみ使用します。

公開Douyin動画を検索

SocQのAPIキーで認証し、空でないクエリを送信します。成功したDouyinタスクは一律0.10クレジットです。

curl -X POST "https://api.socq.ai/v1/douyin/video-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"artificial intelligence"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Douyin APIの主なユースケース

クリエイター調査

公開プロフィールのアカウント情報に、上限付きのクリエイター動画1ページ分と表示中のエンゲージメントを組み合わせます。

コンテンツと会話のレビュー

既知の動画の情報を補完し、トピックのスナップショットを検索し、公開コメントを1ページ分確認します。

ライブ配信ルームのモニタリング

明示的な数値のルームIDを使い、既知の公開ライブ配信ルームのスナップショットを記録します。

制限事項と公開データポリシー

これらのエンドポイントは、範囲を限定した取得元へのリクエストで公開データを読み取るもので、アカウントの操作や継続的なモニタリングは提供しません。

  • user_id には、1〜256文字のASCII英字、数字、コロン、アンダースコア、ハイフンを指定できます。プロフィールURLには、対応するDouyinのホスト上の /user/{identifier} を含める必要があります。
  • room_id は数字のみで構成される文字列です。長い識別子をJavaScriptの数値型で扱わないでください。
  • results_limit はUser VideosとVideo Commentsでのみ利用でき、範囲は1〜20、デフォルトは20です。
  • Video Searchは取得元の1ページ目に固定されています。タスク結果のカーソルは、そのタスクですでに保存されたレコードのページ分割にのみ使われます。
  • 成功したDouyinタスクは、すべて一律0.10クレジットです。

Douyin APIに関するよくある質問

Douyin APIとは何ですか?

Douyin APIは、公開プロフィール、動画、コメント、動画の検索結果、ライブ配信ルームの詳細を、正規化されたレコードとして取得するAPIです。

results_limit に対応しているエンドポイントはどれですか?

User VideosとVideo Commentsは、1〜20の整数を受け付けます。その他のDouyinエンドポイントは results_limit を受け付けません。

取得元をページ送りできますか?

呼び出し側で制御できる取得元のカーソルはありません。返される next_cursor は、完了したタスクですでに保存された結果をページ分割するためだけのものです。

Douyinのリクエストの料金はどのように計算されますか?

成功したタスクは、1回あたり一律0.10 SocQクレジットです。

さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。

YouTube API

対応する公開YouTubeのチャンネルプロフィール、動画の詳細、チャンネルの動画、コメント、ショート、キーワード・ハッシュタグの検索結果、取得可能な文字起こしを、正規化された1つの非同期ワークフローで取得できます。

Facebook API

公開Facebookページのプロフィール、投稿、グループ投稿、コメント、キーワードに一致するイベント、取得可能な動画の文字起こしを取得できます。アカウント情報、コンテンツ、取得元、形式、場所、メディア、リアクション、参加状況、エンゲージメントのフィールドは正規化されています。

X API

公開プロフィール、フォロワー・フォロー中の関係、ポスト、返信、引用、リツイートしたユーザー、検索結果、現在のトレンドを取得できます。一貫した形式の結果を調査やモニタリングに活用できます。

LinkedIn API

既知のURLから、公開LinkedInのプロフィール、企業、投稿、求人のデータを取得できます。アカウント情報、職歴、企業、コンテンツ、エンゲージメント、求人のフィールドは正規化されています。

Reddit API

既知のURLから公開Redditの投稿とコメントを取得したり、サブレディットの新着・トップ・人気の投稿を閲覧したり、キーワードと公開期間で議論を検索したりできます。

Pinterest API

公開Pinterestプロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。