Xiaohongshuノート詳細API

Q: 動画ノートに動画リンクがないのはなぜですか？

「ノート詳細」には再生リンクが含まれず、動画ノートはis_videoで示されます。リンクを取得するには、同じノートのurlで「動画詳細」を呼び出してください。再生リンクと動画の長さが返され、別の呼び出しとして課金されます。検索で見つかった動画ノートは、結果行にすでに再生リンクが含まれています。

POST

APIの稼働状況

このAPIのステータスデータを一時的に取得できないため、最近の状態は不明です。停止しているという意味ではありません。

Xiaohongshuのノート1件を全文取得します。本文、順番どおりのすべての画像、トピック、メンションされたユーザー、エンゲージメント数、IP所在地を取得できます。画像に座標が含まれている場合は座標も返されます。xsec_tokenを含む完全なノートのリンクをそのまま渡してください。動画の再生リンクとコメントの取得には、別途videoとcommentsの呼び出しが必要です。

Xiaohongshuの「ノート詳細」機能は、urlから1件のノートを読み取り、その内容をすべて返します。全文、順番どおりのすべての画像、トピック、メンションされたユーザーに加え、いいね数・保存数・コメント数・シェア数と投稿日時を返し、画像に位置情報がある場合はlatとlngも返します。ノートの実際の内容や反響の分析、シーディングキャンペーンの振り返り、検索結果を分析できる全文に変換する用途に使えます。

ノートのリンクは、xsec_tokenなどのクエリパラメータを含めて完全な形のまま渡してください。検索結果から取得した新しいリンクが最も確実で、ノートIDだけでは通常は機能しません。ip_locationはXiaohongshuが表示するIP所在地であり、投稿者が入力した住所ではありません。また、topicsに含まれるトピックIDから、同じトピックの他のノートをたどれます。

料金は1,000リクエストあたり$5.56（1回あたり$0.005556）です。失敗した呼び出しと空の結果には課金されません。同期処理です。時間のかかるジョブでは、ボディに"mode": "async"を追加し、job_idを取得してポーリングしてください。

AIプロンプト

EveryInfraのXiaohongshu ノート詳細エンドポイント（xiaohongshu/note）を使ったデータ収集スクリプトの作成を手伝ってください。

エンドポイントの仕組み：
- リクエスト：ヘッダーにAuthorization: Bearer <API key>を指定して、https://api.everyinfra.com/api/v1/socialにPOSTします。APIキーは環境変数EVERYINFRA_API_KEYから読み込み、ハードコードしないでください。
- リクエストボディでplatformにxiaohongshu、actionにnoteを指定し、パラメータはparamsの中に入れます。
- 必須パラメータ：
  - url: Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。
- 1つのオブジェクトを返します。主なフィールド: id、url（Xiaohongshu上のレコードのリンクです）、title、text（ノート本文またはコメントのテキスト）、like_count（いいね数）、collect_count（保存数）、comment_count、share_count、posted_at、ip_location（Xiaohongshuが表示するIPの所在地（省または国）で、ユーザーが入力し…）、author_name、author_id（投稿者のユーザーID）。フィールドは全部で27個です。一覧はhttps://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshuを参照してください。.
- リクエストボディの例：
{
  "platform": "xiaohongshu",
  "action": "note",
  "params": {
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D"
  }
}
- 料金：1,000リクエストあたり$5.56。失敗時および結果が空の場合は課金されません。
- 対象が数十〜数百件ある場合は、ボディに"mode": "async"を追加します。すぐにjob_idが返されるので、GET https://api.everyinfra.com/api/v1/jobs/{job_id}をポーリングして結果を取得します。
- 422の場合は、エラーに含まれる推奨パラメータ名と指定可能な値を使ってリクエストを修正します。429または503の場合は、Retry-Afterの指定に従って待ってから再試行します。

コードを書く前に、必要な対象とその件数、必要なフィールド、希望する出力形式を私に質問してください。そのうえで、計画と概算費用を私に確認してください。

リクエストパラメータ

名前	場所	型	必須	デフォルト	説明
`Authorization`	header	`string`	はい	-	Bearerの後にAPIキーを続けます。APIキーはコンソールで作成してください。URLやコードリポジトリには絶対に含めないでください。
`platform`	body	`string`	はい	`xiaohongshu`	プラットフォームの識別子です。値は固定です。
`action`	body	`string`	はい	`note`	機能の識別子です。値は固定です。
`url`	body.params	`string`	はい	-	Xiaohongshuのノートの完全なURLを、/explore/<note_id>または/discovery/item/<note_id>の形式で指定します。xsec_tokenなどのクエリパラメータが残っている、最近の検索で得たURLを使用してください。sub_commentsアクションでは、このurlと有効なcomment_idの両方が必要です。

コードサンプル

bash

curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "xiaohongshu",
  "action": "note",
  "params": {
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D"
  }
}'

OpenAPI定義（JSON）サンプルは環境変数EVERYINFRA_API_KEYからAPIキーを読み込みます。コピーしたコードにAPIキーが含まれることはありません。

