reddit/
popular-feed

Собирайте публикации из ленты r/popular в любом из пяти порядков сортировки с заголовком и текстом, автором, рейтингом, числом комментариев и медиа, до 500 за запрос.

Reddit Popular Feed API

Без входных данных
Пять порядков сортировки
Период для top
До 500 публикаций
0,5 кредита за результат
Готово
README

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

Reddit Popular Feed

Лента популярного на Reddit, r/popular, — это поток публикаций, которые одновременно набирают обороты в сообществах всего сайта, и у каждой есть заголовок и текст, автор, рейтинг, число комментариев, время публикации и прикрепленные изображения или видео. В разных порядках сортировки и за разные периоды лента показывает, какие истории, форматы и темы прорываются на уровне всей платформы, а это помогает раньше замечать новости, исследовать форматы контента и понимать, что сейчас обсуждают на Reddit.

Возможности Reddit Popular Feed API

  • Пять способов упорядочить r/popularsort_by читает ленту в порядке best, hot, new, rising или top, а если поле не указано, используется hot.
  • Период для порядка toppublished_within ограничивает top последним часом, днем, неделей, месяцем или годом либо всем временем, по умолчанию day.
  • Полные записи публикаций с автором и медиаКаждая строка содержит text с заголовком и текстом, url публикации, имя автора и ссылку на его профиль, рейтинг в likes_count, comments_count и media с размерами в пикселях.

Параметры Reddit Popular Feed API

ПараметрыОбязательныйОписание
sort_byНеобязательныйПорядок r/popular: best, hot (по умолчанию), new, rising или top.
published_withinНеобязательныйПериод для sort_by top: hour, day (по умолчанию), week, month, year или all.
results_limitНеобязательныйМаксимальное число публикаций, целое число от 1 до 500; по умолчанию 25.

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

Выберите порядок сортировки и лимит или отправьте пустое тело запроса, затем пройдите по страницам ленты.

  1. Отправьте {"sort_by": "hot", "results_limit": 25} методом POST на /v1/reddit/popular-feed.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте публикации из results.items и загружайте следующие страницы с results.next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/reddit/popular-feed" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sort_by":"hot","results_limit":25}'

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

  • Поиск историй до пика популярности: Опрашивайте sort_by rising или new и следите за published_at, likes_count и comments_count, чтобы видеть, какие публикации набирают скорость в r/popular.
  • Еженедельная подборка лучших публикаций: Запросите sort_by top с published_within week и выведите url, text и рейтинг того, что прорвалось за последние семь дней.
  • Исследование форматов, попадающих в r/popular: Разделите публикации по типу медиа на изображения, видео и только текст, затем сравните likes_count и comments_count между группами.

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

  • Ставьте sort_by top всякий раз, когда используете published_within: период действует только для порядка top.
  • Записывайте collected_at для каждого снимка и удаляйте дубликаты по id: в быстро меняющейся ленте одна и та же публикация может попасть в несколько выборок подряд.
  • Отправляйте author.username в Reddit User Profile API, если автор появляется снова и снова, чтобы проверить его карму и возраст аккаунта.

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

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

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

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

Reddit Popular Feed API — FAQ

Reddit Popular Feed API — это программный интерфейс для сбора публикаций из ленты r/popular в выбранном порядке сортировки и за выбранный период. Он возвращает заголовок и текст каждой публикации, ссылку, автора, рейтинг, число комментариев и медиа.

Все поля необязательны: пустой запрос возвращает 25 самых горячих публикаций r/popular, а sort_by, published_within и results_limit меняют порядок, период и количество.

results_limit принимает от 1 до 500 публикаций за запрос, и каждая стоит 0,5 кредита: 25 публикаций по умолчанию обходятся в 12,5 кредита, а 500 публикаций — в 250 кредитов.