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つ送信して非同期タスクを追跡し、保存済み結果のエンベロープから正規化アカウントを読み取ります。
- /user/<identifier> のパスを含む完全なDouyinプロフィールURL、または対応する公開 user_id のどちらかを用意します。
- 識別子を1つ /v1/douyin/user-profile に POST し、返された task_id を保存します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- 成功したら 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.itemsDouyin 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 を保持してください。
関連API
Douyin User Profile API 以外に別の種類の公開Douyinデータが必要な場合は、これらのAPIをご利用ください。
- Douyin Live Room Detail API — 数値のルームIDから既知のDouyinライブ配信ルーム1件を取得し、正規化されたルーム情報、配信者情報、メディア、表示中の視聴者数を返します。
- Douyin User Videos API
- Douyin Video Comments API
- Douyin Video Detail API
- Douyin Video Search API