Xiaohongshu API：公式プラットフォーム、GitHubのスクリプト、呼び出しごとの課金のどれを選ぶか

「xiaohongshu api」や「rednote api」で検索する人の多くは、ほかのアカウントの公開投稿やコメントを取得したいと考えています。2026年11月4日時点で、Xiaohongshuの公式オープンプラットフォームはその機能を提供していませんでした。アカウントプラットフォームで公開されている権限スコープはbasic_infoの1つだけで、フィールドはニックネーム、アバター、性別、地域の4つです。ノートを読み取るスコープは、いまも「予定」と表示されています（スコープ一覧）。あわせて、GitHubで人気のオープンソーススクレイパー9件も調べました。

これらのリポジトリには直近90日間で92件の新規issueが寄せられ、そのうち31件はログインの不具合、リクエストのブロック、ページ構成の変更を報告するものでした。続いて、EveryInfra経由でAPIを実際に9回呼び出し、料金を支払いました。1回あたりの料金は$0.005556です。検索結果の1ページで20件の投稿が返されたため、1,000投稿あたり$0.278になります。結果が空の場合やパラメータが不正な場合は課金されません。

この記事では、Xiaohongshuのデータを取得する3つの方法を比較します。1つ目は公式のオープンプラットフォーム、2つ目は自分のログイン情報で動かすオープンソーススクリプト、3つ目はリクエストごとに課金するサードパーティのデータAPIです。

最初の2つの方法については、公式の開発者向けドキュメント、GitHubの公開データ、公開issueといった公開資料だけを使いました。3つ目の方法には自社のAPIであるEveryInfraを使い、各レスポンスに記載された実際の課金額を掲載しています。ほかのサードパーティサービスの名前は挙げていません。サードパーティの料金を比較するセクションで計算式を紹介しているので、どの料金表でもご自身で換算できます。

結論：各ルートでできること、できないこと

3つのルートは、同じものに対する3通りの価格ではありません。取得できるデータがそもそも異なります。公式プラットフォームが対象とするのは、自分のアプリへのログイン、自社ショップの注文、自社の広告レポートです。他人の投稿を検索したり、他人のコメントを読み取ったりするエンドポイントはありません。

GitHubのスクリプトは、あなたのログイン情報を使ってブラウザのように動作するため、ブラウザで見られる内容のほとんどを読み取れます。そのため、何をいつまで読み取れるかは、あなたのアカウントと、その時点でのサイトの状態に左右されます。従量課金APIは、同じ作業を通常のHTTPリクエストに置き換えます。リクエストごとに料金が発生し、取得できるデータと1ページあたりの行数は、提供元が公開カタログに記載しているとおりです。

見落とされがちなのは1行目です。よくある計画は「まず公式APIを申請し、断られたら他を探す」というものです。しかし現在、公開コンテンツに関わるスコープであるuser_profile、read_notes、read_followersはすべて開放されていません。アプリが承認されても、取得できるのはログインしたユーザーのニックネームとアバターだけです。以降のセクションでは各ルートを取り上げ、それぞれの主張に原文または当社のテストデータを添えています。

Xiaohongshuに公式APIはあるのか？4つの窓口とそれぞれの用途

はい、しかも1つではありません。窓口ごとに用途が異なります。2026年11月4日、当社はXiaohongshuの公開されている開発者サイトをすべて確認し、それぞれの対象、利用条件、取得できるデータをまとめました。

アカウントプラットフォームは最も新しい窓口です。トップページによると、標準のOAuth 2.0でアプリに小紅書ログインを導入できます（開発者ポータル）。クイックスタートガイドによると、新しいアプリの審査には約1〜3営業日かかります。また、現在公開されているスコープはbasic_infoのみとされています（クイックスタート）。スコープのページには5つのスコープが掲載されています。

ステータスが「公開」なのはbasic_infoだけです。残りの4つは「予定」で、write_notesには手動審査が必要で特別なケースにのみ公開するとも記載されています（スコープ一覧）。APIリファレンスには11個のエンドポイントがあり、すべてトークンとログインに関するものです。ステータスの確認、トークンの取得と更新、ユーザーの基本情報の取得、アクセスの取り消し、車載画面やWebページ向けのQRコードログインを行います。このページの最終更新日は2026年8月19日で、リフレッシュトークンの有効期間は180日とされています（APIリファレンス）。

ECオープンプラットフォームは、ショップ運営者にはおなじみの窓口です。開発者の役割は2種類あります。ソフトウェアベンダーは、多数の小紅書ショップ向けに注文管理、商品管理、ERPなどのツールを開発し、サービスマーケットにアプリを掲載します。自社開発者は、自社ショップ専用のツールだけを開発します。参入条件は厳格です。ベンダーは中国本土で登記された、設立後1年を超える法人で、事業範囲に技術開発または技術サービスを含んでいる必要があります。

個人ショップは自社開発者として登録できません（開発者ロールガイド（プラットフォームドキュメントのサードパーティミラー））。認可ガイドによると、アプリを認可できるのはメインのショップアカウントのみです。有効期間は認可コードが10分、アクセストークンが7日、リフレッシュトークンが14日です（ベンダー向け認可フロー）。

業務APIの呼び出しはすべて1つのゲートウェイアドレスに送られます。各呼び出しには、appId、timestamp、version、method、アプリシークレットから生成したMD5署名を付与します（署名方式）。この窓口は、ショップと自社システムを連携させるためのものです。データの範囲は、認可したショップに限られます。

トークンのルールを見ると、各窓口の範囲がいかに狭いかがわかります。公開されている有効期間を並べました。

3つ目の窓口は、広告向けMarketing APIです。スタートガイドによると、このAPIは、すでにプラットフォームで広告を出稿していて、API利用の経験がある重点業界のクライアント向けです。プラットフォームの営業担当者が開発者登録の手続きを開始します（Marketing APIスタートガイド）。提供されるのは自社の広告アカウントのレポートとキャンペーン管理で、オーガニック投稿は対象外です。

