rednote/
home-recommendations

Собирайте одну публичную страницу рекомендаций главной ленты Rednote без исходного запроса и читайте нормализованные поля публикации, автора, медиа, вовлеченности и времени сбора.

Rednote Home Recommendations API

Без исходных данных
Одна страница ленты
Нормализованные публикации
1 кредит за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Rednote Home Recommendations

Запрос рекомендаций главной ленты получает одну публичную страницу ленты Rednote без профиля, URL заметки или поисковой фразы. Каждый доступный элемент приводится к стандартной записи публикации с идентификацией источника, текстом, автором, медиа, видимой вовлеченностью, временем публикации и временем сбора.

Возможности Rednote Home Recommendations API

  • Запрос главной ленты без исходных данныхОтправьте пустое тело или проверенную категорию homefeed_recommend, чтобы запросить одну текущую страницу рекомендаций, не придумывая пользователя или запрос.
  • Ограниченный размер страницыЗапрашивайте целое число от 1 до 40; если значение не указано, используется 20, а возвращенная страница может содержать меньше публичных элементов.
  • Структура публикации, не зависящая от провайдераЧитайте доступные идентификационные данные заметки, текст, автора, медиа, временные метки и видимые метрики через общую схему публикации, а не через названия полей провайдера.
  • Надежные асинхронные результатыОтправьте запрос один раз, следите за статусом задачи и листайте записи, сохраненные SocQ после нормализации единственного ответа провайдера.

Параметры Rednote Home Recommendations API

ПараметрыОбязательныйОписание
categoryНеобязательныйНеобязательная непустая строка. Если она не указана, сопоставление с провайдером подставляет homefeed_recommend. Это единственная определенная в бэкенде категория, описанная здесь; другие строки не считаются проверенными категориями.
media_typeНеобязательныйНеобязательное enum-значение: all, image или video. Текущее сопоставление устанавливает флаг изображений у провайдера только для image; all и video оба дают false, поэтому video не гарантирует ответ только из видео.
results_limitНеобязательныйНеобязательное положительное целое число от 1 до 40. По умолчанию 20; задает запрашиваемый у провайдера размер страницы и ограничивает число сохраненных строк, если указано явно.

Как использовать Rednote Home Recommendations API

Выбирайте только проверенные необязательные значения, отправьте асинхронный запрос и читайте сохраненные стандартные результаты.

  1. Начните со значений бэкенда по умолчанию или явно задайте category, media_type и results_limit.
  2. Отправьте JSON-тело методом POST на /v1/rednote/home-recommendations и сохраните data.task_id из ответа на отправку.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items; переходите по next_cursor, только если has_more указывает на дополнительные записи, сохраненные в SocQ.
curl -X POST "https://api.socq.ai/v1/rednote/home-recommendations" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"homefeed_recommend","media_type":"all","results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items; next_cursor paginates stored results only

Сценарии использования Rednote Home Recommendations API

  • Снимки страницы рекомендаций: Сохраняйте ограниченную публичную страницу главной ленты вместе с collected_at, чтобы каждый элемент был привязан к одному наблюдению.
  • Редакционные очереди находок: Передавайте нормализованный текст публикаций, авторов и ссылки на медиа в процесс ручной проверки или классификации.
  • Аудит видимого контента: Сравнивайте доступный состав медиа и публичные поля вовлеченности между отдельно отправленными задачами рекомендаций.

Практические советы по Rednote Home Recommendations API

  • Отправляйте {}, если нужны все значения провайдера по умолчанию: публичный валидатор запросов не требует ни одного поля.
  • Оставляйте category равным homefeed_recommend, если вы не проверили другую категорию провайдера самостоятельно: среда выполнения принимает любую непустую строку, но не публикует перечень категорий.
  • Относитесь к media_type=video осторожно: сейчас это значение сопоставляется с тем же флагом провайдера, что и all; изменяет этот флаг только image.
  • Выбирайте results_limit от 1 до 40 и не рассчитывайте, что провайдер вернет ровно запрошенное число публичных элементов.
  • Не отправляйте курсор провайдера: исполнитель на стороне источника делает один запрос и читает items, notes или feeds из этого единственного ответа.
  • Используйте next_cursor только для перехода по результатам, сохраненным в SocQ после успешного завершения; он не загружает другую страницу Rednote.
  • Закладывайте в бюджет фиксированно 1,00 кредита SocQ за задачу: сумма не зависит от выбранного лимита и числа возвращенных элементов.

Помимо Rednote Home Recommendations API, используйте эти API, когда нужен другой тип публичных данных Rednote.

Другие платформы

Объединяйте данные Rednote с публичными данными других поддерживаемых соцсетей.

Rednote Home Recommendations API — FAQ

Rednote Home Recommendations API собирает одну публичную страницу рекомендаций главной ленты Rednote в виде нормализованных записей публикаций.

Нет. Все три поддерживаемых поля необязательны, а пустое JSON-тело использует категорию провайдера homefeed_recommend и размер запроса в 20 элементов.

Публичный валидатор принимает любую непустую строку category, но бэкенд определяет стабильным значением по умолчанию только homefeed_recommend. На этой странице не заявляются дополнительные категории на основе внешних исследований.

Валидатор принимает video, но текущее преобразование для провайдера сопоставляет video и all с одним и тем же значением флага false. Изменяет этот флаг только image, поэтому ответ только из видео не гарантируется.

Нет. Вызов провайдера возвращает одну страницу; next_cursor относится к общему механизму чтения результатов задач SocQ и только листает записи, уже сохраненные для завершенной задачи.

Нет. Он не принимает состояние входа, идентификацию пользователя, действия с аккаунтом, команды публикации и инструменты модерации.

Каждая задача стоит фиксированно 1,00 кредита SocQ независимо от results_limit и числа возвращенных записей.