Ко всем API
Публичные данные Reddit

Reddit Public Data API

Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.

Доступные API Reddit

Используйте Posts для одной известной публикации, Comments для ответов на нее, Subreddit Posts для ленты сообщества или Search для поиска по ключевым словам.

Какие данные Reddit можно получить?

SocQ возвращает нормализованный публичный контент Reddit с контекстом сообщества, ответов, поиска, вовлеченности и времени сбора для анализа обсуждений.

Публикации и видимая вовлеченность

Получайте заголовки, текст, авторов, флэр, контекст сообщества, медиа, исходные URL и видимые метрики с привязкой к collected_at.

Комментарии и связи ответов

Получайте текст публичных комментариев, авторов, ссылки на исходную публикацию и родительский комментарий, временные метки, апвоуты и число ответов.

Просмотр сабреддитов

Просматривайте новые, лучшие или горячие публикации по URL вида /r/{subreddit} с отдельным лимитом результатов для каждого сообщества.

Поиск по ключевым словам

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

SocQ vs Reddit Data API

SocQ предоставляет сценарии сбора публичных данных Reddit. Reddit Data API — официальный интерфейс для одобренных приложений, которые читают или изменяют данные Reddit.

ВозможностьSocQReddit Data API
Основное назначениеСбор публичных публикаций, комментариев, списков сабреддитов и результатов поискаСоздание одобренных приложений, интеграций и инструментов модерации для Reddit
АутентификацияAPI-ключ SocQ; OAuth пользователя Reddit не нуженОдобрение Reddit, учетные данные OAuth и заявленная идентификация приложения
Входные данныеURL публичной публикации или сабреддита либо текстовый запросЭндпоинты Reddit, fullname-идентификаторы, параметры списков и scopes OAuth
Публикация, голосование и модерацияНе поддерживаетсяПоддерживается для одобренных сценариев с нужными правами пользователя
Формат ответаНормализованные записи SocQНативные объекты и списки Reddit

Как работает API Reddit

Прямой сбор, просмотр сабреддитов и поиск по ключевым словам используют один и тот же процесс: асинхронная задача и результаты с пагинацией.

  1. 1. Отправьте входные данные

    Отправьте URL публикаций, URL сабреддитов или поисковый запрос в нужный API и сохраните возвращенный task_id.

  2. 2. Отслеживайте задачу

    Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.

  3. 3. Получите результаты

    Читайте data.results.items и используйте next_cursor, пока has_more равно true.

Поиск публичных обсуждений Reddit

Пройдите аутентификацию с API-ключом SocQ и отправьте ключевое слово с периодом публикации. Остальные API Reddit работают по той же схеме задач.

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"machine learning","results_limit":100,"published_within":"month"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Типичные сценарии использования API Reddit

Мониторинг сообществ

Собирайте новые, лучшие или горячие публикации выбранных сабреддитов и сравнивайте видимую активность разных сообществ.

Анализ обсуждений и реакций

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

Исследование тем и рынка

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

Исследовательские архивы и датасеты

Сохраняйте публичные публикации, комментарии, ссылки на источник, контекст сообщества, временные метки и видимые метрики для воспроизводимого анализа.

Ограничения и политика публичных данных

Результаты Reddit — это публичные записи на момент сбора. Эти API не дают доступа к закрытым сообществам, удаленному контенту, данным аккаунтов и инструментам модерации.

  • Posts и Comments принимают поддерживаемые URL публикаций или ссылки redd.it. Subreddit Posts требует точный путь /r/{subreddit}.
  • Subreddit Posts поддерживает сортировку new, top или hot, а results_limit применяется к каждому URL сабреддита отдельно.
  • Search принимает один запрос, results_limit от 1 до 2 000 и период публикации hour, day, week, month, year или all. Фильтры по сабреддиту и сортировке недоступны.
  • Posts и Comments остаются отдельными ресурсами: публикация содержит comments_count, но не отдельные записи комментариев.
  • Comments возвращает видимые публичные комментарии, но не гарантирует полное дерево ответов или всю историческую глубину обсуждения.
  • Видимые метрики — это снимки с привязкой к collected_at. Необязательные поля могут быть null или пустыми, если публичный источник их не показывает.

Частые вопросы об API Reddit

Что такое API Reddit?

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

Какие ссылки Reddit принимаются?

Posts и Comments принимают поддерживаемые пути /r/{subreddit}/comments/{post_id} или ссылки redd.it. Subreddit Posts принимает точный путь /r/{subreddit}.

Какой API Reddit выбрать?

Используйте Posts для известной публикации, Comments для ответов на нее, Subreddit Posts для списка публикаций сообщества и Search для поиска по ключевым словам.

Чем просмотр сабреддитов отличается от поиска по Reddit?

Subreddit Posts просматривает новые, лучшие или горячие публикации по точным URL вида /r/{subreddit}. Search находит публичные публикации по одному текстовому запросу и периоду публикации.

Полны ли комментарии и метрики вовлеченности Reddit и обновляются ли они в реальном времени?

Нет. Comments отражает видимые публичные ответы, полученные на момент сбора, а значения вовлеченности — это снимки на определенный момент, а не полная история или поток в реальном времени.

Сколько стоит сбор данных Reddit?

Каждый результат Posts или Subreddit Posts стоит 0,5 кредита, каждый комментарий — 0,3 кредита, а каждый результат Search — 0,6 кредита; за пустой набор результатов плата за результаты не взимается.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

Pinterest API

Получайте публичные данные профилей Pinterest, разбирайте известные пины, собирайте пины выбранных профилей или ищите по ключевым словам, чтобы исследовать авторов, контент и визуальные тренды.

Threads API

Получайте публичные профили Threads, разбирайте известные публикации или собирайте публикации выбранных профилей с нормализованными полями идентификации, контента, медиа, вовлеченности и временных меток.

Bluesky API

Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.

Snapchat API

Получайте известный публичный ролик Snapchat Spotlight в виде нормализованной записи с доступными полями автора, подписи, медиа, аудио, временных меток, длительности и вовлеченности.

Twitch API

Превращайте известное публичное имя пользователя Twitch в нормализованный профиль, собирайте его публичные видео или получайте отдельный клип вместе со скачиваемым видео для исследования авторов, обогащения каталогов, сравнения и мониторинга снимков.

Rednote API

Получайте публичные профили и заметки, ищите заметки или пользователей, собирайте комментарии и вложенные ответы и сохраняйте одну страницу рекомендаций главной ленты.