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. エンドポイントを選ぶ
手元にある公開データの参照に合わせて、プロフィール、動画、コメント、検索、ライブ配信ルームのエンドポイントを選択します。
2. 有効な入力を送信
宣言されたフィールドのみをPOSTし、返された task_id を保存します。
3. 正規化された結果を読み取る
タスクが終了状態になるまでポーリングしてから data.results.items を読み取ります。next_cursor は保存済み結果のページネーションにのみ使用します。
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 successDouyin 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プロフィールのデータ取得、既知のピンの解決、指定したプロフィールのピンの取得、キーワード検索ができ、クリエイター、コンテンツ、ビジュアルトレンドの調査に活用できます。





