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件を読み取ります。
- 受け付けられるホスト、note-detail のパス、空でない xsec_token を含むクエリ文字列を備えた、現在有効な公開ノートURLをコピーします。
- url を /v1/rednote/note-detail に POST し、送信レスポンスの data.task_id を保存します。
- タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
- 成功したら 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.itemsRednote 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 と組み合わせてください。
関連API
Rednote Note Detail API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。