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つ送信し、非同期タスクを追跡して、保存された正規化コメントを読み取ります。
- xiaohongshu.com または xhslink.com 上の実際のRednoteノートの共有リンクをコピーします。
- url を /v1/rednote/note-comments に POST し、返された task_id を保存します。
- タスクが成功するか失敗を報告するまで、/v1/tasks/{task_id} をポーリングします。
- 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 trueRednote 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 は、完了したタスクにすでに保存された正規化レコードをページ送りするだけです。
関連API
Rednote Note Comments API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。