4つ目の窓口はシェアプラットフォームで、他のアプリ向けに「ワンタップシェア」と「クイック投稿」を提供していました（シェアプラットフォーム）。2025年11月には、ある開発者が、このページには新規登録ボタンがなく、新規登録が一時停止中と表示されていると投稿しています（フォーラム投稿）。2026年11月4日に私たちが確認した時点でも、新規登録の導線はありませんでした。このほか、小紅書内で動作するアプリ向けのミニプログラムプラットフォーム（ミニプログラムプラットフォーム）もありますが、こちらもコミュニティのコンテンツは読み取れません。

公式プラットフォームでは得られないもの

4つの窓口をまとめると、結論はシンプルです。公式APIは内向きです。対象は自分のアカウント、自社のショップ、自社の広告に限られます。4つの窓口のいずれにも、すべての投稿の検索、任意のコメントの読み取り、任意の公開プロフィールの閲覧を行うサードパーティ向けエンドポイントは記載されていません。スコープのページでは、read_notesとread_followersはまだ「予定」のままです。

中国本土以外の読者に関係する文書がもう1つあります。中国本土以外で登録したユーザーはRedNoteのユーザーです。RedNoteのユーザーには2026年6月9日施行のRedNote利用規約が適用され、運営者はRednote Technology Pte. Ltd.です（RedNote利用規約）。両方の規約が自動化された読み取りについて何を定めているかは、後述のコンプライアンスのセクションで説明します。

つまり、「rednote api」という問いへの答えは、「xiaohongshu api」という問いへの答えと同じです。どちらのバージョンにも、公開コンテンツを読み取る公式APIはありません。

つまり、「xiaohongshu api」という検索語の裏には、異なる2つのニーズがあります。自社アプリのログイン機能、自社ショップとの連携、自社の広告アカウントのレポートが必要なら、公式の窓口を使ってください。その場合、この記事はここまで読めば十分です。競合の追跡、ブランドのモニタリング、商品リサーチ、コンテンツのトレンド把握が必要な場合、現時点では公式の窓口は役に立ちません。選択肢はスクリプトかサードパーティのAPIです。

どちらを選ぶにしても、法的な制限を正しく把握しておく必要があります。これについては後述のコンプライアンスのセクションで説明します。クリエイターマーケットプレイスのAPIについてもよく質問されます。中国のフォーラムで、ある開発者は、自分のCookieを使えばそのページのエンドポイントを呼び出せると書いていました。同じスレッドで別の開発者は、返ってきたのは最初の数件の厳選コメントだけで、ページングは機能しなかったと書いています（フォーラムスレッド）。この方法もページのエンドポイントで自分のログイン情報を使うため、次のセクションで扱うスクリプト方式に該当します。

GitHub上のXiaohongshu API：人気リポジトリ9件を調査

オープンソースのスクリプトは、無料でコードを読めるため、多くの開発者が最初に選ぶ手段です。「スクリプトはよく壊れる」と印象だけで書くことを避けるため、2026年11月4日00:19:50（シンガポール時間）にGitHub APIを使ってGitHub上のリポジトリを抽出しました。ルールはシンプルです。GitHubでxiaohongshu、xhs spider、およびアプリの中国語名を検索し、クエリごとにスター数の上位30件を取得して重複を除外しました。

次に、データ取得を主な目的とするリポジトリだけを残しました。具体的には、クローラー、リクエストラッパー、MCPサーバー、コマンドラインツール、ダウンローダーです。投稿の公開だけを行うツール、画像を生成するツール、多数のサイトから動画をダウンロードするツールは除外しました。条件を満たしたのは9件です。「Issue数（90日間）」は、2026年8月6日から11月4日までに作成されたIssueの数で、プルリクエストは含みません（GitHub Issues API）。

各Issueのタイトルを読み、手作業で4つのグループに分類しました。グループ1は、ログイン、Cookie、QRコード、セッションの失敗です（10件）。グループ2は、認証チェック、検索の制限、リクエストのブロックです（3件）。グループ3は、ページやエンドポイントの変更後に、読み取り、パース、自動化の処理が失敗またはタイムアウトしたものです（18件）。

残りの61件は、機能リクエスト、インストールの問題、セキュリティに関するお知らせ、宣伝目的の投稿、または内容がはっきりしないタイトルです。タイトルは実態を正確に表しているとは限りません。たとえば、タイトルが「問題」の一語だけのIssueが3件あり、これらは「その他」に分類しました。そのため、31件は下限値です。

これらの数字は、Issueの多いプロジェクトが悪いという意味ではありません。むしろ逆で、多くの人が使い、メンテナーが活発に活動しているからこそIssueが多くなります。xiaohongshu-mcpには30日間で35件のコミットがありました。最近のIssueには、「ログインできない」（#880、10月23日）や「検索が制限されているが、スマホアプリでは使える」（#877、10月21日）があります。あるユーザーは、プラットフォームがこのツールの利用を認めているのかを直接尋ねていました。

同じユーザーは、このツールのせいで自分の投稿のリーチが下がることはないかとも尋ねていました（#878、10月22日）。XHS-DownloaderのIssue#497（10月17日）は、典型的なページ変更の例です。Webページ内のサーバーサイドのデータが新しい構文を使うようになり、パーサーが動かなくなりました。同じリポジトリの#479では、サイトの防御機構が作動しないようにクロールを遅くする設定が求められています。Spider_XHSのIssue#191（10月10日）のタイトルは、単に「Cookieが無効または期限切れ」となっています。

もう1つのリスクは、誰もメンテナンスしていないプロジェクトです。ReaJason/xhsは、XiaohongshuのWebサイト向けのリクエストラッパーです。最終コミットは2025年7月1日で、490日前です。xiaohongshu-cliは2026年3月21日で更新が止まっています。新しいIssueがないからといって、コードが動作しているとは限りません。

ユーザーが離れてしまったことを示している場合もあります。日次のジョブに使うスクリプトを選ぶ前に、3つの点を確認してください。まず、最終コミットの日付を確認します。次に、先月のIssueを読み、ログイン、期限切れ、パースに関するエラーがないか確認します。最後に、メンテナーの返信の速さを確認します。

