reddit/
search

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

Reddit Search API

Поиск публикаций
Период публикации
Контекст поиска
0,6 кредита за результат
Готово
Готово

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

README

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

Reddit Search

Результаты Reddit Search — это публичные публикации, найденные по текстовому запросу, с заголовками, текстом, авторами, контекстом сабреддита, медиа, временем публикации и видимыми сигналами голосования и комментариев. Эти записи помогают находить темы, проверять источники, исследовать заданные периоды и сравнивать вовлеченность по определенным запросам.

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

  • Поиск публикаций по запросуИспользуйте один непустой текстовый запрос, чтобы находить публичные публикации Reddit без URL публикаций или сабреддитов.
  • Фильтр по периоду публикацииОграничивайте поиск последним часом, днем, неделей, месяцем или годом либо используйте all для всего поддерживаемого периода.
  • Ограниченный объем результатовЗадайте results_limit от 1 до 2 000, чтобы управлять максимальным числом публикаций, запрашиваемых по запросу.
  • Нормализованная публикация и контекст поискаВозвращает контент публикации, поля автора и сообщества, медиа, временные метки, видимую вовлеченность и поисковый запрос в единообразной записи.

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

ПараметрыОбязательныйОписание
queryОбязательныйОбязательный непустой текст для поиска публичных публикаций Reddit.
results_limitНеобязательныйМаксимальное число запрашиваемых публикаций. По умолчанию 100, допускаются целые числа от 1 до 2 000.
published_withinНеобязательныйПериод публикации найденных публикаций. По умолчанию all; поддерживаются hour, day, week, month, year и all.

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

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

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

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • Поиск обсуждений по теме: Используйте заголовки, текст публикаций, названия сообществ и исходные URL, чтобы находить публичные обсуждения заданной темы.
  • Исследовательские датасеты с привязкой к источнику: Сохраняйте ID публикаций, URL, авторов, время публикации и discovery_input, чтобы каждая собранная запись оставалась связанной с источником и запросом.
  • Сравнение вовлеченности по периодам: Сочетайте published_within с created_at, collected_at, upvotes_count, comments_count и upvote_ratio, чтобы сравнивать ограниченные выборки результатов.

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

  • Используйте точный запрос, отражающий один исследовательский вопрос, чтобы текст найденных публикаций и контекст сообществ оставались интерпретируемыми.
  • Выбирайте published_within под нужный период; оставляйте all, если ограничение по дате публикации отсечет релевантные старые публикации.
  • Считайте results_limit верхней границей запроса и переходите по курсорам результатов задачи, пока has_more не станет false, чтобы прочитать все сохраненные результаты.
  • Удаляйте дубли повторных поисков по ID публикации, сохраняя extra.discovery_input и collected_at как контекст запроса и наблюдения.
  • Обрабатывайте поля автора, медиа, сообщества, временных меток и вовлеченности как допускающие null: публичный источник может не передавать отдельные значения.

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

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

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

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

Reddit Search API — FAQ

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

Запрос принимает query, results_limit и published_within. Поле query обязательно; эндпоинт не предоставляет параметров URL сабреддита, типа контента и сортировки.

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

published_within принимает hour, day, week, month, year или all. По умолчанию используется all.

Значение results_limit по умолчанию равно 100 и принимает целые числа от 1 до 2 000 как запрашиваемый максимум. После успешного завершения задачи продолжайте с next_cursor, пока has_more равно true, чтобы прочитать все сохраненные страницы результатов.

Каждый возвращенный нормализованный результат поиска стоит 0,6 кредита SocQ. За пустой набор результатов плата за результаты не взимается.