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
Выбирайте только проверенные необязательные значения, отправьте асинхронный запрос и читайте сохраненные стандартные результаты.
- Начните со значений бэкенда по умолчанию или явно задайте category, media_type и results_limit.
- Отправьте JSON-тело методом POST на /v1/rednote/home-recommendations и сохраните data.task_id из ответа на отправку.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 за задачу: сумма не зависит от выбранного лимита и числа возвращенных элементов.
Связанные API
Помимо Rednote Home Recommendations API, используйте эти API, когда нужен другой тип публичных данных Rednote.