スクリプトの実際のコスト：ログイン、署名、RedNote版との分岐、ライセンス

1つ目のコストはログインです。人気のスクリプトのほとんどは、ログインしてCookieを保存するよう求めます。xiaohongshu-mcpのREADMEには、1つのアカウントで複数のWebクライアントにログインしたままにはできないと太字で書かれています。別のWebクライアントでログインすると、ツール側はログアウトされます。作者は、実名認証をしていない新規アカウントでは認証チェックが発生するとも警告しています（xiaohongshu-mcp README）。

xiaohongshu-cliのあるユーザーは、#82で、ツールが7日ごとに再ログインを強制すると不満を述べています。ログインの有効期限が切れるとスケジュールされたジョブは停止し、次のレポートが空になって初めて気づくことも少なくありません。アカウント自体にもリスクがあります。ユーザー規約の第2.3項では、アカウントは所有者本人のみが使用できると定めています。第三者への譲渡は無効で、プラットフォームはリスクがあると判断したアカウントをブロックできます（ユーザー規約）。スクリプトを動かすアカウントは、いつ失ってもおかしくないものとして扱ってください。

2つ目のコストはリクエスト署名です。Xiaohongshuのウェブエンドポイントへのリクエストには、x-sやx-s-commonなどの署名ヘッダーが付きます。エンドポイントによっては、さらにもう1つアンチボット用のヘッダーが必要です。この作業だけを扱うリポジトリがいくつも存在します。xhshowのREADMEによると、このツールはx-s、x-s-common、x-rap-paramの各ヘッダーを生成します。さらに、フィード、検索、投稿のエンドポイントには追加のx-rap-paramヘッダーが必要だと書かれています（Cloxl/xhshow）。

MediaCrawlerは別のアプローチを取っています。ログイン状態をPlaywrightのブラウザに保持し、そのブラウザ内でJavaScriptを実行して署名の値を取得します。READMEによると、検出されるリスクを下げるため、ユーザーがすでに使っているChromeに接続します（MediaCrawler README）。どちらのアプローチにも共通の弱点があります。署名方式が変わると、それに依存するすべてのスクリプトが一斉に動かなくなります。これが、前述の18件の不具合の一因です。

3つ目のコストは、中国国外の読者にとって最も重要な、XiaohongshuとRedNoteの分離です。xiaohongshu-mcpのIssue #579がこの点を説明しています。2025年12月8日より後に中国以外の電話番号で登録したユーザーは、RedNoteユーザーになります。ウェブセッションの接続先はrednote.comとなり、Cookieのドメインには.rednote.comが使われます。

xiaohongshu.comのCookieしか読み込まないスクリプトでは、「ログインしていません」と表示され続けます。これはユーザー規約の内容とも一致しており、規約では中国本土のユーザーとRedNoteのユーザーにそれぞれ別の規約が適用されています。たとえば、シンガポール、ロンドン、ニューヨークのチームが2026年に現地の電話番号でアカウントを開設した場合、多くのチュートリアルは使えません。

2種類のアカウントには異なるルールが適用されます。次の表は、Issueと2つの規約から得た事実をまとめたものです。

4つ目のコストはライセンスで、多くの人が見落としています。MediaCrawlerのライセンスは「NON-COMMERCIAL LEARNING LICENSE 1.1」です。このライセンスでは、ソフトウェアの用途は学習と研究に限られています。大規模なクローリングや、プラットフォームの運営を妨げる目的には使用できません。商用利用には著作権者の書面による同意が必要です（MediaCrawlerのライセンス）。

Spider_XHSとxiaohongshu-cliは、GitHub上でライセンスを明記していません。GitHubの説明によると、ライセンスがない場合、作者がすべての権利を保持します。他の人にはコードを使用、変更、共有する許可がありません（ライセンスに関するGitHubのドキュメント）。このコードを製品やクライアントへの納品物に組み込む企業は、法務チームとの調整に苦労することになります。

リクエストごとに課金されるXiaohongshuスクレイピングAPI：検証結果

3つ目の方法は、リクエストごとに課金されるデータAPIです。HTTPリクエストを送ると、プロバイダーが構造化データを1ページ分返し、リクエストごとに料金を支払います。私たちは2026年11月4日のシンガポール時間00:14から00:20まで、EveryInfra経由で実際に呼び出しを行いました。Xiaohongshuの6つのアクションを、9回の有料呼び出しで実行しました。また、3件のリクエストを意図的に失敗させました。ほかに4件のリクエストがレート制限（429）に達しましたが、再送すると成功しました。

最初に、無料カタログでパラメータと価格を確認しました（カタログ、シンガポール時間00:13に確認）。Xiaohongshuには17のアクションがあります。そのうち16は1回の呼び出しあたり$0.005556で、クリエイターマーケティング向けのランキング1つが$0.016です。検索、ユーザーの投稿、商品検索は1ページ20件、コメントは15件、返信は10件を返します。ページトークンの有効期間は24時間です。

9回の呼び出しにかかった料金は合計$0.061115で、課金単位数は11でした（3件の投稿をまとめたバッチは3単位として数えます）。

課金額は、カタログ上のページサイズではなく、実際に返った件数で割っています。そのため、19件を返した呼び出しは1件あたりがわずかに高くなります。最も差が大きいのは投稿詳細です。料金は検索と同じ$0.005556ですが、検索が20件の投稿を返すのに対し、詳細の呼び出しは1件しか返しません。1件あたりでは詳細が20倍高くなります。一括分析では、検索結果にすでに含まれるフィールド（タイトル、本文の抜粋、いいね数、保存数、コメント数、日付、投稿者）を使い、詳細アクションはそれ以上が必要なときだけ呼び出してください。

