Reddit Public Data API
Получайте публичные публикации и комментарии Reddit по известным URL, просматривайте новые, лучшие или горячие публикации сабреддитов либо ищите обсуждения по ключевому слову и периоду публикации.
Доступные API Reddit
Используйте Posts для одной известной публикации, Comments для ответов на нее, Subreddit Posts для ленты сообщества или Search для поиска по ключевым словам.

reddit/posts
Публикации0,5 кредита за результат

reddit/comments
Комментарии0,3 кредита за результат

reddit/subreddit-posts
Публикации0,5 кредита за результат

reddit/search
Поиск0,6 кредита за результат

reddit/subreddit-details
Профили0,5 кредита за результат

reddit/subreddit-search
Поиск0,6 кредита за результат

reddit/user-profile
Профили0,5 кредита за результат

reddit/user-posts
Публикации0,5 кредита за результат

reddit/user-comments
Комментарии0,3 кредита за результат

reddit/user-active-subreddits
Профили0,5 кредита за запрос

reddit/popular-feed
Публикации0,5 кредита за результат

reddit/trending-searches
Поиск0,5 кредита за запрос

reddit/subreddit-rules
Профили0,5 кредита за результат

reddit/answers
Поиск6 кредитов за результат
Какие данные Reddit можно получить?
SocQ возвращает нормализованный публичный контент Reddit с контекстом сообщества, ответов, поиска, вовлеченности и времени сбора для анализа обсуждений.
Публикации и видимая вовлеченность
Получайте заголовки, текст, авторов, флэр, контекст сообщества, медиа, исходные URL и видимые метрики с привязкой к collected_at.
Комментарии и связи ответов
Получайте текст публичных комментариев, авторов, ссылки на исходную публикацию и родительский комментарий, временные метки, апвоуты и число ответов.
Просмотр сабреддитов
Просматривайте новые, лучшие или горячие публикации по URL вида /r/{subreddit} с отдельным лимитом результатов для каждого сообщества.
Поиск по ключевым словам
Ищите публичные публикации по текстовому запросу и периоду публикации, сохраняя найденную публикацию вместе с контекстом поиска.
SocQ vs Reddit Data API
SocQ предоставляет сценарии сбора публичных данных Reddit. Reddit Data API — официальный интерфейс для одобренных приложений, которые читают или изменяют данные Reddit.
| Возможность | SocQ | Reddit Data API |
|---|---|---|
| Основное назначение | Сбор публичных публикаций, комментариев, списков сабреддитов и результатов поиска | Создание одобренных приложений, интеграций и инструментов модерации для Reddit |
| Аутентификация | API-ключ SocQ; OAuth пользователя Reddit не нужен | Одобрение Reddit, учетные данные OAuth и заявленная идентификация приложения |
| Входные данные | URL публичной публикации или сабреддита либо текстовый запрос | Эндпоинты Reddit, fullname-идентификаторы, параметры списков и scopes OAuth |
| Публикация, голосование и модерация | Не поддерживается | Поддерживается для одобренных сценариев с нужными правами пользователя |
| Формат ответа | Нормализованные записи SocQ | Нативные объекты и списки Reddit |
Как работает API Reddit
Прямой сбор, просмотр сабреддитов и поиск по ключевым словам используют один и тот же процесс: асинхронная задача и результаты с пагинацией.
1. Отправьте входные данные
Отправьте URL публикаций, URL сабреддитов или поисковый запрос в нужный API и сохраните возвращенный task_id.
2. Отслеживайте задачу
Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.
3. Получите результаты
Читайте data.results.items и используйте next_cursor, пока has_more равно true.
Пройдите аутентификацию с 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
Получайте публичные профили и заметки, ищите заметки или пользователей, собирайте комментарии и вложенные ответы и сохраняйте одну страницу рекомендаций главной ленты.