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ページ分の返信結果を読み取ります。
- xiaohongshu.com または xhslink.com の公開ノートURLを選び、同じノートに属する有効なコメントIDを確認します。
- url と comment_id を /v1/rednote/comment-replies に POST し、返された task_id を保存します。
- タスクが queued、running、retrying の間は GET /v1/tasks/{task_id} をポーリングし、succeeded または failed になったら停止します。
- 成功したら 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 succeededRednote 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 になることを想定し、公開返信テキストを別のプロダクトで表示する前にはエスケープしてください。
関連API
Rednote Comment Replies API 以外に別の種類の公開Rednoteデータが必要な場合は、これらのAPIをご利用ください。