中国以外の読者にとって、英語キーワードのテストは詳しく見る価値があります。ほかのフィルターは付けずに「Singapore food」で検索しました。検索結果には19件の投稿が含まれていましたが、タイトルに英単語を含むものは4件だけでした。残りは中国語で、プラットフォームが英語のクエリを同じトピックの中国語コンテンツと照合していることがわかります。19件のうち、公開から30日未満の投稿は3件だけで、投稿経過日数の中央値は242日でした。

これは、デフォルトの並び順が関連度順で、定番のガイド記事が上位に表示されるためです。コメント数が最も多い投稿（412件）は、2025年9月に投稿された、食事が高すぎるという不満でした。2026年1月の安いドリアンに関する投稿のコメントは80件でした。あるトピックの今週の動向を見るには、sortをnewestに設定するか、date_rangeを追加してください。これらを指定しないと、主に古いガイド記事を読むことになります。

2つのキーワードの結果は大きく異なります。どちらもデフォルトの並び順で検索しました。

テストではさらに4つの点がわかりました。1つ目は、ページングで実際に次の結果へ進めることです。2ページ目には、1ページ目と重複する投稿が1件もありませんでした。40件の投稿のうち、公開から30日未満のものが21件、7日未満のものが12件で、最も古い投稿は公開から231日経過していました。2つ目は、詳細の呼び出しが投稿をリアルタイムで再取得することです。ある投稿のコメント数は、検索結果では231件でしたが、2秒後の詳細の呼び出しでは232件でした。詳細にはさらに、IP所在地、8個のトピックタグ、10枚の画像からなるリストも含まれます。

3つ目に、返信の取得には別の呼び出しが必要です。1ページ目の上位コメント15件には合計53件の返信があると示されていましたが、各コメントにインラインで含まれていた返信は1件だけでした。スレッド全体を取得するにはxiaohongshu/sub_commentsを呼び出してください。4つ目に、comments_batchは投稿ごとに課金されます。3件の投稿で$0.005556の3倍かかるため、コメント1件あたりの料金は個別に呼び出した場合と同じです。バッチを使うと、リクエスト数を減らし、レート制限の枠を節約できますが、料金は安くなりません。

接続方法：curl、レスポンスフィールド、MCP

最もシンプルな接続方法は、1回のPOSTリクエストです。以下は表にある英語キーワード検索の例です。APIキーはコードに書かず、環境変数に保存してください。

curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"Singapore food","sort":"newest","date_range":"last_7_days"}}'
# Next page: copy next_page_token into params.page_token. For slow jobs add "mode":"async" and poll the job_id.

レスポンスフィールドは、カタログのresponse_fieldsリストと一致します。以下の表は、今回使ったフィールドのグループとテストで確認した内容です。

AIクライアントからは、EveryInfraをリモートMCPサーバーとして利用できます。MCP（Model Context Protocol）は、AIクライアントから外部ツールを呼び出せるようにするオープンプロトコルです（仕様）。ツール名はすべてeveryinfra_で始まります。次のブロックをクライアントに追加すれば、すぐに使い始められます。

{
  "mcpServers": {
    "everyinfra": {
      "url": "https://api.everyinfra.com/mcp",
      "headers": { "Authorization": "Bearer ${env:EVERYINFRA_API_KEY}" }
    }
  }
}

あとは普段の言葉で依頼できます。「Xiaohongshuで、過去7日間のシンガポールのホーカーフードに関する投稿を検索して。コメントが20件を超えるものを残して、各投稿についてコメントを1ページ取得して。不満が出ている料理を一覧にして。」アクションページとプレイグラウンドはXiaohongshuデータAPIと検索にあります。MCPのセットアップ確認はリモートMCPのセットアップに、Xiaohongshuのツール一覧はXiaohongshu MCPにあります。

失敗、空の結果、レート制限：課金されないケース

呼び出しごとの課金で一番怖いのは、何も得られないのに料金を払うことです。そこで3件のリクエストを意図的に失敗させました（空の結果、不正なパラメータ、キーなし）。さらに4件のリクエストがレート制限（429）に達しました。この7件はどれも課金されませんでした。

空の結果が返るまでに29秒かかりました。レスポンスはcountが0、reasonがempty_result_refundedで、課金はされていません。422エラーには許可される値が列挙されるため、AIモデルがAPIを呼び出す場合に役立ちます。

モデルはdid_you_meanを読み取り、自分でリクエストを修正します。

レート制限はアカウント単位でカウントされ、アカウント内のすべてのAPIキーで共有されます。そのため、APIキーを増やしても上限は増えません。アカウントの上限は、これまでのチャージ総額によって決まります（料金）。

4件の429レスポンスは想定外でした。テスト用APIキーには、独自に1分あたり10回の上限が設定されていました。00:14:59から00:15:48までに私たちが送信したのは4回だけなので、同じAPIキーを他のテストが同時に使っていたことになります。

429レスポンスにはいずれも「Nothing was charged」と記載され、5〜17秒のretry_afterが返されました。77〜147秒後に4件のリクエストを再送したところ、4件とも通常の$0.005556で成功しました。定期ジョブでは、retry_afterの分だけ待ってから再試行し、各実行にキュー待ちの時間を見込んでおいてください。課金と返金を照合する方法の全体は、失敗時の返金の照合を参照してください。

Xiaohongshu APIの料金：TikTokの10倍なので予算は別枠に

率直に言います。当社のカタログで最も高額なソーシャルプラットフォームはXiaohongshuです。各プラットフォームで利用可能なすべてのアクションの価格の中央値をとったところ、Xiaohongshuは1回あたり$0.005556でした。

TikTok、YouTube、Instagram、Bilibili、Redditは$0.000556で、ちょうど10分の1です。Douyin、Kuaishou、Weibo、Zhihu、Xは$0.000806で、Xiaohongshuはその6.9倍です。TaobaoとJDは$0.001389で、Xiaohongshuはその4倍です。Xiaohongshuより少し高いのはAmazonだけで、中央値は$0.006875です。

Xiaohongshuのカタログ価格は、他のプラットフォームの4〜10倍です。最新の価格は料金ページで確認できます。予算に換算すると、月$10で、$0.005556のXiaohongshuなら約1,800回、TikTokの中央値$0.000556なら約18,000回呼び出せます。

