API Xiaohongshu Хештег

POST

Состояние API

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

Просматривайте заметки на странице одной темы Xiaohongshu, сначала новые или самые популярные. Получите полный текст, все изображения, счётчики вовлечённости и данные видео. Передайте 24-символьный topic_id или ссылку на тему. На странице до 20 заметок, а конец списка обозначает только отсутствие next_page_token.

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

Промпт для ИИ

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

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: xiaohongshu и action: hashtag, а параметры передайте в params.
- Обязательные параметры:
  - topic_id: ID страницы темы для hashtag (24 символа) или ссылка на страницу темы, например https://www.xiaohongshu.com/page/topics/<ID>, ссылка на тему в приложении или короткая ссылка «Поделиться» Xiaohongshu.
- Необязательные параметры:
  - page_token: Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа.
  - sort: Порядок заметок темы: newest ставит первыми новые (как и без параметра), а popular ставит первыми самые популярные. При пагинации не меняйте значение. (допустимые значения: newest / popular)
- Возвращает список записей. Основные поля каждой записи: id, url (Ссылка на запись в Xiaohongshu), title, text (Текст заметки или комментария), like_count (Число лайков), collect_count (Число сохранений), comment_count, share_count, posted_at, image_url, author_name, author_id (ID пользователя-автора); всего полей: 20, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=xiaohongshu.
- Пример тела запроса:
{
  "platform": "xiaohongshu",
  "action": "hashtag",
  "params": {
    "topic_id": "5be3ef92a514290001a15147"
  }
}
- Цена: $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`	Да	`hashtag`	Идентификатор возможности, фиксированное значение.
`topic_id`	body.params	`string`	Да	-	ID страницы темы для hashtag (24 символа) или ссылка на страницу темы, например https://www.xiaohongshu.com/page/topics/<ID>, ссылка на тему в приложении или короткая ссылка «Поделиться» Xiaohongshu. Значения topics[].topic_id из note подходят напрямую. Это не ID объекта тега в заметке и не название темы.
`page_token`	body.params	`string`	Нет	-	Курсор пагинации для действий comments, sub_comments, search, user_posts, search_users и hashtag: чтобы получить следующую страницу, передайте значение next_page_token из записи предыдущего ответа; чтобы начать с первой страницы, не указывайте его. Для каждой страницы нужен один вызов API; оплата взимается за каждый запрос.
`sort`	body.params	`string (enum)`	Нет	-	Порядок заметок темы: newest ставит первыми новые (как и без параметра), а popular ставит первыми самые популярные. При пагинации не меняйте значение.Допустимые значения`newestpopular`

Примеры кода

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": "hashtag",
  "params": {
    "topic_id": "5be3ef92a514290001a15147"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

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

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

Получено October 24, 2026 at 18:28 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты); в списке оставлены первые 2. id, billing и quota меняются при каждом вызове, поэтому показана только их структура.

json

{
  "id": "req_…",
  "platform": "xiaohongshu",
  "action": "hashtag",
  "results": [
    {
      "id": "6adcf9ce000000002a02aa53",
      "url": "https://www.xiaohongshu.com/explore/6adcf9ce000000002a02aa53?xsec_token=FBguhMknWemCgqYU8sbFRwAQQTt1uvZ-Fdz-Fi4p9ejxw%3D",
      "title": "提拉米苏",
      "text": "#星巴克[话题]# #提拉米苏[话题]# #贝果三明治[话题]#",
      "like_count": 0,
      "collect_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "posted_at": "2026-10-24T18:32:47+00:00",
      "image_url": "https://sns-na-i2.xhscdn.com/1040g008326nfm9r5lq5g5pe4smi4alonjl0mrhg?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=22&sc=LF_PRV&sign=c51ee6a96b89f340c8ec4ad13fda0469&t=6add00a2",
      "author_name": "•••",
      "author_id": "•••",
      "avatar_url": "https://sns-avatar-qc.xhscdn.com/•••",
      "author_url": "https://www.xiaohongshu.com/•••",
      "is_video": false,
      "next_page_token": "n1.tWzE3OTI4NjIyOTAwMDAsIjZhZGNlODUyMDAwMDAwMDAyNTAyMjAyYyIsIkxZRG03V3VzM1ByV3JDZHNxTEtGb3ciXQ",
      "video_url": null,
      "duration_sec": null,
      "platform": "xiaohongshu",
      "images": [
        "https://sns-na-i2.xhscdn.com/1040g008326nfm9r5lq5g5pe4smi4alonjl0mrhg?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=22&sc=LF_PRV&sign=c51ee6a96b89f340c8ec4ad13fda0469&t=6add00a2",
        "https://sns-na-i2.xhscdn.com/1040g008326nfm9r5lq3g5pe4smi4alon85o1dog?imageView2/2/w/540/format/webp|imageMogr2/strip&redImage/frame/0"
      ],
      "duration_seconds": null
    },
    {
      "id": "6adcf8b3000000002a02a99b",
      "url": "https://www.xiaohongshu.com/explore/6adcf8b3000000002a02a99b?xsec_token=FBguhMknWemCgqYU8sbFRwARusWG8xYkzW1rDs95JQxQk%3D",
      "title": "",
      "text": "一顆心，只為你。#安乾镐[话题]# #keonho[话题]# #营业图[话题]# #星巴克[话题]# #热点[话题]#",
      "like_count": 3,
      "collect_count": 0,
      "comment_count": 0,
      "share_count": 0,
      "posted_at": "2026-10-24T18:28:03+00:00",
      "image_url": "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k0326nfehtr5q105q92os8tp6j1dn10jko?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=22&sc=LF_PRV&sign=bd0e8a7248ede2cf3b3bc3f1a97ed2bd&t=6add00a2",
      "author_name": "•••",
      "author_id": "•••",
      "avatar_url": "https://sns-avatar-qc.xhscdn.com/•••",
      "author_url": "https://www.xiaohongshu.com/•••",
      "is_video": false,
      "next_page_token": "n1.tWzE3OTI4NjIyOTAwMDAsIjZhZGNlODUyMDAwMDAwMDAyNTAyMjAyYyIsIkxZRG03V3VzM1ByV3JDZHNxTEtGb3ciXQ",
      "video_url": null,
      "duration_sec": null,
      "platform": "xiaohongshu",
      "images": [
        "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k0326nfehtr5q105q92os8tp6j1dn10jko?imageView2/2/w/608/format/heif/q/56|imageMogr2/strip&redImage/frame/0/enhance/4&ap=22&sc=LF_PRV&sign=bd0e8a7248ede2cf3b3bc3f1a97ed2bd&t=6add00a2",
        "https://sns-na-i2.xhscdn.com/notes_pre_post/1040g3k0326nfehtr5q1g5q92os8tp6j1l2aufco?imageView2/2/w/540/format/webp|imageMogr2/strip&redImage/frame/0"
      ],
      "duration_seconds": null
    }
  ],
  "next_page_token": …,
  "pagination": { … },
  "count": 18,
  "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 означает, что платформа его не раскрывает.
`image_url`	Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls.
`author_name`	Отображаемое имя автора.
`author_id`	ID пользователя-автора. Передавайте его в profile или user_posts. В результатах заметок используется 24-символьный ID из URL профиля; в результатах комментариев (comments, comments_batch, sub_comments) обычно другой, 29-символьный формат. Два формата для одного человека не совпадают, поэтому перед удалением дубликатов между пакетами приведите их к user_id, который возвращает profile.
`avatar_url`	Ссылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
`author_url`	Ссылка на профиль автора. Она не содержит токена доступа, поэтому в браузере без входа в аккаунт не открывается; url, который profile возвращает для author_id, открывается напрямую.
`is_video`	Является ли заметка видеозаметкой. URL воспроизведения НЕ входит в ответ с деталями заметки (с 2026-10-14): чтобы получить его, вызовите отдельное действие video с тем же URL заметки; каждый вызов API оплачивается отдельно.
`next_page_token`	Токен страницы (search, comments, sub_comments, user_posts, search_users, hashtag): чтобы получить следующую страницу, передайте его без изменений в page_token, не меняя остальные параметры.
`video_url`	Ссылка на воспроизведение видео (MP4), подписанная и с ограниченным сроком действия; если видео нужно сохранить, скачайте его сразу. null для заметок с изображениями или если значение не вернулось. Ссылка есть в записях search/user_posts и в отдельном действии video; детали заметки её не содержат (с 2026-10-14), поэтому, если нужна ссылка на воспроизведение, вызовите действие video с тем же URL заметки.
`duration_sec`	Длительность видео в секундах. null для заметок с изображениями или если длительность не была возвращена при этом вызове.
`duration_seconds`	Длительность в секундах. null для контента, который не является видео или аудио.
`platform`	Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
`images`	Ссылки на изображения. В note, hashtag, search и user_posts перечислены все изображения заметки по порядку. В результатах по комментариям (comments, comments_batch, sub_comments) перечислены изображения, прикреплённые к комментарию, включая стикеры; пустой массив означает, что их нет. null означает, что значение не было возвращено при этом вызове.

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

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

Ошибки