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
Отправьте точный запрос с нужным периодом и лимитом результатов, затем читайте нормализованные записи публикаций из завершенной асинхронной задачи.
- Подготовьте один непустой текстовый запрос и выберите необязательные значения published_within (период) и results_limit.
- Отправьте параметры методом POST на /v1/reddit/search и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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: публичный источник может не передавать отдельные значения.
Связанные API
Помимо 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 с цитируемыми комментариями, исходными постами и рекомендованными сабреддитами.