つまり、同じ予算で実行できるXiaohongshuのリクエスト数は、TikTokの約10分の1です。1つのプロジェクトで両方のプラットフォームを扱う場合は、同じ単価で見積もらないでください。TikTokの価格はTikTokデータAPIのページに掲載しています。また、次のセクションで扱う呼び出し回数の減らし方は、他のプラットフォームよりもXiaohongshuで重要になります。

呼び出し回数を減らす方法：5つの習慣と1か月分の請求額

第1に、詳細より先に一覧を使います。検索とユーザーの投稿は1ページ20件で、タイトル、抜粋、いいね数、保存数、コメント数、日付、リンクを返します。並べ替えや絞り込みの多くは、これだけで足ります。

xiaohongshu/noteを呼び出すのは、IP所在地、トピックタグ、全文が必要なときだけにします。詳細1件のコストは一覧1件の20倍です。第2に、コメントを取得する前にコメント数を確認します。40投稿のサンプルでは、コメント数の中央値は14で、20件以上あったのは18投稿だけでした。

コメントが0件の投稿でコメントを取得すると、空の結果が返ります。無料ですが、レート制限の枠は1回分消費します。3つ目は、全件を取り直すのではなく時間フィルターを使うことです。日次ジョブなら、sortをnewest、date_rangeをlast_24_hoursまたはlast_7_daysに設定し、新しい投稿だけを処理できます。

4つ目は、返信スレッドを必要なときだけ開くことです。各コメントの返信数はsub_comment_countでわかるので、返信の多いコメントだけを展開します。5つ目は、ジョブの実行頻度をビジネス上必要な分に抑えることです。競合レポートの多くは週1回で十分です。

この表はカタログ価格の$0.005556で計算しています。コメントが20件以上ある投稿の割合（40件中18件）は、当社のサンプルに基づきます。これは見積もりであり、請求額ではありません。

割合はキーワードによって変わります。同じモニタリングでも、月額は$70.01から$4.44に下がり、15.8分の1になります。この削減は単価の引き下げではなく、呼び出し回数の削減によるものです。ここではリクエスト単位の料金体系が役立ちます。すべての呼び出しが見えるので、削減ごとの節約額を事前に計算できます。

2つ目の習慣を、同じ日焼け止めの検索で得た40投稿で詳しく見ていきます。これらの投稿のコメントは合計1,177件でした。コメント0件が11投稿、20件以上が18投稿で、最も多い投稿は231件でした。表では、カタログ価格の1ページ$0.005556、1ページ15件のコメントで計算しています。

最後の行では、1,000コメントあたり$0.444です。1ページ目の$0.370より高いのは、投稿の最終ページではコメント数が上限に達しないことが多いためです。

まずは、本当にすべてのコメントが必要かを判断してください。意見のタグ付けなら、各投稿の上位15件のコメントで足りることがよくあります。ブランド名に言及しているコメントの割合など、全コメントに占める割合が必要な場合にのみ、全ページを取得してください。1件の投稿についても同じ方法で見積もれます。詳細取得の呼び出しで232件のコメントが確認された投稿には、16ページ分の取得が必要で、料金は$0.0889です。

返信も同じ考え方です。1ページにある上位15件のコメントには合計53件の返信が記録されており、各コメントにはすでに1件の返信がインラインで含まれていました。残りの返信をすべてxiaohongshu/sub_comments（1ページ10件）で開くには、14回の呼び出しで$0.0778かかります。返信が5件以上ある4件のコメントだけを開けば、4回の呼び出しで$0.0222です。70%以上の削減になり、最も活発なスレッドは確保できます。

最後に、所要時間も考えましょう。テスト用APIキーの上限は1分あたり10回です。この速度では、全投稿のコメントを取得する日次プランは1日420回の呼び出しが必要で、キューでの待ち時間は42分になります。コメントの多い投稿だけからコメントを取得する週次プランは、1回の実行につき200回の呼び出しが必要で、所要時間は20分です。アカウントの上限はこれまでのチャージ総額によって決まるため、料金ページを確認してください。上限にかかわらず、呼び出し回数を減らせば、キューでの待ち時間とレート制限エラーも減ります。

他社の料金の比べ方：1つの計算式と6つの質問

サードパーティのサービスの多くはリクエストごとに課金しますが、価格の示し方はさまざまです。呼び出し単位、件単位、クレジット単位で課金するものがあり、月額料金や開始料金を加えるものもあります。比較には1つの式を使ってください。1,000件あたりの価格=1リクエストあたりの価格÷1リクエストで実際に返る件数×1,000です。

架空の例で説明します。1回の呼び出しが$0.01で10件を返すサービスは、1,000件あたり$1.00です。同じ$0.01で20件なら$0.50です。つまり「1回の呼び出しあたりの価格」だけではほとんど何もわかりません。1ページで何件返るかを確認し、できれば1回呼び出して数えてください。この式で計算すると、当社のXiaohongshu検索は投稿1,000件あたり$0.278、コメントは1,000件あたり$0.370です。

見落とされがちなのは2行目、3行目、4行目です。まれなキーワードや、ときどき不正なパラメータを送るAIクライアントがあると、失敗のコストも月額請求の一部になります。当社のテストでは、データが返らなかった7件のリクエスト（意図的な失敗3件とレート制限4件）はすべて$0でした。これらの行の項目を確認したうえで、自分で1回呼び出して件数を数えてください。価格とルールは料金ページに掲載しています。

コンプライアンスの基本：データ利用者向けの法令、プラットフォーム規約、実務上の注意点

本記事は法的助言ではありません。法律とプラットフォーム規約の要点をまとめています。ご自身の利用については弁護士にご相談ください。中国では、Xiaohongshuのデータに直接関係する法令が3つあります。

個人情報保護法第27条は、公開された個人情報を対象としています。本人が自ら公開した情報、またはすでに適法に公開されている情報については、「合理的な範囲内」での処理を認めています。ただし、本人が明確に拒否している場合は適用されません。処理が本人に重大な影響を及ぼす場合は同意が必要です（個人情報保護法）。

