rednote/
note-comments

xiaohongshu.com または xhslink.com のノートURLから、Rednoteの公開コメントを1ページ分取得し、テキスト、投稿者、タイムスタンプ、ノートへの参照、表示中のエンゲージメントを返します。

Rednote Note Comments API

ノートURLを入力
ソースへのリクエスト1回
正規化されたコメント
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Rednote Note Comments

Rednoteのノートコメントとは、特定のノートに紐づく公開の反応で、コメント本文、投稿者情報、公開日時、スレッドへの参照、表示中のインタラクション数を含む場合があります。選んだノートに対して人々が何を語ったかを、ソースと取得日時に結び付けたまま記録するのに役立ちます。

Rednote Note Comments API の主な機能

  • 柔軟なRednote共有リンク入力xiaohongshu.com、xhslink.com、またはそのサブドメイン上の参照を1つ送信します。note-comments のバリデーターは、特定のパス、クエリ文字列、xsec_token を必須としません。
  • 安定したコメントレコードコメントID、テキスト、ソースURL、タイムスタンプ、取得可能な投稿者情報を、正規化された CommentItem 1.0 の結果形式で受け取れます。
  • ノートとスレッドへの参照post_id と parent_id が提供されている場合は保持するため、返されたコメントをノートや取得可能な親コメントのコンテキストと関連付けたまま扱えます。
  • 特定時点のエンゲージメントフィールド取得可能な likes_count と replies_count を collected_at とともに保持します。欠損値を0に変換したり、すべての返信を網羅しているかのように扱ったりはしません。

Rednote Note Comments API のパラメータ

パラメータ必須説明
url必須必須。空でない参照です。ランタイムの検証では xiaohongshu.com、xhslink.com、およびそれらのサブドメインを受け付け、パス名の強制や xsec_token の要求は行いません。プロバイダーが目的のノートを特定できるよう、実際のノートの共有リンクを使用してください。

Rednote Note Comments API の使い方

対応するRednoteノートのリンクを1つ送信し、非同期タスクを追跡して、保存された正規化コメントを読み取ります。

  1. xiaohongshu.com または xhslink.com 上の実際のRednoteノートの共有リンクをコピーします。
  2. url を /v1/rednote/note-comments に POST し、返された task_id を保存します。
  3. タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
  4. data.results.items を読み取ります。保存済みのタスク結果をページ送りするには、has_more が true の場合にのみ next_cursor を使用します。
curl -X POST "https://api.socq.ai/v1/rednote/note-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://xhslink.com/{share_code}"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • 反応の定性コーディング: 返された公開テキストと取得可能な投稿者情報を確認し、選んだノートに寄せられた質問、反応、繰り返し現れる議論のテーマを整理します。
  • ソースに紐づくコメントアーカイブ: コメントID、ソースURL、post_id、parent_id、published_at、collected_at を保存し、追跡可能な調査記録として残します。
  • エンゲージメントのスナップショット確認: 返されたコメント間で取得可能ないいね数と返信数を比較し、すべての観測結果を取得日時に結び付けて管理します。

Rednote Note Comments API 活用のヒント

  • 目的のノートからコピーした完全な共有リンクを使用してください。ホスト名の検証を通過しても、無関係なパスをプロバイダーが解決できるとは限りません。
  • xsec_token を独自に作成したり、別途必須にしたりしないでください。このルールは note-detail の仕様に属するもので、rednote/note-comments には適用されません。
  • results_limit やプロバイダーのカーソルは送信しないでください。送信できるのは url のみで、ソースへのリクエストは1回だけ実行されます。
  • parent_id、post_id、タイムスタンプ、投稿者の属性、指標は、必ず返される値ではなく、null になり得るソースフィールドとして扱ってください。
  • ソースからの取得範囲と next_cursor は区別して扱ってください。next_cursor は、完了したタスクにすでに保存された正規化レコードをページ送りするだけです。

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

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

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

Rednote Note Comments API — よくある質問

Rednote Note Comments APIは、指定したRednoteノートのリンクに紐づく公開コメントを、ソースのレスポンス1ページ分取得するAPIです。

ランタイムでは、解析後のホスト名が xiaohongshu.com、xhslink.com、またはそのサブドメインである、空でない url を1つ指定する必要があります。特定のパスやクエリは強制されませんが、プロバイダーが正しく解決するには実際のノートの共有リンクが必要です。

必要ありません。rednote/note-comments では、Rednote共通のホスト名バリデーターのみが適用されます。より厳格なパスと xsec_token のチェックは、別の note-detail の仕様に適用されるものです。

できません。送信時の仕様で受け付けるのは url のみで、プロバイダー連携はソースへのリクエストを1回実行し、呼び出し側でソースのページネーションを制御することはできません。

共通のタスク結果リーダーは、成功したタスクにすでに保存された CommentItem レコードをページ送りできます。この不透明なSocQカーソルが、Rednoteの別のソースページを要求することはありません。

成功したRednote Note Commentsタスク1件につき固定で1.00 SocQクレジットです。1回のソースリクエストで返されるコメント数には左右されません。