reddit/
user-posts

Собирайте до 1 000 публикаций пользователя Reddit по одному имени с сортировкой new, top или hot и получайте заголовок и текст, итоговый рейтинг, число комментариев и медиа.

Reddit User Posts API

Имя пользователя на входе
Сортировка new / top / hot
До 1 000 публикаций
Рейтинг и комментарии
0,5 кредита за результат
Готово
Готово

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

README

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

Reddit User Posts

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

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

  • Одно имя, до 1 000 публикацийusername принимает один аккаунт с префиксом u/ или без него, а results_limit собирает от 1 до 1 000 его публикаций, по умолчанию 25.
  • Заголовок и текст в одном полеtext начинается с заголовка публикации, а у текстовых публикаций после пустой строки идет полный текст, так что одно поле содержит всю запись.
  • Итоговый рейтинг и число комментариевmetrics.likes_count — это рейтинг публикации, то есть голоса за минус голоса против, а metrics.comments_count показывает, сколько обсуждения она вызвала.
  • Изображения, галереи и видеоmedia перечисляет каждое прикрепленное изображение или видео с url, превью, шириной и высотой в пикселях — для миниатюр или скачивания.

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

ПараметрыОбязательныйОписание
usernameОбязательныйОдно имя пользователя Reddit с префиксом u/ или без него, из 3–20 букв, цифр, дефисов или подчеркиваний.
sort_byНеобязательныйПорядок публикаций: new (по умолчанию), top или hot.
results_limitНеобязательныйМаксимальное число публикаций, целое число от 1 до 1 000; по умолчанию 25.

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

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

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

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

  • Отслеживание новых публикаций аккаунта: Регулярно запускайте sort_by new и читайте published_at и url, чтобы не пропустить ни одной новой публикации основателя, журналиста или конкурента.
  • Рейтинг лучших публикаций пользователя: Запросите sort_by top и сравните likes_count с comments_count, чтобы понять, какие темы и форматы человека вызвали самый сильный отклик.
  • Корпус из разборов эксперта: Сохраняйте text текстовых публикаций вместе с url и published_at, чтобы собрать датасет подробных объяснений одного специалиста.

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

  • Делите text по первой пустой строке, чтобы отделить заголовок от основного текста; у публикаций со ссылкой или медиа есть только заголовок.
  • Проверяя аккаунт на новые публикации с sort_by new, храните уже сохраненные id и прекращайте чтение страниц, как только встретится знакомый id.
  • Собирайте то же имя через Reddit User Comments API, если нужна вся активность аккаунта: его ответы в чужих обсуждениях возвращаются там.

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

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

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

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

Reddit User Posts API — FAQ

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

Отправьте имя пользователя с sort_by new и results_limit до 1 000, затем проходите по результатам с next_cursor, пока has_more не станет false.

new выводит публикации аккаунта от новых к старым, top упорядочивает их по рейтингу, а hot следует горячему ранжированию Reddit для профиля. Если sort_by не указан, используется new.

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