Rednote User Profile
公開Rednoteプロフィールでは、アカウント識別子、Rednoteのハンドル、表示名、プロフィール文、プロフィール画像、ウェブサイト、アカウントフラグ、表示中のフォロワー数・フォロー数・投稿数が公開されている場合があります。正規化されたレコードは、取得可能なこれらの識別情報と特定時点の指標をまとめて保持し、アカウントの照合、選定プロフィールの比較、繰り返し取得したスナップショットの分析に活用できます。
Rednote User Profile API の主な機能
- 優先順位が明確な2種類の照会方法対応するRednoteのURLまたは公開 user_id からプロフィールを1件解決します。両方のフィールドを指定した場合は、明示的な user_id がソースの照会に使用されます。
- 一貫した公開アカウント情報レコード取得可能なアカウントID、ソースURL、Rednoteのハンドル、表示名、プロフィール文、アバター、カバー画像、ウェブサイト、認証フラグ、非公開フラグを正規化します。
- タイムスタンプ付きの表示中アカウント指標取得可能なフォロワー数・フォロー数・投稿数を collected_at とともに返すため、各結果はリアルタイムの合計値ではなく特定時点の観測値として扱えます。
Rednote User Profile API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
url | 必須(いずれか1つ以上) | url または user_id のいずれかが必須です。解析後のホスト名は xiaohongshu.com、xhslink.com、またはそのいずれかのサブドメインである必要があります。user_id も指定されている場合は、user_id が優先されます。 |
user_id | 必須(いずれか1つ以上) | user_id または url のいずれかが必須です。ASCIIの英字、数字、コロン、アンダースコア、ハイフンからなる1〜256文字で指定します。url も指定されている場合は、この明示的な識別子が優先されます。 |
Rednote User Profile API の使い方
対応するアカウント参照を1つ送信して非同期タスクを追跡し、保存された結果ページから正規化アカウントを読み取ります。
- 現在有効な公開 user_id、または解析後のホスト名が xiaohongshu.com、xhslink.com、もしくはそのいずれかのサブドメインであるURLを用意します。
- user_id、url、またはその両方を /v1/rednote/user-profile に送信します。両方を指定した場合は user_id が優先されます。返された task_id を保存します。
- タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
- data.results.items からアカウントを読み取ります。next_cursor は、保存済み結果のリーダーが has_more を true と返した場合にのみ使用します。
REDNOTE_USER_ID=''
# Paste a current public Rednote account identifier before running.
curl -X POST "https://api.socq.ai/v1/rednote/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d "{\"user_id\":\"$REDNOTE_USER_ID\"}"
# Poll GET /v1/tasks/{task_id}
# Read data.results.items; follow next_cursor only while has_more is trueRednote User Profile API の主なユースケース
- 既知アカウントの情報補完: 既存の公開Rednoteアカウント参照を、取得可能なプロフィールテキスト、画像、ウェブサイト、アカウントフラグを含む一貫したアカウント情報レコードに変換します。
- プロフィールのスナップショット比較: 安定した結果ID、collected_at、取得時点のフォロワー数・フォロー数・投稿数を使い、選定したアカウント同士や繰り返し取得した結果を比較します。
Rednote User Profile API 活用のヒント
- 少なくとも1つの入力を指定してください。url と user_id の両方がある場合、バックエンドは明示的な user_id を使用し、URLはソースの照会に送信しません。
- 公開アカウント識別子をすでに持っている場合は user_id を優先してください。共有URLやアカウントURLの構造に依存せずに済みます。
- 送信前に、user_id を ^[A-Za-z0-9:_-]{1,256}$ で検証し、解析後のURLのホスト名が xiaohongshu.com、xhslink.com、またはそのサブドメインと一致することを確認してください。
- results_limit やソースのカーソルを追加しないでください。このエンドポイントは詳細リクエストを1回実行するだけで、next_cursor はSocQの保存済み結果リーダー専用です。
- プロフィール文、プロフィール画像、ウェブサイト、フラグ、すべての指標は任意項目として扱ってください。欠損したフィールドを空文字列や0に変換せず、null のまま保持してください。
- 以前に取得したRednoteアカウント結果の正規 id を user_id として使用できます。この識別子は、取得可能なRednoteのハンドルを表す返却値の username とは区別して扱ってください。
関連API
Rednote User Profile API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。