douyin/
user-profile

対応するプロフィールURLまたはユーザー識別子から公開Douyinプロフィールを1件取得し、正規化されたアカウント情報、プロフィール文、画像、アカウントフラグ、表示中の数値を返します。

Douyin User Profile API

URLまたはユーザーID
公開プロフィール1件
正規化されたアカウントフィールド
1リクエストあたり0.1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Douyin User Profile

Douyinのユーザープロフィールは、アカウント情報、プロフィール文、プロフィール画像、認証・非公開の状態に加え、表示中のフォロワー数・フォロー数・投稿数を持つ公開アカウントページです。これらのフィールドは、アカウント情報の補完、本人確認、スナップショットの監視、プロフィールの比較調査に活用できます。

Douyin User Profile API の主な機能

  • 2種類の識別子に対応対応するDouyinユーザーURL、またはランタイムの識別子ルールに一致する user_id のどちらかから、公開プロフィールを1件解決します。
  • プロフィールの識別情報と表示内容取得可能なプロフィールID、公開URL、ユーザー名、表示名、プロフィール文、アバター、カバー画像、関連ウェブサイトを1つのアカウントレコードで返します。
  • 明示的なアカウント状態フィールド公開ソースが省略している場合に状態を推測せず、取得可能な認証フラグと非公開フラグを null許容の値として保持します。
  • 表示中のプロフィール数値取得可能なフォロワー数・フォロー数・投稿数を collected_at とともに正規化し、公開プロフィールを特定時点の状態として把握できます。

Douyin User Profile API のパラメータ

パラメータ必須説明
url必須(いずれか1つ以上)url または user_id を指定してください。空でないURLは、douyin.com、iesdouyin.com、またはそのサブドメインを使用し、/user/<identifier> のパスを含む必要があります。
user_id必須(いずれか1つ以上)user_id または url を指定してください。user_id は、ASCIIの英字、数字、コロン、アンダースコア、ハイフンからなる1〜256文字を受け付け、両方のフィールドを送信した場合はこちらが優先されます。

Douyin User Profile API の使い方

対応するプロフィール識別子を1つ送信して非同期タスクを追跡し、保存済み結果のエンベロープから正規化アカウントを読み取ります。

  1. /user/<identifier> のパスを含む完全なDouyinプロフィールURL、または対応する公開 user_id のどちらかを用意します。
  2. 識別子を1つ /v1/douyin/user-profile に POST し、返された task_id を保存します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を読み取ります。ソースの照会で生成されるプロフィールは最大1件ですが、保存済み結果のエンベロープには引き続き has_more と next_cursor が含まれます。
curl -X POST "https://api.socq.ai/v1/douyin/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"user_id\":\"${DOUYIN_USER_ID}\"}"

# Poll GET /v1/tasks/{task_id}
# Read the normalized account from data.results.items

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

  • クリエイターレコードの補完: 既存のクリエイターレコードに、取得可能なDouyinのアカウント情報、プロフィール文、画像、ウェブサイト、アカウントフラグ、公開数値を追加します。
  • プロフィールの本人確認: 社内のエンティティに紐づける前に、既知のプロフィールURLやユーザー識別子を一貫したアカウントオブジェクトに解決します。
  • 公開アカウントの比較: 同じ正規化済みの指標キーを使い、個別に取得したプロフィール間でフォロワー数・フォロー数・投稿数を比較します。
  • プロフィールのスナップショット監視: アカウント情報のフィールドと公開指標を collected_at とともに保存し、後続のタスクを特定時点の観測結果として区別できるようにします。

Douyin User Profile API 活用のヒント

  • 正規のユーザー識別子がすでにある場合は、user_id のみを送信してください。url と user_id が一致しない場合、プロバイダーへのリクエストには user_id が使用されます。
  • URLを送信する前にホスト名を検証し、/user/<identifier> のパスを必須とすることで、動画やその他のDouyinリソースへのリンクを手元で除外できます。
  • ソースから得られるプロフィールレコードは0件または1件です。タスクリーダーのカーソルは保存済みのSocQアイテムをページ送りするもので、この照会でプロバイダーの別ページを要求することはできません。
  • アカウント情報、画像、ウェブサイト、アカウントフラグ、所在地、各指標は null になり得るものとして扱い、繰り返し取得したスナップショットを比較する際は collected_at を保持してください。

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

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

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

Douyin User Profile API — よくある質問

Douyin User Profile APIは、対応するプロフィールURLまたはユーザー識別子から公開Douyinアカウントを1件取得し、正規化されたアカウント情報、プロフィール文、画像、アカウントフラグ、表示中の数値、取得日時を返します。

どちらのフィールドでもリクエストの要件を満たします。両方の値がある場合は user_id が優先されるため、解決したい識別子だけを送信してください。

解析後のホスト名が douyin.com、iesdouyin.com、またはそのサブドメインであり、パスに /user/ とそれに続く英字、数字、アンダースコア、ハイフンからなる識別子が含まれている必要があります。動画のリンクや無関係なホストは拒否されます。

アカウントスキーマには、プロフィールIDとURL、ユーザー名、表示名、プロフィール文、アバター、カバー画像、ウェブサイト、認証・非公開フラグ、所在地、フォロワー数、フォロー数、投稿数、collected_at が含まれる場合があります。任意の公開フィールドは、値が取得できない場合 null のままになります。

対応していません。プロバイダーへの照会は1件の詳細リクエストで、ソースプロフィールは最大1件です。next_cursor と has_more は、SocQにすでに保存された結果のページネーションを表すだけです。

成功したタスク1件につき固定で0.10 SocQクレジットです。料金は、任意のプロフィールフィールドがいくつ入っているかには左右されません。