reddit/
subreddit-search

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

Reddit Subreddit Search API

Поиск внутри сообщества
Точечный поиск публикаций
Обсуждения в сабреддитах
0,6 кредита за результат
Готово
Готово

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

README

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

Reddit Subreddit Search

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

Возможности Reddit Subreddit Search API

  • Запрос в пределах сообществаОграничивает поиск по ключевым словам конкретными сообществами /r/{subreddit}, а не всей платформой.
  • Гибкая сортировкаСортирует найденные публикации по релевантности, популярности (hot), рейтингу (top), новизне (new) или числу комментариев под задачи исследования.
  • Гибкие фильтры по периодуФильтрует результаты по периоду публикации: час, день, неделя, месяц, год или все время.
  • Подробные данные публикацийВозвращает нормализованные записи публикаций с заголовком, текстом, автором, числом апвоутов, числом комментариев и постоянными ссылками.

Параметры Reddit Subreddit Search API

ПараметрыОбязательныйОписание
queryОбязательныйПоисковый запрос по ключевым словам, который выполняется внутри указанного сообщества-сабреддита.
urlsОбязательныйМассив URL публичных сабреддитов Reddit вида /r/{subreddit}, задающих сообщества, в которых выполняется поиск.
results_limitНеобязательныйМаксимальное число публикаций для каждого сообщества; по умолчанию 100, допустимый диапазон — от 1 до 2 000.
sort_byНеобязательныйПорядок сортировки найденных публикаций: relevance (по умолчанию), hot, top, new или comments.
published_withinНеобязательныйФильтр по периоду публикации: all (по умолчанию), year, month, week, day или hour.

Как использовать Reddit Subreddit Search API

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

  1. Задайте поисковый запрос и передайте один или несколько URL сообществ вида /r/{subreddit} в urls.
  2. При необходимости выберите sort_by (relevance, hot, top, new, comments) и published_within (от hour до all).
  3. Отправьте POST-запрос на /v1/reddit/subreddit-search с вашим API-ключом SocQ.
  4. Опрашивайте /v1/tasks/{task_id} и листайте data.results.items с помощью next_cursor.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"AI agents","urls":["https://www.reddit.com/r/technology/"],"results_limit":20,"sort_by":"relevance"}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

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

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

Практические советы по Reddit Subreddit Search API

  • Всегда передавайте полные URL вида /r/{subreddit} в массиве urls: бэкенд автоматически извлекает название сообщества.
  • Используйте этот эндпоинт вместо Reddit Search, когда нужно избежать шума из других сообществ и сосредоточиться на одном сабреддите.
  • Сортировка по comments помогает находить ветки с высокой вовлеченностью, где участники активно высказывают свое мнение.
  • Сочетайте с Reddit Comments, чтобы получить полное дерево комментариев самых релевантных найденных публикаций.

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

  • Reddit Comments API — Собирайте по поддерживаемым URL публикаций текст публичных комментариев, авторов, ссылки на публикацию и родительский комментарий, контекст сообщества, метки времени и видимую вовлеченность.
  • Reddit Subreddit Posts API — Находите публичные публикации по URL сабреддитов с сортировкой new, top или hot, лимитом результатов на сабреддит и нормализованным контекстом сообщества и вовлеченности.
  • Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
  • Reddit Subreddit Details API
  • Reddit Trending Searches API — Получайте сегодняшние трендовые запросы Reddit без входных данных, каждый с позицией и ссылкой на результаты поиска.
  • Reddit Answers API — Задайте вопрос и получите ИИ-ответ Reddit с цитируемыми комментариями, исходными постами и рекомендованными сабреддитами.

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

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

Reddit Subreddit Search API — FAQ

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

Reddit Search ищет сразу по всем публичным сабреддитам, а Reddit Subreddit Search ограничивает запрос конкретными сообществами, переданными в параметре urls.

Да. Передайте несколько ссылок на сообщества в массиве urls; эндпоинт выполнит поиск в каждом указанном сабреддите и объединит результаты.