プラットフォームの稼働状況
現在、稼働状況データを読み込めないため、このプラットフォームの最近の状況は不明です。利用できないという意味ではありません。
利用可能な機能
Xiaohongshuの各アクションについて、内容、料金、過去24時間の稼働状況を掲載しています。アクションを開くと、パラメータ、レスポンスフィールド、コードサンプルを確認できます。
| 機能 | できること | 1,000リクエストあたり | 24時間の稼働状況 |
|---|---|---|---|
検索search | トピックに関するXiaohongshuのノートを1ページ20件で検索します。タイトル、本文の抜粋、いいね数・保存数・コメント数・シェア数、投稿者、公開日時を取得できます。コンテンツタイプ、並び順、期間で絞り込めます。次のページを取得するには、next_page_tokenをpage_tokenとして送り返してください。検索結果のテキストは抜粋で、ノートの全文ではありません。 | 1,000リクエストあたり$5.56 | — |
プロフィールprofile | Xiaohongshuアカウントを照会します。ニックネーム、Xiaohongshu ID、自己紹介、IP所在地、認証情報に加え、フォロワー数・フォロー数・投稿数・いいね数・保存数の正確な値を取得できます。/user/profile/リンクに含まれるID、リンクそのもの、またはコメント投稿者のauthor_idを渡してください。表示されていない数値は、0ではなくnullで返されます。 | 1,000リクエストあたり$5.56 | — |
ユーザーの投稿user_posts | Xiaohongshuのクリエイターが公開したノートを1ページ20件で一覧表示します。固定されたノートが先頭に来て、その後に残りのノートが新しい順に並びます。抜粋、各種カウント、動画リンクを取得できます。続きはpage_tokenで取得します。ここで返されるリンクにはアクセストークンが含まれず、テキストは抜粋です。ブラウザでそのまま開けるリンクと本文全体が必要な場合は、noteを呼び出してください。 | 1,000リクエストあたり$5.56 | — |
ノート詳細note | Xiaohongshuのノート1件を全文取得します。本文、順番どおりのすべての画像、トピック、メンションされたユーザー、エンゲージメント数、IP所在地を取得できます。画像に座標が含まれている場合は座標も返されます。xsec_tokenを含む完全なノートのリンクをそのまま渡してください。動画の再生リンクとコメントの取得には、別途videoとcommentsの呼び出しが必要です。 | 1,000リクエストあたり$5.56 | — |
動画の詳細video | noteが受け付けるものと同じURLを使って、Xiaohongshuの動画ノート1件の再生リンクと再生時間を取得します。署名付きリンクには有効期限があるため、早めにダウンロードしてください。画像ノートでは空の結果が返され、返金されます。 | 1,000リクエストあたり$5.56 | — |
コメントcomments | Xiaohongshuのノートのトップレベルコメントを1ページ15件で取得します。テキスト、いいね数、IP所在地、コメント投稿者、返信数、投稿者フラグとAIアカウントフラグが含まれます。sortで並び替え、page_tokenでページ送りし、返信そのものはsub_commentsで取得します。 | 1,000リクエストあたり$5.56 | — |
複数URLのコメントcomments_batch | 1回の呼び出しで1〜20件のXiaohongshuノートからコメントを収集します。各行にnote_idとnote_urlが含まれるため、スレッドは混ざりません。すべてのリンクに有効なノートIDとxsec_tokenが必要です。取得に失敗したノートは、コメント0件ではなく取得漏れとして報告されます。 | 1,000リクエストあたり$5.56 | — |
コメントへの返信sub_comments | Xiaohongshuのノートにある1件のコメントへの返信を、1ページ10件で取得します。テキスト、いいね数、IP所在地、各返信の返信先を取得できます。ノートのリンクと、コメントの取得結果にあるcomment_idを渡してください。スレッドを再構成するにはreply_to_idを使用します。 | 1,000リクエストあたり$5.56 | — |
ユーザー検索search_users | キーワードでXiaohongshuのクリエイターとブランドアカウントを1ページ20件で検索します。ニックネーム、Xiaohongshu ID、フォロワー数、認証タイプを取得できます。follower_rangeまたはuser_typeで絞り込めます。フォロワー数は一覧に表示される概数に基づく近似値のため、正確な数値が必要な場合はprofileを呼び出してください。 | 1,000リクエストあたり$5.56 | — |
ハッシュタグhashtag | Xiaohongshuの1つのトピックページにあるノートを、新着順または人気順で閲覧します。全文、すべての画像、エンゲージメント数、動画の詳細を取得できます。24文字のtopic_idまたはトピックのリンクを渡してください。1ページあたり最大20件です。最後のページと判断できるのは、next_page_tokenがない場合だけです。 | 1,000リクエストあたり$5.56 | — |
トレンドtrending | Xiaohongshuが現在おすすめしているノートのサンプルを、タイトル、投稿者、画像、動画フラグとともに最大30件取得します。内容は読み込むたびに変わります。一覧の順位からアルゴリズムを説明することはできず、取得結果を重ねても履歴にはなりません。 | 1,000リクエストあたり$5.56 | — |
商品検索product_search | keywordでXiaohongshuストアの商品を検索します。各商品にはタイトル、価格、定価、通貨、販売数（ページに表示されている場合）、在庫状況、画像、ショップが含まれます。1ページは通常19件（実績では18〜20件）で、next_page_tokenでページ送りします。結果はノートではなくストアの商品で、各idはproduct_detailで使用できます。 | 1,000リクエストあたり$5.56 | — |
商品詳細product_detail | 24文字のIDまたは商品詳細リンクから、Xiaohongshuストアの商品1件を取得します。価格と定価、カテゴリ、バリエーション、在庫、販売数（ページに概数が表示されている場合は下限値）、メイン画像と詳細画像、商品属性を取得できます。ショップについては、評価（ある場合）、総販売数、フォロワー数、紐づくXiaohongshuアカウントを取得できます。 | 1,000リクエストあたり$5.56 | — |
レビューreviews | 24文字のproduct_idで、Xiaohongshuストア商品の購入者レビューをデフォルト順または新着順で取得します。各レビューには全文、5段階評価、サービス評価と配送評価、「参考になった」の票数、返信数、購入者の写真、レビュータグ、購入したバリエーション、レビュー日が含まれます。レビュー投稿者のID、名前、アバターは返されません。1ページ最大20件です。 | 1,000リクエストあたり$5.56 | — |
フォロワー一覧followers_list | 24文字のuser_idまたはプロフィールリンクで、Xiaohongshuアカウントのフォロワーを一覧表示します。各フォロワーにはuser_id、ニックネーム、アバター、プロフィールリンク、フォロワー数、ノート数が含まれます。1ページは通常19〜20人で、next_page_tokenでページ送りします。フォロワーリストを非公開にしているアカウントは多く、その場合は呼び出しが失敗し、返金されます。 | 1,000リクエストあたり$5.56 | — |
ノートの位置情報note_location | ノートのリンクまたは共有リンクから、Xiaohongshuのノートにタグ付けされた場所を取得します。表示どおりの位置情報テキスト、都市、場所名、場所IDを取得できます。場所がタグ付けされていないノートでは、空の結果が返されます。 | 1,000リクエストあたり$5.56 | — |
Pugongyingのコンテンツボードpgy_content_square | XiaohongshuのブランドとクリエイターをつなぐマーケットプレイスPugongyingで、コンテンツ広場の人気コンテンツランキングを取得します。総合人気ノート、商品シーディング、EC販促、ブランドコラボ、リード獲得などのランキングを3〜30日の期間で取得できるほか、キーワードでコンテンツ広場を検索することもできます（ランキングと期間の指定はありません）。各ノートには順位、閲覧数、いいね数、保存数、コメント数、広告フラグ、投稿者のフォロワー数が含まれます。1ページ20件、1ランキングあたり最大100件です。 | 1,000リクエストあたり$16 | — |
このAPIのステータスデータを一時的に取得できないため、最近の状態は不明です。停止しているという意味ではありません。
Xiaohongshuの各アクションではどのような入力を指定できますか？
以下の各回答では、呼び出し可能なアクション1つとその実際の入力を対応付けています。パラメータの意味と指定可能な値はアクションごとに異なります。同じ名前でも、すべてのプラットフォームで同じ意味になるとは限りません。
公式情報源へのリンクは、横に記載したプラットフォーム用語を説明する目的でのみ掲載しています。プラットフォームによる認可や推奨を意味するものではありません。また、このページに記載がない限り、公式サイトの機能はEveryInfra APIには含まれません。
| アクション | 必須 | 任意 | 提供方式 | 上限 | 1,000件あたり | レスポンスフィールド |
|---|---|---|---|---|---|---|
search検索 トピックに関するXiaohongshuのノートを1ページ20件で検索します。タイトル、本文の抜粋、いいね数・保存数・コメント数・シェア数、投稿者、公開日時を取得できます。コンテンツタイプ、並び順、期間で絞り込めます。次のページを取得するには、 | keyword | content_type, date_range, page_token, sort | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · poi_id · poi_name · images · is_goods_note · is_cooperation_note · author_is_verified · updated_at · author_red_id · video_width · video_height |
profileプロフィール Xiaohongshuアカウントを照会します。ニックネーム、Xiaohongshu ID、自己紹介、IP所在地、認証情報に加え、フォロワー数・フォロー数・投稿数・いいね数・保存数の正確な値を取得できます。/user/profile/リンクに含まれるID、リンクそのもの、またはコメント投稿者の | user_id | — | Sync配信 | — | 1,000リクエストあたり$5.56 | user_id · nickname · red_id · url · bio · follower_count · following_count · like_collect_count · post_count · gender · ip_location · avatar_url · is_verified · tags · like_count · collect_count · real_name_info · verification_type · verification_text · location · platform |
user_postsユーザーの投稿 Xiaohongshuのクリエイターが公開したノートを1ページ20件で一覧表示します。固定されたノートが先頭に来て、その後に残りのノートが新しい順に並びます。抜粋、各種カウント、動画リンクを取得できます。続きは | user_id | page_token | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images · is_goods_note · is_pinned · ip_location |
noteノート詳細 Xiaohongshuのノート1件を全文取得します。本文、順番どおりのすべての画像、トピック、メンションされたユーザー、エンゲージメント数、IP所在地を取得できます。画像に座標が含まれている場合は座標も返されます。xsec_tokenを含む完全なノートのリンクをそのまま渡してください。動画の再生リンクとコメントの取得には、別途 | url | — | Sync配信 | — | 1,000リクエストあたり$5.56 | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · ip_location · author_name · author_id · is_video · avatar_url · author_url · platform · images · tags · topics · mentioned_users · lat · lng · has_goods · is_cooperation_note · author_red_id · author_is_verified · language · updated_at |
video動画の詳細
| url | — | Sync配信 | — | 1,000リクエストあたり$5.56 | id · url · video_url · duration_sec · duration_seconds · video_width · video_height · platform |
commentsコメント Xiaohongshuのノートのトップレベルコメントを1ページ15件で取得します。テキスト、いいね数、IP所在地、コメント投稿者、返信数、投稿者フラグとAIアカウントフラグが含まれます。 | url | page_token, sort | Sync配信 | 1回の呼び出しで最大15行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · sub_comments · platform |
comments_batch複数URLのコメント 1回の呼び出しで1〜20件のXiaohongshuノートからコメントを収集します。各行に | urls | sort | Sync配信 | 1回の呼び出しで、ノートごとに最大15件のコメントを1ページ分返します。next_page_tokenは含まれません。さらに取得するには、commentsでノートを1件ずつページングしてください。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · text · like_count · posted_at · ip_location · author_name · author_id · sub_comment_count · note_id · note_url · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · sub_comments · platform |
sub_commentsコメントへの返信 Xiaohongshuのノートにある1件のコメントへの返信を、1ページ10件で取得します。テキスト、いいね数、IP所在地、各返信の返信先を取得できます。ノートのリンクと、コメントの取得結果にある | url, comment_id | page_token | Sync配信 | 1回の呼び出しで最大10行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · text · like_count · posted_at · ip_location · author_name · author_id · reply_to_id · reply_to_author_name · reply_to_author_id · next_page_token · images · is_author · author_avatar_url · author_red_id · author_is_ai_agent · mentioned_users · comment_tags · platform |
search_usersユーザー検索 キーワードでXiaohongshuのクリエイターとブランドアカウントを1ページ20件で検索します。ニックネーム、Xiaohongshu ID、フォロワー数、認証タイプを取得できます。 | keyword | follower_range, page_token, user_type | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | user_id · nickname · red_id · avatar_url · url · follower_count · is_verified · verification_type · next_page_token · platform |
hashtagハッシュタグ Xiaohongshuの1つのトピックページにあるノートを、新着順または人気順で閲覧します。全文、すべての画像、エンゲージメント数、動画の詳細を取得できます。24文字の | topic_id | page_token, sort | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · url · title · text · like_count · collect_count · comment_count · share_count · posted_at · image_url · author_name · author_id · avatar_url · author_url · is_video · next_page_token · video_url · duration_sec · duration_seconds · platform · images |
trendingトレンド Xiaohongshuが現在おすすめしているノートのサンプルを、タイトル、投稿者、画像、動画フラグとともに最大30件取得します。内容は読み込むたびに変わります。一覧の順位からアルゴリズムを説明することはできず、取得結果を重ねても履歴にはなりません。 | — | Sync配信 | カタログ値：defaultLimit=20、maxLimit=30。アクションによってはlimitがページ数や親要素ごとの展開数を制御するため、必ずしも最終的な行数にはなりません。 | 1,000リクエストあたり$5.56 | id · url · title · author_name · is_video · image_url · platform | |
product_search商品検索
| keyword | page_token | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · title · url · price · original_price · currency · image_url · sold_count · in_stock · shop_id · shop_name · next_page_token · platform |
product_detail商品詳細 24文字のIDまたは商品詳細リンクから、Xiaohongshuストアの商品1件を取得します。価格と定価、カテゴリ、バリエーション、在庫、販売数（ページに概数が表示されている場合は下限値）、メイン画像と詳細画像、商品属性を取得できます。ショップについては、評価（ある場合）、総販売数、フォロワー数、紐づくXiaohongshuアカウントを取得できます。 | product_id | — | Sync配信 | — | 1,000リクエストあたり$5.56 | id · title · url · price · original_price · currency · in_stock · category · sold_count · variant_name · image_urls · detail_image_urls · attributes · shop_id · shop_name · shop_rating · shop_sold_count · shop_user_id · shop_follower_count · platform |
reviewsレビュー 24文字の | product_id | page_token, sort | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | id · product_id · text · rating · rating_scale · service_rating · logistics_rating · like_count · reply_count · images · tags · sku · posted_date · next_page_token · platform |
followers_listフォロワー一覧 24文字の | user_id | page_token | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。行数はページごとに異なるため、行数が少なくても最後のページとは限りません。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡し、next_page_tokenがなくなったら終了します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$5.56 | user_id · nickname · avatar_url · url · follower_count · note_count · of_user · next_page_token · platform |
note_locationノートの位置情報 ノートのリンクまたは共有リンクから、Xiaohongshuのノートにタグ付けされた場所を取得します。表示どおりの位置情報テキスト、都市、場所名、場所IDを取得できます。場所がタグ付けされていないノートでは、空の結果が返されます。 | url | — | Sync配信 | — | 1,000リクエストあたり$5.56 | note_id · url · location_text · city · poi_name · poi_ids · platform |
pgy_content_squarePugongyingのコンテンツボード XiaohongshuのブランドとクリエイターをつなぐマーケットプレイスPugongyingで、コンテンツ広場の人気コンテンツランキングを取得します。総合人気ノート、商品シーディング、EC販促、ブランドコラボ、リード獲得などのランキングを3〜30日の期間で取得できるほか、キーワードでコンテンツ広場を検索することもできます（ランキングと期間の指定はありません）。各ノートには順位、閲覧数、いいね数、保存数、コメント数、広告フラグ、投稿者のフォロワー数が含まれます。1ページ20件、1ランキングあたり最大100件です。 | board, keyword, page_token, time_window | Sync配信 | 1回の呼び出しで最大20行の1ページを返します。次のページを取得するには、レスポンスのトップレベルにあるnext_page_tokenをpage_tokenとして渡します。limitは指定できますが、効果はありません。 | 1,000リクエストあたり$16 | rank · id · url · title · is_video · like_count · collect_count · comment_count · view_count · posted_at · images · video_url · duration_sec · duration_seconds · is_ad · author_id · author_name · author_avatar_url · author_follower_count · platform |
Xiaohongshuのsearchのパラメータはそれぞれどういう意味ですか？
トピックに関するXiaohongshuのノートを1ページ20件で検索します。タイトル、本文の抜粋、いいね数・保存数・コメント数・シェア数、投稿者、公開日時を取得できます。コンテンツタイプ、並び順、期間で絞り込めます。次のページを取得するには、next_page_tokenをpage_tokenとして送り返してください。検索結果のテキストは抜粋で、ノートの全文ではありません。
keyword必須- searchアクションでXiaohongshuのノート内容を検索するクエリ文字列を指定します（例：「sensitive skin sunscreen」）。検索対象はノートのテキストで、ユーザーIDではありません。
content_type任意- 返されるノートをコンテンツの種類（画像/テキスト、動画など）で絞り込みます。現在のアクションで指定できる値を使用してください。指定可能な値:
allimagevideoXiaohongshu：画像・テキストノートと動画ノートのエントリーポイント — Xiaohongshuの公開ディープリンクドキュメントでは、画像・テキストノート、動画ノート、ノートのコメントページを別々に記載しています。この参考情報はコンテンツタイプの違いを引用するのみです。ドキュメント内のアプリ遷移用パラメータを、このエンドポイントにそのまま渡すことはできません。 · 確認日 date_range任意- ノートを公開日時で絞り込みます。any_time（制限なし、省略時と同じ）、last_24_hours（過去24時間）、last_7_days（過去7日間）、last_30_days（過去1か月）、last_6_months（過去6か月）、last_1_year（過去1年）のいずれかです。last_30_daysとlast_1_yearでは1ページのノートが20件未満になる場合があり、0件のページは課金されません。より多くのノートを含むページを得るには、sort=newestを追加してください。この2つの値は同期呼び出しでのみ機能します。ページ送りの間は同じ値を維持してください。指定可能な値:
any_timelast_1_yearlast_24_hourslast_30_dayslast_6_monthslast_7_days page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
sort任意- searchアクションでのノート一覧の並び順を設定します。relevance、newest、most_liked、most_commented、most_collectedのいずれかです。アクションで指定できる値のみを使用してください。指定可能な値:
most_collectedmost_commentedmost_likednewestrelevance
Xiaohongshuのprofileのパラメータはそれぞれどういう意味ですか？
Xiaohongshuアカウントを照会します。ニックネーム、Xiaohongshu ID、自己紹介、IP所在地、認証情報に加え、フォロワー数・フォロー数・投稿数・いいね数・保存数の正確な値を取得できます。/user/profile/リンクに含まれるID、リンクそのもの、またはコメント投稿者のauthor_idを渡してください。表示されていない数値は、0ではなくnullで返されます。
user_id必須- profileアクションとuser_postsアクションで、XiaohongshuのユーザーID（URLの/user/profile/に続く識別子）またはプロフィールURL全体を指定します。コメント系アクションが返すauthor_idも使用できます。プロフィール詳細や公開済みノートの取得に使用します。ユーザー名（表示名）は受け付けません。
Xiaohongshuのuser_postsのパラメータはそれぞれどういう意味ですか？
Xiaohongshuのクリエイターが公開したノートを1ページ20件で一覧表示します。固定されたノートが先頭に来て、その後に残りのノートが新しい順に並びます。抜粋、各種カウント、動画リンクを取得できます。続きはpage_tokenで取得します。ここで返されるリンクにはアクセストークンが含まれず、テキストは抜粋です。ブラウザでそのまま開けるリンクと本文全体が必要な場合は、noteを呼び出してください。
user_id必須- profileアクションとuser_postsアクションで、XiaohongshuのユーザーID（URLの/user/profile/に続く識別子）またはプロフィールURL全体を指定します。コメント系アクションが返すauthor_idも使用できます。プロフィール詳細や公開済みノートの取得に使用します。ユーザー名（表示名）は受け付けません。
page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
Xiaohongshuのnoteのパラメータはそれぞれどういう意味ですか？
Xiaohongshuのノート1件を全文取得します。本文、順番どおりのすべての画像、トピック、メンションされたユーザー、エンゲージメント数、IP所在地を取得できます。画像に座標が含まれている場合は座標も返されます。xsec_tokenを含む完全なノートのリンクをそのまま渡してください。動画の再生リンクとコメントの取得には、別途videoとcommentsの呼び出しが必要です。
url必須- Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。
Xiaohongshuのvideoのパラメータはそれぞれどういう意味ですか？
noteが受け付けるものと同じURLを使って、Xiaohongshuの動画ノート1件の再生リンクと再生時間を取得します。署名付きリンクには有効期限があるため、早めにダウンロードしてください。画像ノートでは空の結果が返され、返金されます。
url必須- Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。
Xiaohongshuのcommentsのパラメータはそれぞれどういう意味ですか？
Xiaohongshuのノートのトップレベルコメントを1ページ15件で取得します。テキスト、いいね数、IP所在地、コメント投稿者、返信数、投稿者フラグとAIアカウントフラグが含まれます。sortで並び替え、page_tokenでページ送りし、返信そのものはsub_commentsで取得します。
url必須- Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。
page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
sort任意- コメントの並び順です。defaultはプラットフォーム独自の順序に従い（省略時と同じ）、newestは新しいコメントから、most_likedはいいねの多いコメントから順に並べます。ページ送り中は同じ値を維持してください。値を変えると、以前のnext_page_tokenは使えなくなります。指定可能な値:
defaultmost_likednewest
Xiaohongshuのcomments_batchのパラメータはそれぞれどういう意味ですか？
1回の呼び出しで1〜20件のXiaohongshuノートからコメントを収集します。各行にnote_idとnote_urlが含まれるため、スレッドは混ざりません。すべてのリンクに有効なノートIDとxsec_tokenが必要です。取得に失敗したノートは、コメント0件ではなく取得漏れとして報告されます。
urls必須- comments_batchアクションで、XiaohongshuのノートURLを1〜20件の配列で指定します。各URLには有効なノートIDとxsec_tokenが含まれている必要があります。課金は対象ノートごとです。一部のノートが失敗した場合は、コメントが0件だと判断せず、partialまたはmissedのレスポンスフィールドを確認してください。
sort任意- リクエスト内のすべてのノートに適用されるコメントの並び順です。defaultはプラットフォーム独自の順序に従い（省略時と同じ）、newestは新しいコメントから、most_likedはいいねの多いコメントから順に並べます。指定可能な値:
defaultmost_likednewest
Xiaohongshuのsub_commentsのパラメータはそれぞれどういう意味ですか？
Xiaohongshuのノートにある1件のコメントへの返信を、1ページ10件で取得します。テキスト、いいね数、IP所在地、各返信の返信先を取得できます。ノートのリンクと、コメントの取得結果にあるcomment_idを渡してください。スレッドを再構成するにはreply_to_idを使用します。
url必須- Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。
comment_id必須- sub_commentsアクションで、サブ返信を取得する親コメントのIDを指定します。同じノートのcommentsのレスポンスから取得し、対応するurlと組み合わせてください。ノートIDやユーザーIDではありません。
page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
Xiaohongshuのsearch_usersのパラメータはそれぞれどういう意味ですか？
キーワードでXiaohongshuのクリエイターとブランドアカウントを1ページ20件で検索します。ニックネーム、Xiaohongshu ID、フォロワー数、認証タイプを取得できます。follower_rangeまたはuser_typeで絞り込めます。フォロワー数は一覧に表示される概数に基づく近似値のため、正確な数値が必要な場合はprofileを呼び出してください。
keyword必須- アカウントを探すためのキーワードです（例：coffee、ブランド名、トピック）。ノートではなく、ユーザー（クリエイターやブランドアカウント）を返します。
follower_range任意- search_usersでアカウントをフォロワー数で絞り込みます。under_100、100_to_1k、1k_to_10k、10k_to_100k、over_100kのいずれかです。制限しない場合は省略します。指定可能な値:
100_to_1k10k_to_100k1k_to_10kover_100kunder_100 page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
user_type任意- search_usersでアカウントを種類で絞り込みます。general（一般ユーザー）、verified_individual（認証済みの個人）、business（認証済みの企業）のいずれかです。制限しない場合は省略します。指定可能な値:
businessgeneralverified_individual
Xiaohongshuのhashtagのパラメータはそれぞれどういう意味ですか？
Xiaohongshuの1つのトピックページにあるノートを、新着順または人気順で閲覧します。全文、すべての画像、エンゲージメント数、動画の詳細を取得できます。24文字のtopic_idまたはトピックのリンクを渡してください。1ページあたり最大20件です。最後のページと判断できるのは、next_page_tokenがない場合だけです。
topic_id必須- hashtagで使うトピックページID（24文字）、またはhttps://www.xiaohongshu.com/page/topics/<ID>などのトピックページリンク、アプリのトピックリンク、Xiaohongshuの短縮共有リンクを指定します。noteが返すtopics[].topic_idの値はそのまま使用できます。ノートのタグオブジェクトのIDやトピック名ではありません。
page_token任意- comments、sub_comments、search、user_posts、search_users、hashtagアクション用のページネーションカーソルです。次のページを取得するには、前回のレスポンスの行に含まれるnext_page_tokenの値をそのまま渡します。最初のページから取得する場合は省略します。1ページにつき1回の呼び出しで、リクエストごとに課金されます。
sort任意- トピックのノートの並び順です。newestは新しいものから順に並べ（省略時と同じ）、popularは人気の高いものから順に並べます。ページ送り中は同じ値を維持してください。指定可能な値:
newestpopular
Xiaohongshuのtrendingのパラメータはそれぞれどういう意味ですか？
Xiaohongshuが現在おすすめしているノートのサンプルを、タイトル、投稿者、画像、動画フラグとともに最大30件取得します。内容は読み込むたびに変わります。一覧の順位からアルゴリズムを説明することはできず、取得結果を重ねても履歴にはなりません。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況このアクションには固有のパラメータがありません。プラットフォームとアクションの識別子のみを送信してください。
Xiaohongshuのproduct_searchのパラメータはそれぞれどういう意味ですか？
keywordでXiaohongshuストアの商品を検索します。各商品にはタイトル、価格、定価、通貨、販売数（ページに表示されている場合）、在庫状況、画像、ショップが含まれます。1ページは通常19件（実績では18〜20件）で、next_page_tokenでページ送りします。結果はノートではなくストアの商品で、各idはproduct_detailで使用できます。
keyword必須- Xiaohongshuストアで商品を検索するキーワードです（例：
sunscreen）。ノートではなく商品（SKU）を返します。返される各idはproduct_detailのproduct_idとして使用できます。 page_token任意- ページトークンです。最初のページでは省略し、以降は前回のレスポンスの
next_page_tokenを受け取ったとおりそのまま、他のパラメータは変更せずに渡してください。1ページには通常19件の商品（実績では18〜20件）が含まれ、1ページが1回の呼び出しになります。ストア側で結果の並び順が変わるため、隣接するページで一部の商品が重複することがあります。idで重複を除外してください。トークンは24時間以内に使用してください。最後のページにはnext_page_tokenがありません。
Xiaohongshuのproduct_detailのパラメータはそれぞれどういう意味ですか？
24文字のIDまたは商品詳細リンクから、Xiaohongshuストアの商品1件を取得します。価格と定価、カテゴリ、バリエーション、在庫、販売数（ページに概数が表示されている場合は下限値）、メイン画像と詳細画像、商品属性を取得できます。ショップについては、評価（ある場合）、総販売数、フォロワー数、紐づくXiaohongshuアカウントを取得できます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況product_id必須product_searchの行のidから取得した24文字の商品ID、または商品リンクhttps://www.xiaohongshu.com/goods-detail/<ID>です。形式が正しくないIDは課金前に拒否されます。
Xiaohongshuのreviewsのパラメータはそれぞれどういう意味ですか？
24文字のproduct_idで、Xiaohongshuストア商品の購入者レビューをデフォルト順または新着順で取得します。各レビューには全文、5段階評価、サービス評価と配送評価、「参考になった」の票数、返信数、購入者の写真、レビュータグ、購入したバリエーション、レビュー日が含まれます。レビュー投稿者のID、名前、アバターは返されません。1ページ最大20件です。
product_id必須product_searchの行のidから取得した24文字の商品ID、または商品リンクhttps://www.xiaohongshu.com/goods-detail/<ID>です。形式が正しくないIDは課金前に拒否されます。page_token任意- ページトークンです。最初のページでは省略し、以降は前回のレスポンスの
next_page_tokenを受け取ったとおりそのまま、他のパラメータは変更せずに渡してください。1ページあたり最大20件のレビューで、1ページが1回の呼び出しになります。最後のページにはnext_page_tokenがありません。 sort任意- レビューの並び順です。
default（ストアのデフォルトの並び順で、省略した場合と同じ）またはnewest（新しい順）を指定します。ページ送りの間は同じ値を使い続けてください。指定可能な値:defaultnewest
Xiaohongshuのfollowers_listのパラメータはそれぞれどういう意味ですか？
24文字のuser_idまたはプロフィールリンクで、Xiaohongshuアカウントのフォロワーを一覧表示します。各フォロワーにはuser_id、ニックネーム、アバター、プロフィールリンク、フォロワー数、ノート数が含まれます。1ページは通常19〜20人で、next_page_tokenでページ送りします。フォロワーリストを非公開にしているアカウントは多く、その場合は呼び出しが失敗し、返金されます。
user_id必須- フォロワーを一覧表示する対象ユーザーを指定します。
profileまたはsearch_usersが返す24文字の user_id、またはプロフィールリンク https://www.xiaohongshu.com/user/profile/<ID> を使用できます。多くのアカウントはフォロワーリストを非公開にしており、その場合は呼び出しが失敗し、返金されます。 page_token任意- ページトークンです。最初のページでは省略し、以降は前回のレスポンスの
next_page_tokenを受け取ったとおりそのまま、他のパラメータは変更せずに渡してください。1ページには通常19〜20人が含まれ、1ページが1回の呼び出しになります。最後のページにはnext_page_tokenがありません。
Xiaohongshuのnote_locationのパラメータはそれぞれどういう意味ですか？
ノートのリンクまたは共有リンクから、Xiaohongshuのノートにタグ付けされた場所を取得します。表示どおりの位置情報テキスト、都市、場所名、場所IDを取得できます。場所がタグ付けされていないノートでは、空の結果が返されます。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況url必須- ノートのリンク（/explore/<note ID> または /discovery/item/<note ID>）、またはXiaohongshuの共有リンクを指定します。必要なのはノートIDだけで、xsec_token は不要です。リンクに xsec_token が含まれている場合は、返されるノートリンクにもそのまま残ります。
Xiaohongshuのpgy_content_squareのパラメータはそれぞれどういう意味ですか？
XiaohongshuのブランドとクリエイターをつなぐマーケットプレイスPugongyingで、コンテンツ広場の人気コンテンツランキングを取得します。総合人気ノート、商品シーディング、EC販促、ブランドコラボ、リード獲得などのランキングを3〜30日の期間で取得できるほか、キーワードでコンテンツ広場を検索することもできます（ランキングと期間の指定はありません）。各ノートには順位、閲覧数、いいね数、保存数、コメント数、広告フラグ、投稿者のフォロワー数が含まれます。1ページ20件、1ランキングあたり最大100件です。
完全なAPIリファレンス：パラメータ、コードサンプル、レスポンス例、稼働状況board任意pgy_content_squareが取得するPugongyingコンテンツ広場のランキングです。hot（Xiaohongshu人気、デフォルト）、product_seeding、ecommerce_promo、brand_collab、lead_gen、ecommerce_hot、seeding_direct、app_promoのいずれかを指定します。keywordを指定した場合は無視されます。指定可能な値:app_promobrand_collabecommerce_hotecommerce_promohotlead_genproduct_seedingseeding_directkeyword任意- 任意。コンテンツ広場のノートをこの語で検索します（例：
coffee）。ランキング全体を取得する場合は省略してください。キーワード検索は人気順で、ランキングと期間の指定には対応していません（boardとtime_windowは無視されます）。そのため、直近1〜2か月のノートが表示されることがあります。結果にはlike_count、comment_count、video_url、duration_sec、author_avatar_urlが含まれず、リンクにはアクセストークンが付きません。 page_token任意- ページトークンです。最初のページでは省略し、以降は前回のレスポンスの
next_page_tokenを受け取ったとおりそのまま、他のパラメータは変更せずに渡してください。1ページあたり20件のノートで、1ページが1回の呼び出しになります。1つのボードは最大100件（5ページ）で、最後のページにはnext_page_tokenがありません。 time_window任意pgy_content_squareの集計期間です。3d、7d（デフォルト）、14d、30dのいずれかを指定します。keywordを指定した場合は無視されます。指定可能な値:14d30d3d7d
Xiaohongshu APIの使い方
- 01公開カタログからプラットフォームのアクションを選択します。
- 02プラットフォーム、アクション、必須パラメータをPOST /api/v1/socialに送信します。
- 03レスポンスから結果を読み取ります。非同期のアクションの場合は、返されたジョブIDをポーリングします。
- 04アプリケーションで必要なレスポンスフィールドを保存します。
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"xiaohongshu","action":"search","params":{"keyword":"<keyword>"}}'
Xiaohongshuのガイド
これらのアクションを使った実践例と手法です。まずこのページで現在のアクション、パラメータ、フィールドを確認してください。記事内の例や制限は、最新のカタログに代わるものではありません。
Xiaohongshuのコメントを一括取得する：ノート一覧から検証可能な結果まで
Xiaohongshuのcomments_batchを組み込む方法を順を追って解説します。完全なノートURLの準備、URL数とコメント数の区別、部分取得と未取得の識別、ノート単位の重複排除、空の結果、リトライ、対象ごとの課金への対応を取り上げます。
記事を読むXiaohongshuのデータ分析は合計値で終わらせない：エクスポートしたノートと過去のスナップショットの活用
クリエイター向けエクスポートから、累計指標と期間指標、スナップショット日付、ブックマークの増分、重複排除、欠損サンプルを読み解き、時点やノートをまたいだ歪みを防ぎます。
記事を読む統合データAPI入門：機能カタログから最初の有効な結果を得るまで
platform、action、paramsで複数プラットフォームのデータにアクセスします。機能カタログの読み方、最小限のリクエストの送信、非同期タスク・部分的な結果・課金の扱い方、追跡可能なデータ記録の作り方を解説します。
記事を読むXiaohongshu APIに関する質問
Xiaohongshu APIでは何を取得できますか？
platformをxiaohongshuに設定します。現在のカタログには検索、プロフィール、ユーザーの投稿、ノート詳細、動画の詳細、moreが掲載されています。これらのアクション名はそれぞれ異なるXiaohongshuのオブジェクトやビューを表すもので、互いに置き換えられる検索モードではありません。
Xiaohongshuに公式APIはありますか？
Xiaohongshuの公式オープンプラットフォームは、出店者、EC向けソフトウェアベンダー、ミニプログラム開発者、コンテンツ共有パートナーを対象としています。ECプラットフォームでは、アプリを承認したストアの商品、注文、アフターサービス、物流のデータを提供しています。公開ドキュメントには、ノートの検索や、他のユーザーのノート・コメントを読み取るAPIについての記載はありません。
公式情報源： Xiaohongshu ECオープンプラットフォーム：API権限パッケージ · Xiaohongshu ECオープンプラットフォーム · 確認日
Xiaohongshuの開発者アカウントやAPIキーは必要ですか？
いいえ、不要です。リクエストはEveryInfraのAPIキーを使ってEveryInfra経由で送信します。新規登録後、コンソールでキーを作成し、Authorization: Bearer <API_KEY>として送信してください。Xiaohongshuの開発者アプリの登録、Xiaohongshu APIへのアクセス申請、Xiaohongshuアカウントでのログインは必要ありません。また、アクションが返すのはXiaohongshuの公開データのみです。
Xiaohongshu APIの料金は1,000リクエストあたりいくらですか？
アクションに応じて1,000リクエストあたり$5.56から、各アクションの料金は、このページの表と公開カタログに記載されています。サブスクリプションはなく、USD残高をチャージして呼び出しごとに料金を支払います。失敗した呼び出しや結果が空の場合は課金されません。
Xiaohongshuのsearchリクエストを開始するには、どの入力を使用しますか？
searchアクションでXiaohongshuのノート内容を検索するクエリ文字列を指定します（例：「sensitive skin sunscreen」）。検索対象はノートのテキストで、ユーザーIDではありません。params内のkeywordとして送信してください。
Xiaohongshuのsearchはどのフィールドを返しますか？
宣言されたスキーマにはtitle、text、like_count、collect_countが含まれます。宣言されたフィールドでも個々のレコードには含まれない場合があり、他のアクションにはそれぞれ独自のフィールド一覧があります。
Xiaohongshuのアクションはすべて即座に結果を返しますか？
非同期と表示されたアクションはジョブIDを返すので、そのIDをポーリングします。comments_batchrunsは同期でのみ動作します。1回の呼び出し内で返すすべてのデータ（バッチのすべての対象、または商品のすべてのSKU）を読み取るため、"mode": "async"を指定したリクエストには課金前に422が返されます。それ以外のすべてのアクションも非同期で実行できます。リクエストボディに"mode": "async"を追加するとすぐにジョブIDが返されるため、時間のかかるタスクや上限値を大きく設定する場合に便利です。現在のカタログにはsync配信が含まれています。