API Xiaohongshu Сведения о заметке

POST

Состояние API

Данные о состоянии этого API временно недоступны, поэтому неизвестно, как он работал в последнее время. Это не значит, что API не работает.

Читайте заметку Xiaohongshu целиком. Получите текст, все изображения по порядку, темы, упомянутых пользователей, счётчики вовлечённости и IP-местоположение. Координаты возвращаются, если они есть в изображениях. Передайте полную ссылку на заметку с неизменённым xsec_token. Для ссылки на воспроизведение видео и комментариев нужны отдельные вызовы video и comments.

Xiaohongshu Note details читает одну заметку по её url и возвращает всё содержимое: полный текст, все изображения по порядку, темы и упомянутых пользователей, число лайков, сохранений, комментариев и репостов, а также время публикации. Если изображения содержат геоданные, возвращаются также lat и lng. Используйте эту возможность, чтобы разобрать, о чём на самом деле говорится в заметке и как её приняли, оценить посевную кампанию или превратить результаты поиска в полные тексты для анализа.

Передавайте полную ссылку на заметку, не меняя её параметры запроса, например xsec_token. Лучше всего работает свежая ссылка из результатов поиска, а один ID заметки обычно не подходит. ip_location — это регион по IP, который показывает Xiaohongshu, а не адрес, указанный автором. По ID тем в topics можно найти другие заметки на ту же тему.

Цена: $5.56 за 1 000 запросов ($0.005556 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Xiaohongshu Сведения о заметке (xiaohongshu/note).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: xiaohongshu и action: note, а параметры передайте в params.
- Обязательные параметры:
  - url: Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token.
- Возвращает один объект. Основные поля: id, url (Ссылка на запись в Xiaohongshu), title, text (Текст заметки или комментария), like_count (Число лайков), collect_count (Число сохранений), comment_count, share_count, posted_at, ip_location (Местоположение по 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"
  }
}
- Цена: $5.56 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.

Параметры запроса

Имя	Расположение	Тип	Обязательный	По умолчанию	Описание
`Authorization`	header	`string`	Да	-	Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
`platform`	body	`string`	Да	`xiaohongshu`	Идентификатор платформы, фиксированное значение.
`action`	body	`string`	Да	`note`	Идентификатор возможности, фиксированное значение.
`url`	body.params	`string`	Да	-	Полный URL заметки Xiaohongshu в формате /explore/<note_id> или /discovery/item/<note_id>. Используйте свежие URL из поиска, в которых сохранены параметры запроса вроде xsec_token. Для действия 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; скопированный код никогда не содержит ваш ключ.

Пример ответа

Реальный ответ

Получено 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 записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться.
`url`	Ссылка на запись в Xiaohongshu. Ссылки из search, note, profile и hashtag обычно содержат токен доступа, поэтому открываются в браузере без входа в аккаунт (срок действия токена ограничен; чтобы получить свежую ссылку, повторите вызов API). Ссылки на заметки из user_posts не содержат токена, а без него в браузере не открываются: вызовите note с ID заметки, чтобы получить рабочую ссылку. Ссылки на профили из search_users тоже не содержат токена; чтобы получить рабочую ссылку, вызовите profile с user_id. Ссылки на заметки из pgy_content_square содержат токен, кроме запросов с `keyword`: в них токена нет.
`title`	Заголовок. null, если на платформе нет заголовков (например, у текстовых постов).
`text`	Текст заметки или комментария. note и hashtag возвращают полный текст; search и user_posts могут вернуть сокращённый фрагмент (примерно до 60 и 100 символов соответственно). Чтобы получить полный текст, вызовите note с ID заметки.
`like_count`	Число лайков. В результатах note и в результатах по комментариям это число лайков у соответствующей записи; в profile — общее число лайков, полученных заметками аккаунта. null означает, что значение не общедоступно или не было возвращено при этом вызове; это не ноль.
`collect_count`	Число сохранений. В результатах note это число сохранений заметки; в profile — общее число сохранений всех заметок аккаунта. null означает, что значение не общедоступно или не было возвращено при этом вызове; это не ноль.
`comment_count`	Комментарии. null означает, что значение не раскрыто, а не 0.
`share_count`	Количество раз, когда записью поделились. null означает, что значение не раскрыто, а не 0.
`posted_at`	Время публикации в ISO 8601, UTC (например, 2026-08-07T12:34:56+00:00). Нестандартные строки платформы передаются как есть, поэтому учитывайте это при разборе. null означает, что платформа его не раскрывает.
`ip_location`	Местоположение по IP (провинция или страна), которое показывает Xiaohongshu; пользователь его не вводит. Есть только в некоторых записях user_posts.
`author_name`	Отображаемое имя автора.
`author_id`	ID пользователя-автора. Передавайте его в profile или user_posts. В результатах заметок используется 24-символьный ID из URL профиля; в результатах комментариев (comments, comments_batch, sub_comments) обычно другой, 29-символьный формат. Два формата для одного человека не совпадают, поэтому перед удалением дубликатов между пакетами приведите их к user_id, который возвращает profile.
`is_video`	Является ли заметка видеозаметкой. URL воспроизведения НЕ входит в ответ с деталями заметки (с 2026-10-14): чтобы получить его, вызовите отдельное действие video с тем же URL заметки; каждый вызов API оплачивается отдельно.
`avatar_url`	Ссылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
`author_url`	Ссылка на профиль автора. Она не содержит токена доступа, поэтому в браузере без входа в аккаунт не открывается; url, который profile возвращает для author_id, открывается напрямую.
`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) это ID автора комментария, в note это ID автора заметки.
`author_is_verified`	Трактуется так же, как на самой платформе
`language`	Код языка контента (например, zh, en) по определению платформы; может быть неточным.
`updated_at`	Трактуется так же, как на самой платформе

FAQ

Почему не работает просто ID заметки?

Страницам заметок Xiaohongshu нужен токен доступа, который передаётся в ссылке. Передавайте полный URL с путём /explore/<ID заметки> или /discovery/item/<ID заметки> и сохраняйте параметры запроса, например xsec_token. url в результатах поиска уже содержит токен, поэтому его можно передавать как есть.

`ip_location` — это место, где живёт автор?

Не совсем. Это регион по IP (провинция или страна), который Xiaohongshu показывает у каждой публикации. Его задаёт платформа, а не автор, поэтому он подходит для грубого регионального анализа, но точным местоположением его считать не стоит.

Почему у видеозаметки нет ссылки на видео?

Note details не возвращает ссылку на воспроизведение, а помечает видеозаметки полем is_video. Чтобы получить ссылку, вызовите Video details с тем же url заметки: эта возможность возвращает ссылку на воспроизведение и длительность видео, а этот вызов оплачивается отдельно. У видеозаметок, найденных через поиск, ссылка на воспроизведение уже есть в записях результатов.

Ошибки и оплата

401: Ключ отсутствует или недействителен.
402: Недостаточно средств на балансе. Сначала пополните баланс.
422: Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429: Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503: Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто): Нет данных. Без списания.

Ошибки