reddit/
subreddit-posts

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

Reddit Subreddit Posts API

URL сабреддита на входе
new, top или hot
Лимит на сабреддит
0,5 кредита за результат
Готово
Готово

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

README

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

Reddit Subreddit Posts

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

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

  • Поиск публикаций в списках сабреддитовНаходит публичные публикации по допустимым URL вида /r/{subreddit}; для всех сабреддитов в запросе выбирается список new, top или hot.
  • Глубина сбора для каждого сабреддитаПрименяет results_limit к каждому переданному URL сабреддита отдельно: по умолчанию 100, допустимый диапазон — от 1 до 2 000.
  • Нормализованный контент и авторы публикацийВозвращает идентификаторы публикаций, исходные URL, заголовки, текст, доступные поля автора и ссылки на медиа в единообразной структуре записи.
  • Контекст сообщества и вовлеченностиСохраняет с каждой публикацией флэр, сведения о сообществе, время публикации и сбора, upvotes_count, comments_count, upvote_ratio и discovery_input.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список URL публичных сабреддитов Reddit с точным путем /r/{subreddit} на поддерживаемом хосте Reddit.
results_limitНеобязательныйМаксимальное число публикаций, запрашиваемых для каждого URL сабреддита; по умолчанию 100, допускаются целые числа от 1 до 2 000.
sort_byНеобязательныйСписок, применяемый ко всем переданным URL сабреддитов; по умолчанию new, поддерживаются new, top и hot.

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

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

  1. Подготовьте один или несколько URL публичных сабреддитов Reddit с путем /r/{subreddit}.
  2. Отправьте urls, results_limit и sort_by методом POST на /v1/reddit/subreddit-posts, затем сохраните возвращенный 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/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.reddit.com/r/learnpython/"],"results_limit":100,"sort_by":"new"}'

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

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

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

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

  • Отправляйте канонический URL главной страницы /r/{subreddit}, а не название сабреддита, URL публикации или более глубокий путь, чтобы запрос прошел проверку URL.
  • Считайте запрашиваемую глубину как число urls, умноженное на results_limit: лимит и оценка кредитов применяются к каждому сабреддиту отдельно.
  • Запускайте отдельные задачи для сравнения new, top и hot: одно значение sort_by применяется ко всем URL сабреддитов в запросе.
  • Сохраняйте discovery_input и collected_at с каждой записью, чтобы в последующих датасетах сохранялись исходный сабреддит и время наблюдения.
  • Допускайте, что поля автора, медиа, флэра, сообщества, временных меток и вовлеченности могут быть null или пустыми, если публичный список их не показывает.

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

  • Reddit Posts API — Собирайте по поддерживаемым URL Reddit текст публичных публикаций, авторов, контекст сообщества, медиа, метки времени и видимую вовлеченность.
  • Reddit Comments API — Собирайте по поддерживаемым URL публикаций текст публичных комментариев, авторов, ссылки на публикацию и родительский комментарий, контекст сообщества, метки времени и видимую вовлеченность.
  • Reddit Search API — Ищите публичные публикации Reddit по текстовому запросу и периоду публикации и получайте нормализованный контент, авторов, контекст сообщества, метки времени, медиа и видимую вовлеченность.
  • Reddit Subreddit Details API
  • Reddit User Posts API — Собирайте историю публикаций пользователя Reddit по одному имени с сортировкой new, top или hot: заголовок и текст, рейтинг, комментарии и медиа.
  • Reddit Popular Feed API — Собирайте публикации r/popular в порядке hot, best, new, rising или top: заголовок и текст, автор, рейтинг, комментарии и медиа.

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

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

Reddit Subreddit Posts API — FAQ

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

Отправьте URL с http или https на поддерживаемом хосте Reddit, путь которого — ровно /r/{subreddit}, с необязательной косой чертой в конце. Названия сабреддитов, URL публикаций и более глубокие пути не принимаются.

sort_by поддерживает new, top и hot, по умолчанию — new. Запрос не принимает параметр периода для списков top.

Значение results_limit по умолчанию равно 100 и принимает значения от 1 до 2 000. Оно применяется к каждому URL отдельно, поэтому два URL с results_limit 50 запрашивают до 100 публикаций.

Нет. Каждая публикация может содержать comments_count, но результат не включает текст комментариев и их авторов.

Данные автора, медиа, флэр, контекст сообщества, время публикации и значения вовлеченности могут быть null или пустыми, если публичный список не показывает пригодное значение.

Каждая возвращенная запись публикации стоит 0,5 кредита SocQ. Предварительная оценка рассчитывается как urls, умноженное на results_limit, а за пустой набор результатов плата за результаты не взимается.