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 целевых сообществ как асинхронную задачу, затем получите найденные публикации.
- Задайте поисковый запрос и передайте один или несколько URL сообществ вида /r/{subreddit} в urls.
- При необходимости выберите sort_by (relevance, hot, top, new, comments) и published_within (от hour до all).
- Отправьте POST-запрос на /v1/reddit/subreddit-search с вашим API-ключом SocQ.
- Опрашивайте /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, чтобы получить полное дерево комментариев самых релевантных найденных публикаций.
Связанные API
Помимо 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 с цитируемыми комментариями, исходными постами и рекомендованными сабреддитами.