rednote/
comment-replies

既知のRednoteコメントに付いた返信を公開ソース1ページ分取得し、正規化されたテキスト、投稿者、スレッドの関係、タイムスタンプ、表示中の指標を返します。

Rednote Comment Replies API

既知のコメントを指定
ネストされた返信
ソース1ページ分
1リクエストあたり1クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Rednote Comment Replies

Rednoteのコメント返信とは、ノート上の特定のコメントの下にネストされた公開の返信で、返信テキスト、投稿者情報、タイムスタンプ、取得可能な関係フィールドやエンゲージメントフィールドを含みます。正規化されたレコードを使えば、ソース側のコメントIDと保存済み結果のページネーションを混同することなく、既知の会話ブランチ1つを確認できます。

Rednote Comment Replies API の主な機能

  • スレッドを組み合わせて指定公開ノートのURLと、そのノートに属するコメントIDの両方を指定して、対象の会話ブランチを特定します。
  • 1ページ分の返信を取得ソースへのリクエストを1回実行し、そのページで返された返信を保存します。プロバイダーのカーソルや送信時の結果件数上限は公開していません。
  • 正規化された返信本文返信ID、公開テキスト、ソースURL、公開日時、取得日時を共通の CommentItem 形式で読み取れます。
  • 公開されている投稿者情報取得可能な投稿者ID、ユーザー名、表示名、プロフィールURL、アバター、アカウントフラグを各返信とあわせて保持します。
  • 会話の関係取得可能な parent_id と post_id のリンクを、表示中のいいね数・返信数とともに保持し、スレッドを考慮した処理に活用できます。

Rednote Comment Replies API のパラメータ

パラメータ必須説明
url必須必須。ホストが xiaohongshu.com、xhslink.com、またはそのいずれかのサブドメインである公開URLです。このエンドポイントでは、パスのパターンや xsec_token クエリの必須ルールは追加されません。
comment_id必須必須。ソースコメントの識別子で、ASCIIの英字、数字、コロン、アンダースコア、ハイフンからなる1〜256文字で指定します。

Rednote Comment Replies API の使い方

対応するRednoteノートのURLとコメントIDを送信し、SocQの非同期タスクワークフローを通じて1ページ分の返信結果を読み取ります。

  1. xiaohongshu.com または xhslink.com の公開ノートURLを選び、同じノートに属する有効なコメントIDを確認します。
  2. url と comment_id を /v1/rednote/comment-replies に POST し、返された task_id を保存します。
  3. タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、succeeded または failed になったら停止します。
  4. 成功したら data.results.items を読み取ります。data.results.next_cursor は、SocQに保存済みの返信行をページ送りする場合にのみ使用します。
curl -X POST "https://api.socq.ai/v1/rednote/comment-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"url\":\"$REDNOTE_NOTE_URL\",\"comment_id\":\"$REDNOTE_COMMENT_ID\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after status becomes succeeded

Rednote Comment Replies API の主なユースケース

  • 特定の会話の確認: ノート全体の返信を混在させず、選択したコメントブランチ1つについて公開返信のテキストとタイムスタンプを確認できます。
  • 参加者情報の補完: モデレーション調査や手動レビュー用のレコードを準備する際に、各返信を取得可能な正規化済み投稿者情報と関連付けます。
  • スレッド関係のマッピング: parent_id と post_id が存在する場合、返信IDとあわせて使用し、保存済みレコードを元のコメントやノートに再び結び付けます。
  • 特定時点の返信スナップショット: 表示中のいいね数や返信数とともに collected_at を保存し、実行ごとの観測結果を区別できるようにします。

Rednote Comment Replies API 活用のヒント

  • comment_id が送信したノートURLに属していることを確認してください。エンドポイントは各フィールドの形式を検証しますが、ソースへのリクエスト前にその対応関係までは確認しません。
  • このバリデーターは特定のノートパスや xsec_token クエリパラメータを必須としませんが、xiaohongshu.com、xhslink.com、または受け付けられるサブドメイン上の完全な公開URLを使用してください。
  • comment_id は受け付けられる1〜256文字のASCII識別子パターンの範囲内に収め、社内データベースのIDやSocQのタスクIDで代用しないでください。
  • 別の取得処理で得たコメントIDは条件付きの入力として扱ってください。正規化されたコメントIDは任意項目のため、送信前に使用可能な値が存在することを確認してください。
  • 送信ペイロードに results_limit やソースのカーソルを追加しないでください。このエンドポイントは、ソース1ページ分に対してプロバイダーへのリクエストを1回実行します。
  • タスク結果の next_cursor は comment_id と区別して扱ってください。このカーソルは、タスク成功後に保存された正規化済みの行をページ送りするためだけのものです。
  • ID情報、関係、タイムスタンプ、指標の各フィールドが null になることを想定し、公開返信テキストを別のプロダクトで表示する前にはエスケープしてください。

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

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

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

Rednote Comment Replies API — よくある質問

Rednote Comment Replies APIは、既知のRednoteコメントに付いた返信を公開ソース1ページ分取得し、正規化された返信、投稿者、関係、タイムスタンプ、表示中の指標の各フィールドを返します。

url と comment_id の両方が必須です。URLは公開Rednoteノートのコンテキストを特定し、comment_id はネストされた返信を取得する対象のソースコメントを指定します。

このエンドポイント固有のパスやクエリのルールは適用されません。ランタイムのバリデーターは、サブドメインを含め、解析可能な xiaohongshu.com または xhslink.com のホストを必須とします。形式上は受け付けられても無関係なURLの場合は、ソース側で失敗することがあります。

送信するノート上のコメントについて、確認済みの公開ソースレコードを使用してください。互換性のある上流のコメント取得処理では、プロバイダーが提供する場合に正規化された id が含まれることがありますが、このフィールドは任意項目であり、すべてのレコードに含まれるとは限りません。

CommentItem には、ID、platform、resource、type、ソースURL、公開テキスト、投稿者フィールド、parent_id、post_id、公開日時と取得日時、さらに表示中の likes_count と replies_count が含まれる場合があります。null許容のフィールドは、取得できない場合 null のままになります。

できません。送信時の仕様ではどちらのフィールドも受け付けず、ソースへのリクエストは1回のみです。成功後、next_cursor でSocQタスクに保存済みの行をページ送りできますが、プロバイダー側の取得を続行するものではありません。

成功したタスク1件につき固定で1 SocQクレジットです。ソースページから保存される返信の件数には左右されません。