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.
- Подготовьте непустой query и выберите только поддерживаемые значения sort_by, media_type и published_within.
- Отправьте данные методом POST на /v1/rednote/search-notes и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 и экранируйте публичный текст перед выводом.
Связанные API
Помимо Rednote Search Notes API, используйте эти API, когда нужен другой тип публичных данных Rednote.