API一覧に戻る
Rednoteの公開データ

Rednote公開データAPI

公開プロフィールとノートの取得、ノートやユーザーの検索、コメントとネストされた返信の取得、ホームのおすすめ1ページ分の取得ができます。

利用できるRednote API

プロフィール、ノート、コメント、返信、検索、おすすめのワークフローに対応する8つのAPIから選べます。

取得できる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. 1. エンドポイントを選ぶ

    公開データのタスクに合わせて、プロフィール、ノート、検索、コメント、返信、おすすめのエンドポイントを選択します。

  2. 2. 有効な入力を送信

    宣言されたフィールドのみをPOSTし、返された task_id を保存します。

  3. 3. 正規化された結果を読み取る

    タスクが終了状態になるまでポーリングしてから data.results.items を読み取ります。next_cursor は保存済み結果のページネーションにのみ使用します。

公開Rednoteノートを検索

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 success

Rednote 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つのワークフローに集約し、ブランド、クリエイター、トピックの追跡やクロスプラットフォームのモニタリング・分析をより効率的に行えます。