Redditпользователи Redditправила сабреддитовтрендыруководство по API

API пользователей Reddit: профили, история публикаций и комментариев, тренды и правила

Семь новых эндпоинтов SocQ для Reddit: профили пользователей, история публикаций и комментариев, активные сабреддиты, r/popular, трендовые запросы и правила сабреддитов, с запросами и ценами за результат.

SocQОбновлено 19 ноября 2026 г.7 мин чтения

SocQ уже поддерживал публикации, комментарии, ленты сабреддитов и поиск Reddit. 2026-11-17 добавились семь эндпоинтов, которые отвечают на другие вопросы: кто этот пользователь Reddit, что он публикует и пишет и где он активен, а также что сейчас в тренде на Reddit и что разрешено в каждом сабреддите.

В этом руководстве описано, что возвращает каждый новый эндпоинт, как выглядит запрос, сколько он стоит и когда его использовать. Об официальном API Reddit, OAuth и эндпоинтах, вышедших ранее, читайте в руководстве по API Reddit и в сравнении API для парсинга Reddit.

Коротко: отправьте имя пользователя, URL сабреддита или вообще пустой запрос на один из семи эндпоинтов POST /v1/reddit/... с заголовком Authorization: Bearer $SOCQ_API_KEY. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items. Пять эндпоинтов тарифицируются за результат (0.3 или 0.5 кредита); Active Subreddits и Trending Searches стоят 0.5 кредита за вызов. Один кредит равен $0.005.

Семь новых эндпоинтов Reddit

ЭндпоинтЧто возвращаетЦена
User ProfileКарма (за публикации и комментарии), число публикаций и комментариев, возраст аккаунта, описание, аватар, трофеи, отметки верификации и сотрудника0.5 кредита ($0.0025) за аккаунт
User PostsПубликации пользователя по сортировке new, top или hot, с полным текстом, рейтингом, комментариями и медиа0.5 кредита ($0.0025) за публикацию
User CommentsКомментарии пользователя с рейтингом, временем, ссылкой и публикацией, под которой оставлен каждый0.3 кредита ($0.0015) за комментарий
User Active SubredditsСабреддиты, в которых активен пользователь, с числом участников и описаниями0.5 кредита ($0.0025) за вызов
Popular FeedПубликации в r/popular по сортировке best, hot, new, top или rising0.5 кредита ($0.0025) за публикацию
Trending SearchesСегодняшние трендовые запросы Reddit по порядку0.5 кредита ($0.0025) за вызов
Subreddit RulesПронумерованные правила с коротким заголовком и полным текстом0.5 кредита ($0.0025) за сабреддит

Исследование пользователя Reddit

Reddit User Profile

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

curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "usernames": ["spez", "GovSchwarzenegger"]
  }'

Отправляйте до 100 имен пользователей, с префиксом u/ или без него. См. документацию User Profile.

Reddit User Posts

Reddit User Posts API получает историю публикаций пользователя с полным текстом текстовых публикаций, ссылкой на публикацию, рейтингом, числом комментариев, временем публикации и всеми изображениями или видео. Сортируйте по new, чтобы следить за тем, чем человек делится сейчас, или по top, чтобы увидеть, какие публикации зашли лучше всего.

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
  }'

sort_by принимает значения new (по умолчанию), top или hot. По умолчанию results_limit равен 25, допустимы значения от 1 до 1,000. likes_count содержит рейтинг публикации. См. документацию User Posts.

Reddit User Comments

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

curl -X POST "https://api.socq.ai/v1/reddit/user-comments" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "spez",
    "sort_by": "top",
    "results_limit": 100
  }'

По умолчанию results_limit равен 100, допустимы значения от 1 до 1,000. text содержит превью длиной до 300 символов; url открывает полный комментарий. См. документацию User Comments.

Reddit User Active Subreddits

Reddit User Active Subreddits API перечисляет сообщества, в которых пользователь недавно публиковал или комментировал, каждое с числом участников и описанием. Он показывает карту интересов человека и указывает на нишевые сообщества, которыми пользуется ваша аудитория.

curl -X POST "https://api.socq.ai/v1/reddit/user-active-subreddits" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "username": "GovSchwarzenegger"
  }'

