rednote/
user-profile

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

Rednote User Profile API

URLまたは user_id
正規化アカウント1件
1クレジット固定のタスク
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

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つ送信して非同期タスクを追跡し、保存された結果ページから正規化アカウントを読み取ります。

  1. 現在有効な公開 user_id、または解析後のホスト名が xiaohongshu.com、xhslink.com、もしくはそのいずれかのサブドメインであるURLを用意します。
  2. user_id、url、またはその両方を /v1/rednote/user-profile に送信します。両方を指定した場合は user_id が優先されます。返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. 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 true

Rednote 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 とは区別して扱ってください。

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

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

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

Rednote User Profile API — よくある質問

Rednote User Profile APIは、対応するアカウントURLまたは user_id から公開Rednoteプロフィールを最大1件取得し、正規化されたアカウントレコードを返すAPIです。

user_id がわかっている場合はそれを使用してください。両方のフィールドを送信することもできますが、明示的な user_id が優先され、URLはソースの照会に転送されません。

URLは、解析すると xiaohongshu.com、xhslink.com、またはそのサブドメインになる必要があります。user_id は、ASCIIの英字、数字、コロン、アンダースコア、ハイフンからなる1〜256文字である必要があります。

結果には、ID、ソースURL、Rednoteのハンドル、表示名、プロフィール文、アバター、カバー画像、ウェブサイト、認証・非公開フラグ、フォロワー数・フォロー数・投稿数、取得日時が含まれる場合があります。個々のフィールドは null になることがあります。

異なります。user_id は照会に使える識別子で、正規化された結果には独自の id があります。username にはソースが提供する場合にRednoteのハンドルが入るため、ソースの値を確認せずに user_id の代わりとして使わないでください。

対応していません。1つのタスクはプロフィール詳細のリクエストを1回実行し、最大1件のアカウントを保存します。ただし、共通のタスク結果レスポンスには、SocQが保存したレコードを読み取るための items、next_cursor、has_more が引き続き含まれます。

成功したRednote User Profileタスク1件につき固定で1.00 SocQクレジットです。リクエストの料金は、フィールド数や保存された結果の件数では決まりません。