Rednote公開データAPI
公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。
利用できるRednote API
プロフィール、ノート、コメント、返信、検索、おすすめのワークフローに対応する8つのAPIから選べます。

rednote/comment-replies
コメント1リクエストあたり1クレジット

rednote/home-recommendations
投稿1リクエストあたり1クレジット

rednote/note-comments
コメント1リクエストあたり1クレジット

rednote/note-detail
投稿1リクエストあたり1クレジット

rednote/search-notes
検索1リクエストあたり1クレジット

rednote/search-users
検索1リクエストあたり1クレジット

rednote/user-notes
投稿1リクエストあたり1クレジット

rednote/user-profile
プロフィール1リクエストあたり1クレジット
取得できるRednoteデータ
RednoteのAPIカタログは、公開ソースデータから正規化されたアカウント、投稿、コメントのレコードを返します。
プロフィールとユーザーのノート
対応するアカウントURLまたは user_id を使い、公開プロフィール1件を取得したり、取得元の1ページ分のノートを取得したりできます。
ノートの詳細と発見
トークン付きのノートURL 1件の詳細取得、対応するフィルターによるノート検索、ホームのおすすめ1ページ分の取得ができます。
ユーザー検索
空でないクエリ1つで、公開アカウントを取得元の固定の1ページ目から検索します。
コメントと返信
ノートの公開コメントを1ページ分、または既知のコメントIDに対する返信を1ページ分取得します。
Rednote APIの仕様一覧
各エンドポイントは取得元へのリクエスト範囲が限定されており、宣言されていないパラメータは受け付けません。
| APIグループ | 入力の起点 | 取得元の範囲 |
|---|---|---|
| プロフィールとユーザーのノート | url または user_id | プロフィール1件または取得元の1ページ分。results_limit なし |
| ノートの詳細 | ノートのパスと xsec_token を含む対応URL | ノートのレコード最大1件 |
| 検索 | 空でないクエリと、対応する任意の列挙値 | 取得元の固定の1ページ目。results_limit なし |
| コメントと返信 | 対応するノートURL。返信には comment_id も必要 | 取得元のレスポンス1ページ分 |
| ホームのおすすめ | すべてのフィールドが任意 | 1ページ分。results_limit は1〜40、デフォルトは20 |
Rednote APIの仕組み
8つのエンドポイントはすべて、送信、ポーリング、保存済み結果の読み取りという共通の非同期ワークフローを使用します。
1. エンドポイントを選ぶ
公開データのタスクに合わせて、プロフィール、ノート、検索、コメント、返信、おすすめのエンドポイントを選択します。
2. 有効な入力を送信
宣言されたフィールドのみをPOSTし、返された task_id を保存します。
3. 正規化された結果を読み取る
タスクが終了状態になるまでポーリングしてから data.results.items を読み取ります。next_cursor は保存済み結果のページネーションにのみ使用します。
SocQのAPIキーで認証し、対応する任意のフィルターとともにクエリを送信します。成功したRednoteタスクは、1回あたり一律1クレジットです。
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"travel guide","sort_by":"general","media_type":"all"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successRednote APIの主なユースケース
クリエイターとコンテンツの調査
公開アカウントの情報に、上限付きの投稿ノート1ページ分を組み合わせます。
トピックの発掘
ノート検索、ユーザー検索、ホームのおすすめのスナップショットを、取得日時とともに比較します。
会話のレビュー
公開ノートのコメントと、選んだコメントのネストされた返信を、正規化レコードとして確認します。
制限事項と公開データポリシー
これらのエンドポイントは、範囲を限定した取得元へのリクエストで公開データを読み取るもので、アカウントの操作や非公開データへのアクセスは提供しません。
- 対応するURLのホストは xiaohongshu.com、xhslink.com とそれらのサブドメインです。Note Detailでは、さらに /explore/{id} または /discovery/item/{id} のパスと、空でない xsec_token が必要です。
- user_id と comment_id には、1〜256文字のASCII英字、数字、コロン、アンダースコア、ハイフンを指定できます。
- Search Notesは、sort_by、media_type、published_within について、記載された列挙値のみを受け付けます。Search Usersは query のみを受け付けます。
- results_limit を受け付けるのはHome Recommendationsのみで、範囲は1〜40、デフォルトは20です。
- 成功したRednoteタスクは、すべて一律1クレジットです。
Rednote APIに関するよくある質問
Rednote APIとは何ですか?
Rednote APIは、公開プロフィール、ノート、コメント、ネストされた返信、検索結果、ホームのおすすめを、正規化されたレコードとして取得するAPIです。
results_limit に対応しているエンドポイントはどれですか?
results_limit を受け付けるのはHome Recommendationsのみで、1〜40の整数を指定できます。その他のRednoteエンドポイントでは受け付けません。
Note DetailはどのRednote URLでも受け付けますか?
いいえ。対応するホスト、/explore/{id} または /discovery/item/{id} のパス、空でない xsec_token のクエリ値が必要です。
Rednoteのリクエストの料金はどのように計算されますか?
成功したタスクは、1回あたり一律1 SocQクレジットです。
プラットフォームを横断してデータを組み合わせ、より包括的なビジネスインサイトを
さまざまなプラットフォームの公開プロフィール、コンテンツ、エンゲージメントデータを1つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。
Kwai API
公開Kwaiプロフィール、アカウントの投稿1ページ分、既知の投稿1件を取得できます。アカウント情報、コンテンツ、メディア、タイムスタンプ、表示中のエンゲージメントは正規化されています。
Truth Social API
公開アカウントの詳細の取得、アカウントの投稿の取得元1ページ分の取得、既知の投稿URL 1件の解決ができ、正規化レコードとして返します。
Google Ad Library API
公開広告主の検索、企業ごとのクリエイティブの取得、URLによる既知の透明性センターのクリエイティブ1件の取得ができ、調査やレビューに活用できます。
Google Maps API
公開スポットの検索、既知のMaps URLの正規化された詳細の取得、取得元に紐づくスポット情報と投稿者のコンテキストを含む公開クチコミの取得ができます。
Amazon API
対応するマーケットプレイスで公開Amazon商品を検索し、正規化された商品詳細、売れ筋ランキング、レビュー、セラーのプロフィール、クリエイターのストアフロントのレコードを取得できます。
Apple App Store API
既知のストアURLから、公開Apple App Storeのアプリ詳細、カテゴリランキング、レビューを、正規化されたアプリとレビューのレコードとして取得できます。