Один запрос стоит 0.5 кредита и возвращает все сообщества из публичного списка активности аккаунта. См. документацию Active Subreddits.

Что в тренде на Reddit

Reddit Popular Feed API читает r/popular так, как его показывает Reddit: набирающие популярность публикации из всех сообществ с заголовком и текстом, ссылкой, автором, рейтингом, числом комментариев и медиа. Переключите sort_by на top и задайте published_within, чтобы увидеть, что выстрелило за день или неделю.

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
  }'

Все поля необязательны. sort_by принимает значения best, hot (по умолчанию), new, top или rising; published_within применяется к top и принимает значения от hour до all. По умолчанию results_limit равен 25, допустимы значения от 1 до 500. См. документацию Popular Feed.

Reddit Trending Searches API возвращает сегодняшние трендовые запросы в том порядке, в каком их показывает Reddit; часто это новостные события, запуски продуктов и культурные моменты прямо по ходу их развития. Опрашивайте его несколько раз в день для панели трендов, а затем углубляйтесь в тему через Reddit Search.

curl -X POST "https://api.socq.ai/v1/reddit/trending-searches" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

Входные данные не нужны. Каждый вызов возвращает текущий список, обычно шесть запросов, пронумерованных начиная с 1. См. документацию Trending Searches.

Проверка правил сабреддита перед публикацией

Reddit Subreddit Rules API возвращает одну строку на сабреддит с его пронумерованными правилами по порядку, каждое с коротким заголовком, который модераторы показывают в меню жалоб, и полным текстом правила. Бренды используют его, чтобы проверить, что разрешено, перед публикацией о запуске; команды, ведущие много аккаунтов, хранят свод правил по каждому сообществу.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-rules" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.reddit.com/r/AskReddit/"]
  }'

См. документацию Subreddit Rules.

Аутентификация и асинхронные задачи

Каждый запрос содержит ваш API-ключ и тип содержимого JSON:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый вызов отправки запускает фоновую задачу (submit -> task_id -> queued -> running -> succeeded, или failed). Ответ на отправку возвращает data.task_id и data.status. Опрашивайте задачу:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Пока задача находится в состоянии queued, running или failed, ответ содержит только метаданные задачи; при failed читайте error_message. Когда задача в состоянии succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если has_more равно true, передайте results.next_cursor как cursor. fields принимает до 50 полей или путей через точку, разделенных запятыми.

Тайм-аут на стороне клиента не отменяет задачу; продолжайте с тем же task_id, а не платите за дубликат. Также можно добавить callback_url в тело запроса, чтобы получить один POST со сводкой задачи после ее завершения.

Сколько стоит типичная задача

  • Профили 100 авторов ветки: 100 × 0.5 = 50 кредитов, $0.25.
  • Полный разбор одного пользователя (25 публикаций, 100 комментариев, активные сабреддиты): 12.5 + 30 + 0.5 = 43 кредита, $0.215.
  • Трендовые запросы четыре раза в день в течение 30 дней: 120 × 0.5 = 60 кредитов, $0.30.

FAQ

Можно ли получить данные о многих пользователях Reddit сразу?

User Profile принимает до 100 имен пользователей за запрос. User Posts, User Comments и Active Subreddits принимают по одному username, поэтому отправляйте по одной задаче на пользователя.

Возвращает ли User Comments полный текст комментария?

text содержит превью длиной до 300 символов. Поле url открывает полный комментарий, а post_id указывает публикацию, под которой он оставлен.

Popular Feed читает r/popular, где смешаны набирающие популярность публикации из всех сообществ. Чтобы читать одно сообщество, используйте Subreddit Posts.

Платить ли, если у пользователя нет публикаций?

У эндпоинтов с оплатой за результат нет базовой платы, поэтому пустой результат ничего не стоит. Active Subreddits и Trending Searches — это вызовы с фиксированной ценой 0.5 кредита.

Где сравнить поставщиков данных Reddit?

См. Альтернативы API Reddit. Все эндпоинты SocQ для Reddit представлены на странице платформы Reddit, а текущие ставки — на странице цен.

REDDIT API

Проверить сценарий на публичном URL Reddit

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

API для Reddit