Правильный способ интеграции с Reddit зависит от того, что на самом деле делает ваш продукт. У бота модерации, установленного внутри сообщества, некоммерческого OAuth-клиента, академического исследования и коммерческого продукта для социального мониторинга разные пути доступа и разные обязанности.
В этом руководстве описаны текущие официальные варианты Reddit и показано, как получать публичные публикации, комментарии, ленты сабреддитов, метаданные сабреддитов и результаты поиска через SocQ, когда вашему приложению нужен управляемый эндпоинт данных только для чтения.
Коротко: используйте официальную Developer Platform Reddit для приложений, которые работают внутри Reddit, и подавайте заявку на официальный Data API, если ваш сценарий соответствует его политикам. Используйте SocQ, когда нужны один API-ключ и нормализованные публичные записи Reddit вместе с другими социальными платформами. Ни один из этих путей не дает права игнорировать условия Reddit, требования к удаленному контенту, права на конфиденциальность или ограничения на обучение моделей.
Требования к доступу и политики проверены 19 июля 2026. Reddit может менять правила одобрения и лимиты, поэтому перед запуском сверьтесь с официальной документацией по ссылкам.
Какой API Reddit выбрать?
Сейчас Reddit описывает несколько отдельных интерфейсов для разработчиков:
| Продукт | Для чего предназначен | Важное ограничение |
|---|---|---|
| Developer Platform (Devvit) | Игры, утилиты и приложения для модерации, работающие внутри Reddit | Приложение создается для работы в Reddit |
| Data API | Одобренный программный доступ для чтения или изменения данных Reddit | Действуют OAuth, проверка, политики и лимиты запросов |
| Reddit for Researchers | Академические исследования, отвечающие требованиям | Официальный путь для исследований; нужна заявка |
| Ads API | Рекламодатели, управляющие кампаниями и отчетностью | Рекламные сценарии, а не общие данные сообществ |
| Reddit Embeds | Показ отдельного контента Reddit | Отображение, а не массовый доступ к данным |
| Управляемый API публичных данных | Продуктовые сценарии, которым нужны публичные записи в стабильной схеме | Покрытие и условия поставщика всё равно действуют |
В обзоре доступа для разработчиков Reddit сказано, что Data API предназначен для одобренных разработчиков, а академические исследования должны идти через Reddit for Researchers. Коммерческое использование требует разрешения Reddit и договора.
Поэтому выбор API стоит начинать с классификации сценария использования, а не с библиотеки кода.
Требования официального Reddit Data API в 2026 году
Для бесплатного использования Data API, отвечающего требованиям, Reddit сейчас требует зарегистрированный OAuth-токен и содержательный User-Agent. Трафик без аутентификации может блокироваться, а не получать стандартный лимит.
В официальной вики Reddit Data API указан лимит 100 запросов в минуту на один OAuth client ID в среднем за десятиминутное окно. Клиентам следует читать:
X-Ratelimit-UsedX-Ratelimit-RemainingX-Ratelimit-Reset
Не считайте 100 QPM универсальным коммерческим тарифом. Это опубликованный лимит для пользователей, которым положен бесплатный доступ. Reddit указывает, что коммерческое использование — включая платные продукты, продукты с рекламой, сервисы по подписке и платные услуги — требует предварительного разрешения. Расширенный или платный доступ оформляется отдельно, а не через публичную таблицу цен с самостоятельным подключением.
Reddit также требует обрабатывать удаления. Согласно текущим рекомендациям, сохраненный контент, удаленный с Reddit, нужно удалить и из ваших систем, а информацию, идентифицирующую автора удаленного аккаунта, — убрать. Документация рекомендует регулярно удалять сохраненные пользовательские данные и контент в течение 48 часов, чтобы упростить соблюдение требований.
Пример аутентификации в официальном API
Установленное приложение или скрипт обычно обменивает учетные данные клиента и авторизацию пользователя на OAuth-токен, а затем отправляет этот токен на oauth.reddit.com.
Упрощенный запрос выглядит так:
curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
-H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
-H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"
Продакшен-клиентам нужно:
- Зарегистрироваться и получить одобрение для правильного сценария использования.
- Реализовать подходящий тип OAuth-гранта.
- обновлять истекающие токены, где это поддерживается.
- Отправлять правдивый уникальный User-Agent.
- Соблюдать заголовки лимита запросов и снижать частоту до исчерпания лимита.
- Обрабатывать удаления и изменения политик.
Python-разработчики часто используют PRAW, который берет на себя объекты списков, пагинацию и детали OAuth. Прямые HTTP-запросы уместны, когда нужно меньше зависимостей, но они не снимают никаких обязательств по политикам.
Получение публикации Reddit по URL через SocQ
Reddit Posts API от SocQ принимает URL публичных публикаций Reddit и короткие ссылки redd.it. Он возвращает нормализованные заголовок, текст, автора, контекст сообщества, временные метки, ссылки на публичные медиа и видимые показатели вовлеченности.
curl -X POST "https://api.socq.ai/v1/reddit/posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
Запрос создает асинхронную задачу. Сохраните возвращенный task_id, затем опрашивайте:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Когда задача завершится успешно, записи будут в data.results.items. Продолжайте с next_cursor, пока has_more равно true.
Запись публикации имеет ту же общую структуру, что и другие ресурсы SocQ:
{
"id": "post_id",
"platform": "reddit",
"resource": "posts",
"type": "post",
"url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
"name": "Example post title",
"text": "Example post body",
"author": {
"username": "example_user",
"name": "example_user"
},
"metrics": {
"upvotes_count": 842,
"comments_count": 54,
"upvote_ratio": 0.96
},
"created_at": "2026-07-16T08:00:00Z",
"collected_at": "2026-07-19T08:00:00Z",
"extra": {
"tag": "Discussion",
"community_name": "learnpython"
}
}
Видимые оценки — это снимки, а не постоянная истина. Reddit может искажать (fuzz) счетчики голосов, контент может редактироваться или удаляться, а повторный сбор может дать другой результат.
Получение комментариев Reddit
Используйте Reddit Comments API, когда нужно публичное обсуждение под известными URL публикаций:
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
]
}'
Нормализованные записи комментариев включают:
- ID, URL и текст комментария.
- Публичные поля автора, если они доступны.
- Видимые счетчики апвоутов и ответов.
- Ссылки на исходную публикацию и сообщество.
- ID родительского комментария, если он доступен.
- Временные метки публикации и сбора.
Текущий эндпоинт SocQ не принимает параметр results_limit. Не рассчитывайте, что будут возвращены все видимые ветки, свернутые ответы, удаленные комментарии, элементы, доступные только модераторам, или результаты с динамическим ранжированием. Если полное восстановление ветки обсуждения — жесткое требование, протестируйте показательные глубокие и большие ветки до выбора поставщика.
Новые, топовые и горячие публикации сабреддита
Для мониторинга сообществ Reddit Subreddit Posts API принимает один или несколько URL публичных сабреддитов. sort_by поддерживает new, top и hot; results_limit принимает значения от 1 до 2 000 на каждый отправленный сабреддит.
curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.reddit.com/r/learnpython/",
"https://www.reddit.com/r/webdev/"
],
"sort_by": "new",
"results_limit": 250
}'
Выбирайте сортировку осознанно:
| Сортировка | Лучшее применение | Ограничение |
|---|---|---|
new | Инкрементальный мониторинг и оповещения | Больше малоинформативных публикаций |
hot | Текущее внимание сообщества | Ранжирование постоянно меняется |
top | Поиск публикаций с высокой вовлеченностью | Может перепредставлять старый или уже популярный контент |
Для мониторинга собирайте new по расписанию и удаляйте дубликаты по ID публикации. Используйте hot или top как отдельное представление для поиска контента, а не перезаписывайте ими хронологическую ленту.
Поиск публикаций Reddit по ключевому слову
Reddit Search API принимает запрос, лимит результатов от 1 до 2 000 и период публикации:
curl -X POST "https://api.socq.ai/v1/reddit/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "\"social listening\" API",
"results_limit": 500,
"published_within": "month"
}'
Поддерживаемые периоды: hour, day, week, month, year и all.
Результаты поиска — это ранжированная выдача для поиска контента, а не гарантированно исчерпывающий архив. Синтаксис запроса, ранжирование, доступность и индексация влияют на покрытие. Выполняйте несколько узких запросов, а не рассчитывайте, что один широкий запрос охватит все обсуждение.
Например, для мониторинга бренда используйте набор запросов:
"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative
Сохраняйте запрос в контексте поиска, чтобы аналитики могли объяснить, почему каждая запись попала в датасет.
Сведения о сабреддите и поиск внутри сабреддита
Еще два эндпоинта посвящены самому сообществу. Reddit Subreddit Details API принимает URL публичных сабреддитов и возвращает метаданные: число подписчиков, еженедельно активных пользователей, правила и ресурсы сообщества. Это недорогой способ оценить сообщество, прежде чем ставить его на мониторинг.
Reddit Subreddit Search API ищет публичные обсуждения и публикации внутри одного конкретного сабреддита по запросу, периоду и порядку сортировки. Используйте его, когда упоминания бренда важны только в нескольких сообществах и поиск по всему Reddit их похоронит. Точные входные поля смотрите на странице каждого эндпоинта.
Надежный пайплайн мониторинга Reddit
Устойчивый рабочий процесс разделяет сбор, хранение и анализ:
Query/subreddit registry
↓
Scheduled SocQ submissions
↓
Task polling with backoff
↓
Normalize + deduplicate by Reddit ID
↓
Deletion/retention controls
↓
Classification, alerts and reporting
Рекомендуемые правила реализации:
- Используйте стабильные ID. URL и слаги могут меняться; ID Reddit лучше подходят как ключи для удаления дубликатов.
- Сохраняйте контекст источника. Записывайте сабреддит, запрос, сортировку и время сбора.
- Отделяйте снимки от сущностей. Метрики меняются, а ID публикации остается стабильным.
- Повторяйте задачи, а не отдельные записи. Экспоненциальная задержка между попытками предотвращает повторные отправки.
- Фиксируйте отсутствующие и удаленные состояния. Не превращайте отсутствие в пустую, но валидную публикацию.
- Минимизируйте персональные данные. Большинству аналитических задач не нужны долгосрочные истории по отдельным авторам.
- Предусмотрите путь удаления. Модель данных должна позволять удалять контент и ссылки на авторов.
Официальный API Reddit vs SocQ
| Требование | Официальный API Reddit | SocQ |
|---|---|---|
| Приложение или инструмент модератора внутри Reddit | Лучший вариант | Не поддерживается |
| Чтение и действия записи в Reddit | Поддерживается при наличии одобрения и scopes | Только чтение публичных данных |
| OAuth и регистрация приложения Reddit | Обязательны | API-ключ SocQ |
| Нормализация публичных публикаций и комментариев | Нативные объекты Reddit | Общая схема SocQ |
| Продукт для нескольких соцсетей | Отдельные интеграции | Одна модель задач на 27 платформах |
| Опубликованный бесплатный лимит | 100 QPM для OAuth-клиентов, отвечающих требованиям | Цены эндпоинтов в каталоге SocQ |
| Коммерческое разрешение | Нужно получить разрешение или договор Reddit | Доступ через поставщика не отменяет правила Reddit |
| Академические исследования | Обязателен Reddit for Researchers | Не используйте для обхода политик |
Выбирайте официальный путь, если ваш продукт выполняет действия с авторизацией пользователя, модерацию, публикацию, голосование, обмен сообщениями или глубокие нативные интеграции с Reddit. Выбирайте SocQ для поддерживаемого сбора публичных данных, когда нормализованные записи по нескольким платформам и управляемое извлечение важнее доступа на запись.
Оценка нагрузки и стоимости
Не сравнивайте поставщиков только по «запросам». Один запрос может вернуть одну публикацию, страницу комментариев или сотни результатов из сабреддита.
Оцените:
monthly records =
direct post lookups
+ comments returned
+ subreddit posts returned
+ search results returned
monthly workload =
schedules × inputs per run × average records per input
Затем учтите:
- Пустые или недоступные результаты.
- Частоту обновления.
- Пересечения в поиске и удаление дубликатов.
- Глубокие ветки комментариев.
- Хранение и обработку удалений.
- Требования к параллельности и задержке.
- Оплачиваются ли только успешные результаты.
Проведите показательный пилот на маленьких и больших сообществах, прежде чем прогнозировать годовые расходы.
Ответственное использование и хранение данных
Публичная доступность — не универсальное разрешение на любое использование. Текущие политики Reddit ограничивают коммерческий доступ без одобрения и запрещают использовать контент Reddit для обучения моделей без явного согласия. Они также налагают обязанности по удалению.
Постройте следующие механизмы контроля до масштабирования:
- Собирайте только поля, необходимые для заявленной цели.
- Избегайте профилирования по чувствительным признакам и преследования отдельных людей.
- Не используйте API для обхода ограничений сабреддитов или аккаунтов.
- Сохраняйте указание источника там, где контент показывается.
- Устанавливайте короткие сроки хранения для сырого контента.
- Перепроверяйте или удаляйте контент, который больше недоступен.
- Защищайте API-ключи и проверяйте доступ к выгрузкам.
- Получайте юридическую оценку для коммерческих, исследовательских или высокорисковых сценариев.
SocQ — технический уровень доступа, а не предоставление прав интеллектуальной собственности, прав на конфиденциальность, исследовательских или коммерческих прав.
API Reddit: FAQ
API Reddit бесплатный?
Reddit предлагает бесплатный и платный доступ в зависимости от сценария использования. Для бесплатных клиентов Data API, отвечающих требованиям, сейчас опубликован лимит 100 QPM на один OAuth client ID. Коммерческое использование требует разрешения Reddit и может потребовать договора и оплаты.
Можно ли использовать API Reddit без OAuth?
Не стройте архитектуру в расчете на доступ без аутентификации. Текущая документация Reddit требует зарегистрированные OAuth-токены и указывает, что трафик без OAuth или учетных данных для входа будет блокироваться.
Можно ли парсить Reddit для обучения ИИ?
Reddit указывает, что его контент нельзя использовать как входные данные для обучения моделей без явного согласия. Сторонний API это ограничение не снимает.
Поддерживает ли SocQ комментарии Reddit?
Да. У SocQ шесть эндпоинтов Reddit: публикации по ссылкам, комментарии по URL публикаций, поиск публикаций в сабреддитах, сведения о сабреддите, поиск по ключевым словам по всему Reddit и поиск внутри одного сабреддита.
Может ли SocQ публиковать, голосовать или модерировать в Reddit?
Нет. Эндпоинты SocQ для Reddit собирают поддерживаемые публичные записи. Для авторизованных действий записи и модерации используйте официальные продукты Reddit для разработчиков.
Результаты поиска Reddit исчерпывающие?
Нет. Рассматривайте поиск как ранжированную выдачу. Результаты зависят от запроса, периода, индексации и доступности; это не полный исторический архив.
Что происходит, когда пользователь Reddit удаляет контент?
Ваша система должна уметь удалять контент и связанную с ним информацию, идентифицирующую автора. Официальные рекомендации Reddit советуют регулярно удалять сохраненные пользовательские данные и контент в течение 48 часов, чтобы упростить соблюдение требований.
REDDIT API
Проверить сценарий на публичном URL Reddit
Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.
API для Reddit