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
Отправьте пустой запрос и получите текущий список трендов.
- Отправьте пустое JSON-тело {} методом POST на /v1/reddit/trending-searches.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте 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, если нужны стоящие за трендом публикации с текстом, авторами и вовлеченностью.
Связанные API
Помимо 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 с цитируемыми комментариями, исходными постами и рекомендованными сабреддитами.