rednote/
search-notes

Ищите публичные заметки Rednote по текстовому запросу с необязательными фильтрами сортировки, типа медиа и времени и получайте нормализованный контент, авторов, медиа, метки времени и видимую вовлеченность.

Rednote Search Notes API

Поиск заметок по ключевому слову
Фильтры сортировки и медиа
Публичный снимок одной страницы
1 кредит за запрос
Готово
Готово

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

README

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

Rednote Search Notes

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

Возможности Rednote Search Notes API

  • Поиск по ключевому слову с тремя фильтрамиПринимает один текстовый запрос и поддерживаемые варианты сортировки, типа медиа и периода публикации, чтобы задать точный поиск публичных заметок.
  • Нормализованные идентификаторы и контент заметокВозвращает ID заметок, публичные URL, текст, тип ресурса, время публикации и время сбора в общей структуре PostItem.
  • Контекст автора, медиа и видимой вовлеченностиСохраняет доступные публичные поля автора, ссылки на изображения или видео, хештеги, упоминания и видимое число лайков, комментариев, репостов и просмотров.
  • Ограниченная страница поиска в источникеЗапрашивает страницу 1 выбранного поиска один раз за задачу и дает четко определенный снимок, а не претендует на исчерпывающий многостраничный обход источника.

Параметры Rednote Search Notes API

ПараметрыОбязательныйОписание
queryОбязательныйОбязательный непустой текст для поиска публичных заметок Rednote; в песочнице поле остается пустым, пока вы не введете свой запрос.
sort_byНеобязательныйНеобязательный порядок результатов: general, latest или most_liked. В песочнице по умолчанию выбрано general.
media_typeНеобязательныйНеобязательный фильтр формата заметки: all, image или video. В песочнице по умолчанию выбрано all.
published_withinНеобязательныйНеобязательный фильтр периода публикации: all, day, week или six_months. В песочнице по умолчанию выбрано all.

Как использовать Rednote Search Notes API

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

  1. Подготовьте непустой query и выберите только поддерживаемые значения sort_by, media_type и published_within.
  2. Отправьте данные методом POST на /v1/rednote/search-notes и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items и следуйте next_cursor, пока has_more равно true; так листаются сохраненные результаты, а не дополнительные страницы поиска Rednote.
curl -X POST "https://api.socq.ai/v1/rednote/search-notes" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"query\":\"$REDNOTE_SEARCH_QUERY\",\"sort_by\":\"general\",\"media_type\":\"all\",\"published_within\":\"all\"}"

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Каталогизация результатов по ключевым словам: Используйте ID заметок, публичные URL, текст, ссылки на авторов и collected_at, чтобы составить отслеживаемый снимок для заданного запроса.
  • Сравнение результатов с изображениями и видео: Запускайте поиск с разными значениями media_type и сравнивайте возвращенные ссылки на медиа, текст заметок и видимую вовлеченность в полученных снимках.
  • Анализ темы с упором на свежесть: Сочетайте сортировку latest или период публикации с published_at и collected_at, чтобы изучать недавно появившиеся заметки по одной теме.
  • Анализ контекста авторов: Связывайте текст и медиа найденных заметок с доступными данными об авторах, чтобы понять, какие публичные аккаунты попадают в снимок по запросу.

Практические советы по Rednote Search Notes API

  • Обрезайте пробелы в query и проверяйте, что он не пуст, перед отправкой, чтобы проверка обязательных полей не отклонила задачу.
  • Используйте только задокументированные значения перечислений; выберите general, all и all, если нужен самый широкий явно заданный поиск.
  • Считайте каждую задачу одной страницей поиска в источнике и запускайте отдельные задачи для разных сочетаний фильтров, а не рассчитывайте, что снимок охватывает следующие страницы источника.
  • Следуйте next_cursor, пока has_more не станет false, если сохраненный снимок занимает несколько страниц результатов SocQ; этот курсор никогда не запрашивает еще одну страницу источника Rednote.
  • Сопоставляйте отдельные запуски запроса по ID и URL заметки, потому что порядок и видимые метрики могут различаться в разное время сбора.
  • Считайте текст, поля автора, медиа, время публикации, хештеги, упоминания и отдельные метрики допускающими null и экранируйте публичный текст перед выводом.

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

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

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

Rednote Search Notes API — FAQ

Rednote Search Notes API находит публичные заметки Rednote по одному текстовому запросу с необязательными фильтрами сортировки, типа медиа и периода публикации и возвращает нормализованные идентификаторы заметок, текст, данные об авторе, медиа, метки времени и поля видимой вовлеченности.

query обязателен. sort_by принимает general, latest или most_liked; media_type — all, image или video; published_within — all, day, week или six_months.

Пример по умолчанию использует query 旅行攻略 с sort_by general и media_type all, а published_within не передается. Эндпоинт не принимает results_limit, номер страницы или курсор источника.

Каждый PostItem может содержать ID заметки, URL, текст, данные об авторе, медиа, метки времени публикации и сбора, хештеги, упоминания и видимое число лайков, комментариев, репостов и просмотров. Необязательные значения источника остаются null, если они недоступны.

Нет. Каждая задача один раз запрашивает страницу 1 источника; next_cursor лишь читает следующую страницу результатов, уже сохраненных SocQ, с лимитом результатов задачи от 1 до 500 и значением 50 по умолчанию.

Каждая задача стоит фиксированный 1 кредит SocQ. Число сохраненных или возвращенных заметок не меняет эту фиксированную плату за задачу.