ネットワークデータセキュリティ管理条例第18条は、ネットワークデータへのアクセスや収集を行う自動化ツールを対象としています。こうしたツールの利用者は、ネットワークサービスへの影響を評価しなければなりません。また、他のネットワークに侵入したり、サービスの正常な運用を妨げたりしてはなりません（条例本文）。本条例は2025年1月1日から施行されています（司法部）。

2025年に改正された反不正当競争法では、第13条第3項が新設されました。事業者は、他の事業者が適法に保有するデータを、詐欺や強要によって取得・使用してはならないと定めています。また、そのために技術的な管理措置を回避・破壊してもなりません。改正法は2025年10月15日に施行されました（反不正当競争法（2025年））。

プラットフォームの規約も2種類適用されます。Xiaohongshuのユーザー規約は2026年3月23日に更新されました。第3.4条と第4.1条では、書面による許可なくプラットフォームのコンテンツを閲覧・集計・商用利用することを制限しています。また、スクレイピングやダウンロードを模した行為も制限しています。

第2.3条では、アカウントを他人に貸与することも制限しています（ユーザー規約）。中国本土以外のユーザーには、2026年6月9日からRedNoteの規約が適用されます。この規約でも、データの自動抽出が制限されています（RedNote利用規約）。ご自身の利用がこれらの制限に該当するかどうかは、弁護士にご相談ください。

中国の裁判所は、プラットフォームデータを無断で大規模に収集・転売した事件で損害賠償を認めています。一般に、裁判所が検討するのは、収集者が技術的な管理措置を回避または破壊したか、散在していた記録を転売目的の大規模なデータセットにしたか、個人情報や非公開の機能に触れたか、プラットフォームの正常な運用に支障が生じたか、という4点です。

どのルートを選ぶ場合でも、データを利用する側は少なくとも次の点を守ってください。

• ブランドのソーシャルリスニングや製品リサーチなど、適法かつ明確な目的にのみデータを使用してください。目的は文書に残し、変更する前には改めて確認してください。
• プラットフォームの規約と、事業を行う地域の法律に従ってください。商用目的の転売やコンテンツの一括ダウンロードなど、規約で制限されている利用を行う前には、弁護士にご相談ください。
• 個人情報は最小限にとどめてください。コメント内のニックネーム、アバター、IP所在地も個人情報として扱ってください。分析に使わないフィールドは保存しないでください。可能な場合は、個々の行ではなく集計値を保持してください。データの保存期間とその理由を記録してください。
• 生データを転売しないでください。クライアントには生データ一式ではなく、分析結果や集計表を提供してください。また、生データの各行をそのまま公開しないでください。
• 分析に必要なデータだけを取得し、古い生データは定期的に削除してください。
• プライベートメッセージ、非公開アカウント、その他公開されていないコンテンツにはアクセスしないでください。データを使ってユーザーに一斉メッセージを送信しないでください。

これらの実践事項は、「呼び出し回数を減らす方法」セクションで紹介した習慣にも通じます。分析に使うデータだけを取得すれば、費用を抑えられ、保存・保護すべきデータも少なくなります。

用途別：どの方法を選ぶべきか

自社アプリを開発していて「Xiaohongshuでログイン」を実装したい場合は、アカウントプラットフォームを利用してbasic_infoを申請してください。アプリを作成し、コールバックアドレスを設定して、1〜3営業日の審査を待ちます。Xiaohongshuで販売していて、注文やアフターサービスの情報をERPに取り込みたい場合は、ECオープンプラットフォームを利用してください。開発者がいる場合は「自社開発」を選び、それ以外の場合はサービスマーケットでベンダーを探してください。広告を出稿していてレポートを一括で取得したい場合は、Marketing APIを利用できるよう、プラットフォームの営業担当者に依頼してください。これら3つの用途では、いずれもサードパーティは不要であり、利用すべきでもありません。

他者の動向を把握することが目的の場合、現時点では公式の窓口は役に立ちません。たとえば、競合の投稿数やエンゲージメント、特定トピックに関するユーザーの意見、商品の推薦、プラットフォーム上でのブランドイメージなどです。選択肢はスクリプトかサードパーティAPIです。小規模な作業、不定期の作業、学習目的であれば、オープンソースのスクリプトで十分です。失っても構わないアカウントを使い、ライセンスを確認してください。毎日の定期処理、クライアントへの納品、AIクライアントが自律的にデータを呼び出す用途であれば、呼び出しごとに課金されるAPIのほうが手軽です。

「呼び出し回数を減らす方法」セクションの習慣で呼び出し量を抑え、コンプライアンスのセクションの実践事項に従ってください。これは海外ブランドにとっても重要です。Inside Retail Asiaが2026年10月12日に公開したレポートによると、ユーザーはこのアプリを検索エンジンのように使っています（Inside Retail Asia）。

そのため、ブランドにとってはフォロワー数よりもキーワードリサーチのほうが多くの示唆を得られるのが一般的です。さらに詳しくは、2本の関連記事をご覧ください。Xiaohongshuのデータエクスポートとスナップショット分析では、検索データとコメントデータをスナップショットとして保存する方法を紹介しています。Xiaohongshuのコメントを一括取得では、コメントを一括取得する手順をすべて説明しています。

業界ニュース（2026年10月〜11月）