レスポンス例

実際のレスポンス

October 15, 2026 at 15:16（UTC）に、上のコードサンプルのパラメータでこのAPIを呼び出して取得しました。resultsとcountはその呼び出しの実際のレスポンスから個人情報（名前、ハンドル、アバター、プロフィールリンク、連絡先）を削除したものです。id、billing、quotaは呼び出しごとに異なるため、構造のみを示しています。

json

{
  "id": "req_…",
  "platform": "xiaohongshu",
  "action": "note",
  "results": {
    "id": "6aa7a3f600000000110335f8",
    "url": "https://www.xiaohongshu.com/explore/6aa7a3f600000000110335f8?xsec_token=YByFNzoKupps8B3qI774Gx7XGxfHpq4QWEvxU4zsD8454%3D",
    "title": "33㎡的一字户塞下28㎡收纳？！还巨显大！",
    "text": "感谢超有生活智慧的@••• 接受采访！\n本期视频超多干货！\n33㎡邪修出两房！2㎡卫生间硬塞浴缸🛁\n全屋28㎡收纳、衣柜800件衣服装不满！\n超低成本旋转鞋架、空调机位改树屋🌳\n把每一寸空间都榨干的小户型终极收纳来啦！\n#roomtour[话题]# #小户型收纳[话题]# #探家[话题]#  #小红书自建房大赏[话题]#  #WeeklyPick[话题]#  #野生体验家howto[话题]# #我在小红书搞装修[话题]# #装修内行人[话题]#",
    "like_count": 3421,
    "collect_count": 3928,
    "comment_count": 104,
    "share_count": 976,
    "posted_at": "2026-09-14T09:01:04+00:00",
    "ip_location": "•••",
    "author_name": "•••",
    "author_id": "•••",
    "is_video": true,
    "avatar_url": "https://sns-avatar-qc-ae.rednotecdn.com/•••",
    "author_url": "https://www.xiaohongshu.com/•••",
    "platform": "xiaohongshu",
    "images": [
      "https://sns-i11-ae.rednotecdn.com/spectrum/1040g34o3253cssm6302049v1t8cah4q0tpb8l58?imageView2/2/w/576/format/heif/q/58|imageMogr2/strip&redImage/frame/0/enhance/4&ap=1&sc=V_PRV&sign=ed0259e196793273f51646a46b2c1a02&t=6ad0ee3c"
    ],
    "tags": [
      "roomtour",
      "小户型收纳",
      "探家"
    ],
    "topics": [
      {
        "name": "roomtour",
        "topic_id": "6103b7a0b2363700017d720a"
      },
      {
        "name": "小户型收纳",
        "topic_id": "5be9634385cfbb000101d51f"
      },
      {
        "name": "探家",
        "topic_id": "6064a7711fd52f0001b7d830"
      }
    ],
    "mentioned_users": [
      {
        "user_id": "•••",
        "nickname": "•••"
      }
    ]
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

レスポンスフィールド

業務データはresultsに含まれます。この表はレコードに含まれうるフィールドの一覧です。プラットフォームに表示されない値を作り出すことはありません。

フィールド	意味
`id`	プラットフォーム上でのレコードの一意なIDです。一意性は1つのプラットフォーム内に限られ、プラットフォームが異なるとIDが重複する場合があります。
`url`	Xiaohongshu上のレコードのリンクです。search、note、profile、hashtagから返るリンクには通常アクセストークンが付いているため、ログインしていないブラウザでも開けます（トークンには有効期限があります。新しいリンクが必要な場合は再度呼び出してください）。user_postsから返るノートのリンクにはトークンが付いておらず、ブラウザで開くにはトークンが必要です。開けるリンクを取得するには、ノートIDを指定してnoteを呼び出してください。search_usersから返るプロフィールのリンクにもトークンは付いていません。開けるリンクを取得するには、user_idを指定してprofileを呼び出してください。pgy_content_squareから返るノートのリンクにはトークンが付きますが、`keyword`を指定した場合は付きません。
`title`	タイトルです。プラットフォームにタイトルがない場合（テキストのみの投稿など）はnullになります。
`text`	ノート本文またはコメントのテキスト。noteとhashtagは本文全体を返します。searchとuser_postsは切り詰めた抜粋（それぞれ最大約60文字、約100文字）を返す場合があります。全文が必要な場合は、ノートIDを指定してnoteを呼び出してください。
`like_count`	いいね数。noteとコメントの結果では、その項目へのいいね数です。profileでは、アカウントのノートが受け取ったいいねの合計数です。nullは非公開または今回返されなかったことを意味し、0ではありません。
`collect_count`	保存数。noteの結果では、そのノートが保存された回数です。profileでは、アカウントのノート全体の保存数の合計です。nullは非公開または今回返されなかったことを意味し、0ではありません。
`comment_count`	コメント数です。nullは非公開を示し、0ではありません。
`share_count`	シェア数です。nullは非公開を示し、0ではありません。
`posted_at`	投稿日時です。ISO 8601形式のUTCで返されます（例：2026-08-07T12:34:56+00:00）。プラットフォームから非標準の文字列が返された場合はそのまま渡されるため、パース処理は堅牢に実装してください。nullはプラットフォームが公開していないことを示します。
`ip_location`	Xiaohongshuが表示するIPの所在地（省または国）で、ユーザーが入力したものではありません。一部のuser_postsの行にのみ含まれます。
`author_name`	投稿者の表示名です。
`author_id`	投稿者のユーザーID。profileやuser_postsに渡せます。ノートの結果にはプロフィールURLにある24文字のIDが含まれ、コメントの結果（comments、comments_batch、sub_comments）には通常、別形式の29文字のIDが含まれます。同じ人物でも2つの形式は一致しないため、バッチをまたいで重複を除く前に、profileが返すuser_idで変換してください。
`is_video`	動画ノートかどうか。再生URLはノート詳細のレスポンスに含まれません（2026-10-14以降）。取得するには、同じノートURLで別のvideoアクションを呼び出してください。呼び出しごとに課金されます。
`avatar_url`	アバター画像のリンクです。一部のプラットフォームでは、サイズ指定付きで有効期限が切れる可能性のあるCDNリンクが返されます。
`author_url`	投稿者のプロフィールリンク。アクセストークンが付いていないため、ログインしていないブラウザでは開けません。author_idでprofileを呼び出して返されるurlは直接開けます。
`platform`	取得元プラットフォームの識別子で、リクエストのplatformと同じです（例：xiaohongshu、tiktok）。
`images`	画像のリンク。note、hashtag、search、user_postsでは、ノートのすべての画像を順番どおりに返します。コメントの結果（comments、comments_batch、sub_comments）では、コメントに添付された画像（スタンプを含む）を返し、空の配列は画像がないことを意味します。nullは今回この項目が返されなかったことを意味します。
`tags`	タグのリスト。noteではノートのトピックタグ、profileではプロフィールページに表示される個人タグ（星座や地域など）、reviewsではストアが付けるレビュータグ（「品質が良い」など。ない場合は含まれません）です。表記は表示どおりです。
`topics`	ノートのトピック。各トピックにはnameとtopic_id（トピックページのID）があります。topic_idをhashtagに渡すと、そのトピックのノートを取得できます。ノートにトピックがない場合や返されなかった場合、このフィールドは省略されます。
`mentioned_users`	@メンションされたユーザー。コメントの結果ではコメント内でメンションされたユーザー、noteではノート内でメンションされたユーザーです。各要素にはuser_idとnicknameがあります。該当者がいない場合は含まれません。
`lat`	ノートの画像に付いている位置情報の緯度（note）。値は加工せずに返します。位置情報がない場合は含まれません。
`lng`	ノートの画像に付いている位置情報の経度（note）。latと一緒に返されます。
`has_goods`	プラットフォーム上の意味のまま
`is_cooperation_note`	ノートが有償のブランドタイアップかどうか（search、note）。判定できなかった場合は含まれません。
`author_red_id`	投稿者のXiaohongshu ID。コメントの結果（comments、comments_batch、sub_comments）ではコメント投稿者、noteではノート投稿者のIDです。
`author_is_verified`	プラットフォーム上の意味のまま
`language`	プラットフォームが判定したコンテンツの言語コードです（例：zh、en）。誤っている場合があります。
`updated_at`	プラットフォーム上の意味のまま

FAQ

ノートIDだけでは使えないのはなぜですか？

Xiaohongshuのノートページを開くには、リンクに含まれるアクセストークンが必要です。パスが /explore/<note ID> または /discovery/item/<note ID> の完全なURLを渡し、xsec_tokenなどのクエリパラメータは残してください。検索結果のurlにはトークンがすでに含まれているため、そのまま渡せます。

`ip_location`は投稿者の居住地ですか？

厳密には違います。Xiaohongshuがすべての投稿に表示するIP所在地（省または国）です。投稿者ではなくプラットフォームが設定する値なので、大まかな地域分析には適していますが、正確な位置として扱うべきではありません。

動画ノートに動画リンクがないのはなぜですか？

「ノート詳細」には再生リンクが含まれず、動画ノートはis_videoで示されます。リンクを取得するには、同じノートのurlで「動画詳細」を呼び出してください。再生リンクと動画の長さが返され、別の呼び出しとして課金されます。検索で見つかった動画ノートは、結果行にすでに再生リンクが含まれています。

エラーと課金

401: キーが未指定か無効です。
402: 残高が不足しています。先にチャージしてください。
422: パラメータ名または値が無効です。エラーに含まれる候補を参考に修正してください。課金はされません。
429: 1分あたりのリクエスト上限に達しました。Retry-Afterの指定に従って待ってから再試行してください。
503: 処理を完了できませんでした。保留中の請求額は残高に戻されます。結果が不明な場合は、再試行する前に確認してください。
200（空）: データがありません。課金はされません。

エラー