rednote/
search-users

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

Rednote Search Users API

Текстовый запрос
Одна страница источника
Нормализованные аккаунты
1 кредит за запрос
Готово
Готово

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

README

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

Rednote Search Users

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

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

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

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

ПараметрыОбязательныйОписание
queryОбязательныйОбязательная непустая строка, которая сопоставляется с ключевым словом поставщика. У этого эндпоинта нет полей перечислений, results_limit, курсора поставщика, сортировки или фильтра медиа.

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

Отправьте один поисковый запрос по аккаунтам, отслеживайте асинхронную задачу и читайте сохраненные нормализованные записи аккаунтов.

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

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

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

  • Короткий список авторов: Находите публичные аккаунты по имени или тематическому запросу, а затем изучайте доступные данные об аккаунте и описание профиля перед отбором кандидатов.
  • Обогащение каталога аккаунтов: Добавляйте нормализованные ID, имена пользователей, отображаемые имена, текст профиля, изображения, URL, сайты и признаки аккаунта в список найденных аккаунтов.
  • Сравнение публичных показателей аккаунтов: Используйте доступное число подписчиков, подписок и публикаций как снимки на момент collected_at, не считая их закрытой аналитикой или итогами в реальном времени.

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

  • Передавайте только query; results_limit, cursor, page, sort, filter, media_type и другие лишние поля этот эндпоинт отклоняет.
  • Считайте вызов поставщика одной фиксированной первой страницей. next_cursor общего модуля чтения задач листает сохраненные строки SocQ, а не дополнительные страницы источника Rednote.
  • Допускайте null в ID, именах пользователей, именах, тексте описания, изображениях, сайтах, признаках аккаунта и отдельных метриках, если публичный ответ их не содержит.
  • Сохраняйте collected_at вместе с видимыми счетчиками и закладывайте в бюджет фиксированные 1,00 кредита SocQ за каждую успешную задачу независимо от числа возвращенных аккаунтов.

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

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

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

Rednote Search Users API — FAQ

Rednote Search Users API находит публичные аккаунты Rednote по одному текстовому запросу и возвращает нормализованные записи аккаунтов.

Принимается ровно одна обязательная непустая строка query. Поля перечислений, results_limit, курсора поставщика, сортировки или фильтров не поддерживаются.

Нет. Вход поставщика зафиксирован на странице 1; next_cursor и has_more в общем результате задачи описывают только пагинацию по уже сохраненным записям SocQ.

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

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