• 2026年11月3日：当社のサンプル取得の前日、MediaCrawler、xiaohongshu-mcp、XiaohongshuSkillsのいずれにも新しいコミットがありました。直近30日間のコミット数はそれぞれ11件、35件、32件です。ReaJason/xhsは依然として2025年7月1日で更新が止まっています（GitHub API、シンガポール時間2026年11月4日00:19:50に取得）。ポイント：アクティブなツールは常に変化するため、それに合わせて更新し続ける必要があります。更新が止まったツールは定期実行ジョブには向きません。
• 2026年10月21〜23日：xiaohongshu-mcpでは、同じ週のうちに「ログインできない」「検索が制限される」という問題が報告されました。11月1日にはメンテナーが検索時の待機処理と投稿フローに関する修正をマージし、11月3日にはログイン失敗後のブラウザクリーンアップに関する修正が続きました（コミット履歴）。ポイント：ログインに依存するツールは数週間ごとに修正が必要になるため、定期実行ジョブでは失敗時にアラートを出す必要があります。
• 2026年10月17日：サイトのWebページでサーバーサイドデータの形式が変更されました。13,000超のスターを獲得しているダウンローダーXHS-Downloaderは、修正されるまで投稿を解析できなくなりました（issue 497）。ポイント：ごく普通の平日に行われたページ変更でも、そのページを読み取るすべてのスクリプトが止まる可能性があるため、修正対応の時間を見込んでおいてください。
• 2026年8月19日：アカウントプラットフォームのAPIリファレンスが更新されましたが、公開されているのは依然としてbasic_infoのみです（APIリファレンス）。ポイント：ノートを取得する公式の読み取りAPIは、当面は当てにしないでください。

はじめに：1回のテスト呼び出しから週次ジョブまで

ステップ1：EveryInfraで新規登録し、APIキーを作成します。月額料金はなく、チャージした残高に有効期限はありません。手順はクイックスタートをご覧ください。ステップ2：無料のカタログを確認します。次に、アクションページで1回呼び出してみてください。投稿関連のページは検索、投稿詳細、ユーザーの投稿です。

コメント関連のページはコメント、一括コメント、返信です。ショップについては商品検索を使ってください。ステップ3：レスポンスのcharged_usdと件数を確認し、「課金額÷件数×1,000」で自分の1,000件あたりの価格を計算します。次に、「呼び出しを減らす方法」セクションの表を使って月額を見積もります。ステップ4：AIクライアントにMCPブロックを追加し、週に1回キーワードを実行するよう指示します。その他のプラットフォームはデータマーケットに、サービスの稼働状況はステータスページに掲載しています。

FAQ

Xiaohongshuに公式APIはありますか？

この質問は「xiaohongshu api documentation」や「rednote api documentation」といった検索候補から来ています。答えは「はい」ですが、自分自身のデータに限られます。アカウントプラットフォームで公開されているのはbasic_info（ニックネーム、アバター、性別、地域）のみです。ECプラットフォームでは、ショップが企業やベンダーに権限を付与すると、その企業やベンダーは当該ショップの注文と商品を読み取れます。広告APIでは、広告主が自身のレポートを取得できます（スコープ一覧、ショップによる認可）。他人の公開投稿やコメントを読み取る公式APIはなく、read_notesは現在も「計画中」のままです。

XiaohongshuのAPIキーはどうやって取得できますか？

この質問は「xiaohongshu api key」や「rednote api key」という検索候補から来ています。公式の単一の「APIキー」は存在しません。アカウントプラットフォームでは、アプリを作成してapp idとapp secretを取得します。審査には約1〜3営業日かかります（クイックスタート）。

ECプラットフォームでは、認証済みの企業がappIdとappSecretを取得し、その後メインのショップアカウントによる承認が必要です。広告APIでは、営業担当者が登録手続きを開始します。公開投稿を読み取るキーが必要な場合、それはサードパーティサービスのキーになります。EveryInfraでは、新規登録後にコンソールで作成できます。

GitHubにあるXiaohongshuのスクレイパーを商用製品に使えますか？

この質問は「xiaohongshu api github」という検索候補から来ています。ライセンスを確認してください。私たちが調べた9件のうち、MediaCrawlerのライセンスは非商用の学習目的のみを認め、大規模なクローリングを禁止しています（ライセンス）。

Spider_XHSとxiaohongshu-cliはライセンスを明記していないため、すべての権利は作者に留保されます。xiaohongshu-mcpはApache-2.0、XHS-DownloaderはGPL-3.0を採用しています。ライセンスが対象とするのはコードのみで、そのコードで収集したデータは対象外です。そのデータには引き続きプラットフォームの規約と法律が適用されます。

RedNoteアカウントはXiaohongshu向けのスクリプトで使えますか？

この質問は「rednote xiaohongshu api」や「rednote api github」という検索候補から来ています。多くの場合、使えません。xiaohongshu-mcpのIssue #579でこの変更が説明されています。

2025年12月8日より後に中国以外の電話番号で登録されたアカウントはRedNoteアカウントです。Webセッションはrednote.comに移行し、Cookieドメインも変わります。そのため、xiaohongshu.comのCookieのみを読み取るスクリプトは「未ログイン」と報告します。また、RedNoteユーザーには別の規約が適用されます。この規約は2026年6月9日に発効し、自動抽出を禁止しています（RedNote規約）。

XiaohongshuのAPI料金は通常どのように設定されていますか？

この問いは、検索候補の「xiaohongshu api pricing」と「xiaohongshu api pricing reddit」から来ています。公式の窓口では、API自体の料金は示されていません。サードパーティのサービスは通常、リクエスト単位、件単位、クレジット単位で課金し、月額料金を加えるものもあります。比較する前に、価格比較のセクションの式ですべての価格を1,000件あたりの価格に換算してください。EveryInfraでは、Xiaohongshuの17のアクションのうち16が1回の呼び出しあたり$0.005556です。当社のテストでは、検索の投稿1,000件あたり$0.278、コメント1,000件あたり$0.370でした（カタログ）。

参考文献

