reddit/
trending-searches

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

Reddit Trending Searches API

Без входных данных
Ранжированный список
Ссылки на результаты поиска
0,5 кредита за запрос
Готово
README

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

Reddit Trending Searches

Трендовые запросы Reddit — это короткий список, обычно около шести поисковых фраз, которые Reddit сегодня отмечает как популярные, где у каждой есть позиция и ссылка на результаты поиска, а сами фразы часто называют новостные поводы, запуски продуктов и культурные моменты по мере их развития. Если снимать этот список в течение дня, видно, что люди на Reddit активно ищут, и это нужно для панелей мониторинга трендов, своевременного планирования контента и оповещений, когда отслеживаемая тема выходит в тренды.

Возможности Reddit Trending Searches API

  • Не нужно готовить входные данныеТело запроса пустое, поэтому вызов можно запускать из планировщика без всякой настройки.
  • Порядок как в списке Redditrank начинается с 1 и следует порядку, в котором Reddit выводит трендовые запросы.
  • Ссылка на поиск для каждого запросаkeyword содержит поисковый запрос, а url открывает результаты поиска Reddit по нему, так что каждый тренд ведет прямо к стоящим за ним обсуждениям.

Параметры Reddit Trending Searches API

Можно отправлять

Этому эндпоинту не нужны параметры запроса. Отправьте пустой JSON-объект как есть.

{}

Как использовать Reddit Trending Searches API

Отправьте пустой запрос и получите текущий список трендов.

  1. Отправьте пустое JSON-тело {} методом POST на /v1/reddit/trending-searches.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте keyword и rank из results.items; если has_more равно true, получите остальное с results.next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Сценарии использования Reddit Trending Searches API

  • История трендов: Сохраняйте keyword, rank и collected_at при каждом запуске, чтобы строить графики того, как долго темы держатся в списке и как поднимаются или опускаются.
  • Планирование своевременных публикаций и статей: Каждое утро проверяйте текущие keyword, чтобы решить, каким развивающимся темам стоит посвятить публикацию, пункт рассылки или разъясняющий материал в тот же день.
  • Оповещения по отслеживаемым темам: Сравнивайте каждый keyword со списком брендовых, продуктовых или отраслевых терминов и уведомляйте команду, когда один из них попадает в тренды.

Практические советы по Reddit Trending Searches API

  • Используйте как ключ хранимых строк keyword вместе с collected_at: id совпадает с поисковым запросом, а один и тот же запрос появляется и в более поздних снимках.
  • Передавайте keyword в Reddit Search API как query, если нужны стоящие за трендом публикации с текстом, авторами и вовлеченностью.

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

  • Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
  • Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
  • Reddit Subreddit Details API
  • Reddit Subreddit Search API
  • Reddit Popular Feed API — Собирайте публикации r/popular в порядке hot, best, new, rising или top: заголовок и текст, автор, рейтинг, комментарии и медиа.
  • Reddit Answers API — Задайте вопрос и получите ИИ-ответ Reddit с цитируемыми комментариями, исходными постами и рекомендованными сабреддитами.

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

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

Reddit Trending Searches API — FAQ

Reddit Trending Searches API — это программный интерфейс для получения поисковых запросов, которые Reddit сегодня показывает как трендовые, без каких-либо входных данных. Он возвращает каждый запрос с его позицией и ссылкой на результаты поиска Reddit.

Обычно шесть: это текущий список в том виде, в каком его показывает Reddit, с позициями от 1 в его порядке.

Фиксированные 0,5 кредита за вызов, независимо от числа запросов в списке.