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
Выберите порядок сортировки и лимит или отправьте пустое тело запроса, затем пройдите по страницам ленты.
- Отправьте {"sort_by": "hot", "results_limit": 25} методом POST на /v1/reddit/popular-feed.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Читайте публикации из 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, если автор появляется снова и снова, чтобы проверить его карму и возраст аккаунта.
Связанные 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 без входных данных, каждый с позицией и ссылкой на результаты поиска.