rednote/
note-detail

トークン付きの xiaohongshu.com または xhslink.com のURLから公開Rednoteノートを1件取得し、正規化されたテキスト、投稿者、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

Rednote Note Detail API

トークン付きノートURL
ノート1件の詳細
正規化された投稿レコード
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Rednote Note Detail

Rednoteのノートは、テキストとメディアに、投稿者情報、トピックへの参照、公開日時、表示中のエンゲージメントを組み合わせた公開コンテンツです。これらのフィールドは、既知のリンクの情報補完、コンテンツのレビュー、選定したノートの特定時点での比較に活用できます。

Rednote Note Detail API の主な機能

  • トークン付きのノート照会受け付けられるホスト、note-detail のパス、空でない xsec_token によってソースの照会先が完全に特定できる場合にのみ、既知の公開ノートURLを1件解決します。
  • ノートと投稿者のコンテキスト正規化されたノートID、ソースURL、テキスト、タイムスタンプに加え、取得可能な投稿者ID、ユーザー名、表示名、プロフィールURL、アバター、アカウントフラグを返します。
  • メディアとエンゲージメントのスナップショット取得可能なメディア参照、プレビュー、サイズ、再生時間、トピック参照、表示中のいいね数・コメント数・シェア数・再生数を取得日時とともに保持します。

Rednote Note Detail API のパラメータ

パラメータ必須説明
url必須必須。xiaohongshu.com、xhslink.com、またはそのサブドメイン上の空でないURLです。パスには /explore/{note_id} または /discovery/item/{note_id} を含み、クエリには空でない xsec_token を含める必要があります。

Rednote Note Detail API の使い方

現在有効なトークン付きのノートURLを指定して非同期リクエストを送信し、完了後に正規化された投稿レコード1件を読み取ります。

  1. 受け付けられるホスト、note-detail のパス、空でない xsec_token を含むクエリ文字列を備えた、現在有効な公開ノートURLをコピーします。
  2. url を /v1/rednote/note-detail に POST し、送信レスポンスの data.task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. 成功したら data.results.items を読み取ります。ソースの照会は1回の詳細リクエストで、next_cursor はSocQに保存済みのレコードをページ送りするだけです。
REDNOTE_NOTE_URL=''
# Paste a current public note URL with xsec_token between the quotes

curl -X POST "https://api.socq.ai/v1/rednote/note-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\"}"

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

Rednote Note Detail API の主なユースケース

  • 既知ノートのカタログ補完: 条件を満たすノートURLを、正規化されたID、テキスト、投稿者、公開日時、ソースの各フィールドに変換し、既存のコンテンツインデックスに追加します。
  • 選定ノートの内容確認: テキスト、投稿者情報、メディア参照、トピックのフィールドを使って、特定の公開ノート群を個別に確認します。
  • エンゲージメント観測値の比較: 個別に送信した照会結果について、表示中のいいね数・コメント数・シェア数・再生数を collected_at と組み合わせ、特定時点の比較に活用します。

Rednote Note Detail API 活用のヒント

  • ホスト、/explore/ または /discovery/item/ のパス、xsec_token クエリパラメータを含む完全なノートURLを使用してください。ノートIDだけでは検証を通過できません。
  • リクエストで受け付けるのは url のみで、別のトークンフィールドは拒否されるため、xsec_token はURLのクエリ内に含めたままにしてください。
  • SocQの別のRednoteノート結果から取得したURLを再利用する場合は、xsec_token が残っていることを確認してください。Note Detail では欠けたトークンを復元できません。
  • この詳細エンドポイントにはバッチ用フィールド、results_limit、ソースのカーソル入力がないため、タスク1件につきURLを1つ送信してください。
  • next_cursor は保存済み結果のページネーション専用として扱ってください。ソース側では詳細の照会を1回だけ行い、通常は最大1件のレコードが生成されます。
  • 任意の公開値は欠落することがあるため、投稿者、メディア、トピック、タイムスタンプ、エンゲージメントの各フィールドは欠損を想定して保存し、表示中のカウンターは collected_at と組み合わせてください。

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

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

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

Rednote Note Detail API — よくある質問

Rednote Note Detail APIは、受け付けられるホスト上のトークン付きURLから公開Rednoteノートを1件取得し、正規化されたノートID、テキスト、投稿者、メディア、トピック参照、タイムスタンプ、表示中のエンゲージメントの各フィールドを返します。

xiaohongshu.com、xhslink.com、またはそのサブドメイン上の空でないURLを使用してください。パスには /explore/{note_id} または /discovery/item/{note_id} を含み、クエリには空でない xsec_token を含める必要があります。

できません。公開リクエストのスキーマで受け付けるのは url のみで、SocQがそのURLから note_id と xsec_token を抽出します。

xsec_token をすでに含む、現在有効な公開ノートURLを送信してください。SocQの別のRednoteノートエンドポイントが返したURLは、そのクエリパラメータが残っている場合に限り再利用できます。Note Detail が欠けたトークンを生成することはありません。

正規化された投稿レコードには、ノートID、URL、テキスト、公開日時と取得日時、投稿者の詳細、メディア、ハッシュタグ、メンション、表示中のいいね数・コメント数・シェア数・再生数が含まれる場合があります。任意の公開フィールドは null になることがあります。

対応していません。ソース側では詳細の照会を1回だけ行い、最大1件のレコードを保存します。ただし、共通のタスクリーダーでは、SocQに保存済みのレコード向けに limit、next_cursor、has_more が引き続き提供されます。

このエンドポイントは、タスク1件につき固定で1.00 SocQクレジットに設定されています。見積もりは返されるレコード数によって変わりません。