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