douyin/
user-videos

DouyinのプロフィールURLまたは既知のユーザーIDから公開動画を最大20件取得し、正規化されたコンテンツ、投稿者、メディア、再生時間、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。

Douyin User Videos API

プロフィールURLまたはユーザーID
最大20件の動画
正規化された reel-video レコード
1リクエストあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Douyin User Videos

このエンドポイントは、Douyinクリエイター1人の識別情報から、1ページ分の公開動画レコードを生成します。各レコードには、ソースが提供している場合、キャプション、投稿者情報、ソースURL、公開日時と取得日時、メディア、再生時間、表示中の再生数・いいね数・コメント数・シェア数・視聴数が含まれます。

Douyin User Videos API の主な機能

  • 2通りのクリエイター指定方法対応するDouyinプロフィールURL、または既知の user_id を送信します。両方のフィールドがある場合は、直接指定された user_id が使用されます。
  • 明確な1ページ分の範囲要求する結果件数を1〜20から選べます。デフォルトかつ上限は20で、プロバイダーへのリクエストは常に1ページ目から開始します。
  • 動画とクリエイターのコンテキストを一括保持正規化されたキャプション、公開投稿者フィールド、ソースURL、タイムスタンプ、メディア参照、再生時間を各 reel-video レコードに保持します。
  • 観測に適したエンゲージメントフィールド取得可能な再生数・いいね数・コメント数・シェア数・視聴数を collected_at とともに保持し、表示中のすべての数値を取得日時に結び付けます。

Douyin User Videos API のパラメータ

パラメータ必須説明
url必須(いずれか1つ以上)ホスト名が douyin.com、iesdouyin.com、またはそのサブドメインで、パスに /user/{identifier} を含むDouyinプロフィールの参照です。url または user_id を指定してください。両方がある場合は user_id が優先されます。
user_id必須(いずれか1つ以上)ASCIIの英字、数字、コロン、アンダースコア、ハイフンからなる1〜256文字の既知のユーザー識別子です。user_id または url を指定してください。
results_limit任意プロバイダーの1ページ分から要求するレコード数です。1〜20の整数を受け付け、デフォルトは20です。

Douyin User Videos API の使い方

公開クリエイターの識別情報を1つ送信して非同期タスクを追跡し、保存された正規化動画レコードを読み取ります。

  1. /user/{identifier} のパスを含む douyin.com または iesdouyin.com 上のDouyinプロフィールURL、または既知の user_id のどちらかを用意します。
  2. 識別情報と、任意で1〜20の results_limit を /v1/douyin/user-videos に POST し、task_id を保存します。
  3. タスクが成功または失敗するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。next_cursor は、SocQにすでに保存された追加レコードを読む場合にのみ使用し、プロバイダーの別ページを取得するものではありません。
curl -X POST "https://api.socq.ai/v1/douyin/user-videos" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"'"$DOUYIN_PROFILE_URL"'","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and use next_cursor only for stored results

Douyin User Videos API の主なユースケース

  • クリエイターフィードのスナップショット: 選んだ観測時点で、クリエイター1人の公開動画を件数を絞って取得日時とともに保存します。
  • 動画カタログの補完: 既存のクリエイターレコードに、正規化されたキャプション、投稿者情報、ソースURL、公開日時、再生時間、取得可能なメディアを追加します。
  • クリエイティブとフォーマットの確認: 返されたキャプション、再生時間、メディアのフィールドを確認し、取得できた動画をコンテンツの演出やフォーマットごとに整理します。
  • スナップショット内のエンゲージメント比較: collected_at を保持したまま、返された動画間で取得可能な再生数・いいね数・コメント数・シェア数・視聴数を比較します。

Douyin User Videos API 活用のヒント

  • リクエストごとに識別情報のフィールドは1つにすることをおすすめします。url と user_id の両方を含めた場合、バックエンドは user_id を選択します。
  • 送信前にURLのホストと /user/{identifier} のパスを検証してください。一般的なDouyin動画のURLでは、このエンドポイントの条件を満たしません。
  • results_limit は、デフォルトの20件より少ない件数で十分な場合にのみ設定してください。値は1〜20の整数である必要があります。
  • タスク結果のカーソルをDouyinソースのカーソルとして扱わないでください。ソースへのリクエストは1ページ分のみで、プロバイダーのカーソルは1ページ目に固定されています。
  • 任意の投稿者、メディア、再生時間、公開日時、個々の指標が null や空のままになることを許容し、観測結果を保存する際は id と collected_at を組み合わせて使用してください。

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

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

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

Douyin User Videos API — よくある質問

Douyin User Videos APIは、クリエイター1人の正規化された公開動画レコードを返すAPIです。取得可能な場合は、ID、キャプション、投稿者情報、ソースURL、タイムスタンプ、メディア、再生時間、表示中のエンゲージメントの各フィールドが含まれます。

どちらのフィールドでも入力要件を満たします。URLは対応するDouyinのホストを使用し、/user/{identifier} を含む必要があります。既知の user_id は直接指定でき、両方のフィールドがある場合はこちらが優先されます。

プロバイダーの1ページ分から要求するレコード数を制御します。値は1〜20の整数で、デフォルトは20です。

結果には、plays、likes、comments、shares、views が含まれる場合があります。各フィールドは任意項目のため、ソースから取得できない値は推測されず null のままになります。

できません。プロバイダーへのリクエストは1ページ目のみを使用します。SocQタスク結果リーダーの next_cursor は、そのタスクにすでに保存されたレコードをページ送りするものです。

成功したDouyin User Videosタスク1件につき固定で0.10 SocQクレジットです。上限20件の範囲内で返されるレコード数には左右されません。