1. 開発者ポータルのホーム、Xiaohongshuオープンプラットフォーム、2026-11-04閲覧。https://openaccount.xiaohongshu.com/
2. スコープ一覧、Xiaohongshuオープンプラットフォーム、最終更新2026-03-29、スクリーンショット取得2026-11-04。https://openaccount.xiaohongshu.com/docs/scope
3. APIリファレンス、Xiaohongshuオープンプラットフォーム、最終更新2026-08-19。https://openaccount.xiaohongshu.com/docs/api-reference
4. クイックスタート、Xiaohongshuオープンプラットフォーム、最終更新2026-03-29。https://openaccount.xiaohongshu.com/docs/quick-start
5. ソフトウェアベンダー向けの認可フロー、Xiaohongshu ECオープンプラットフォーム。https://open.xiaohongshu.com/document/developer/file/38
6. 署名方式、Xiaohongshu ECオープンプラットフォーム。https://open.xiaohongshu.com/document/developer/file/39
7. 開発者ドキュメント索引、Xiaohongshu ECオープンプラットフォーム。https://open.xiaohongshu.com/document/developer/file/4
8. 開発者ロールガイド、ECプラットフォームドキュメントのサードパーティミラー。https://xiaohongshu.apifox.cn/doc-2811119
9. Marketing API入門ガイド、Xiaohongshu広告プラットフォーム、2024-01-03更新。https://ad.xiaohongshu.com/openApiDoc?categoryId=761&articleId=3047
10. シェアオープンプラットフォームのホーム、Xiaohongshu。https://agora.xiaohongshu.com/index
11. 停止されたシェアプラットフォームに関するフォーラム投稿、V2EX、2025-11-06。https://global.v2ex.co/t/1170874
12. ミニプログラムオープンプラットフォーム、Xiaohongshu。https://miniapp.xiaohongshu.com/
13. Xiaohongshu利用規約、2026-03-23更新。https://agree.xiaohongshu.com/h5/terms/ZXXY20220331001/-1
14. RedNote利用規約、2026-06-09発効。https://agree.xiaohongshu.com/h5/terms/ZXXY20251205003/-1
15. NanmiCoder/MediaCrawler、GitHub、2026-11-04閲覧。https://github.com/NanmiCoder/MediaCrawler
16. MediaCrawler NON-COMMERCIAL LEARNING LICENSE 1.1、GitHub。https://github.com/NanmiCoder/MediaCrawler/blob/main/LICENSE
17. xpzouying/xiaohongshu-mcp、GitHub。https://github.com/xpzouying/xiaohongshu-mcp
18. xiaohongshu-mcpのコミット履歴、GitHub。https://github.com/xpzouying/xiaohongshu-mcp/commits/main
19. xiaohongshu-mcpのIssue 880（ログインできない）、2026-10-23。https://github.com/xpzouying/xiaohongshu-mcp/issues/880
20. xiaohongshu-mcpのIssue 877（検索が制限される）、2026-10-21。https://github.com/xpzouying/xiaohongshu-mcp/issues/877
21. xiaohongshu-mcpのIssue 878（プラットフォームはこのツールを許可しているか）、2026-10-22。https://github.com/xpzouying/xiaohongshu-mcp/issues/878
22. xiaohongshu-mcpのIssue 579（rednote.comユーザーへの対応）、2026-03-13。https://github.com/xpzouying/xiaohongshu-mcp/issues/579
23. JoeanAmier/XHS-Downloader、GitHub。https://github.com/JoeanAmier/XHS-Downloader
24. XHS-DownloaderのIssue 497（サーバー側でのデータ解析失敗）、2026-10-17。https://github.com/JoeanAmier/XHS-Downloader/issues/497
25. XHS-DownloaderのIssue 479（クロール速度を落とす設定）、2026-09-15。https://github.com/JoeanAmier/XHS-Downloader/issues/479
26. cv-cat/Spider_XHS、GitHub。https://github.com/cv-cat/Spider_XHS
27. Spider_XHSのIssue 191（Cookieが無効または期限切れ）、2026-10-10。https://github.com/cv-cat/Spider_XHS/issues/191
28. jackwener/xiaohongshu-cli、GitHub。https://github.com/jackwener/xiaohongshu-cli
29. xiaohongshu-cliのIssue 82（7日ごとにログインを強制される）、2026-08-17。https://github.com/jackwener/xiaohongshu-cli/issues/82
30. ReaJason/xhs、GitHub。https://github.com/ReaJason/xhs
31. white0dew/XiaohongshuSkills、GitHub。https://github.com/white0dew/XiaohongshuSkills
32. autoclaw-cc/xiaohongshu-skills、GitHub。https://github.com/autoclaw-cc/xiaohongshu-skills
33. Jamailar/Beav、GitHub。https://github.com/Jamailar/Beav
34. Cloxl/xhshow、リクエスト署名ライブラリ、GitHub。https://github.com/Cloxl/xhshow
35. リポジトリのIssueの一覧表示、GitHub REST APIドキュメント。https://docs.github.com/en/rest/issues/issues#list-repository-issues
36. リポジトリのライセンス、GitHubドキュメント。https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/licensing-a-repository
37. 中華人民共和国個人情報保護法、国家インターネット情報弁公室。https://www.cac.gov.cn/2021-08/20/c_1631050028355286.htm
38. ネットワークデータセキュリティ管理条例（国務院令第790号）、生態環境部サイト掲載の写し。https://www.mee.gov.cn/zcwj/gwywj/202410/t20241003_1087417.shtml
39. ネットワークデータセキュリティ管理条例の公布、司法部、2024-09-30。https://www.moj.gov.cn/pub/sfbgw/gwxw/xwyw/202409/t20240930_507076.html
40. 中華人民共和国反不正当競争法（2025年改正）、国家知識産権局。https://www.cnipa.gov.cn/art/2026/5/20/art_104_206437.html
41. Less shouting, more answering: How brands win on XHS、Inside Retail Asia、2026-10-12。https://insideretail.asia/2026/10/12/less-shouting-more-answering-how-brands-win-on-xhs/
42. V2EXフォーラムのスレッドt/1170609（クリエイターマーケットプレイスのページのエンドポイントに関する返信を引用）、V2EX。https://www.v2ex.com/t/1170609
43. EveryInfraソーシャルデータカタログ（無料で閲覧可能）、2026-11-04 00:13（シンガポール時間）閲覧。https://api.everyinfra.com/api/v1/social/catalog
44. Model Context Protocol仕様（2025-06-18）。https://modelcontextprotocol.io/specification/2025-06-18