Reddit API Hub
Выбор языка

Сначала выберите маршрут для поиска названий сообществ

Сравните маршруты исторического архива Reddit. Найдите названия по prefix=program, затем отдельно запросите публикации, комментарии или запись по ID.

Получить API-ключ

Соотнесите маршрут с нужным результатом

Reddit API Hub помогает разработчикам сравнивать доступные маршруты независимого исторического архива Reddit. Сервис не является официальным продуктом Reddit и не связан с этой платформой. Начните с формы результата: названия сообществ, записи по условиям поиска или отдельный известный элемент. Для этих задач различаются параметры и смысл ответа. Наличие справочника маршрутов не означает, что для любой операции Reddit существует архивный аналог.

Для каталога сообществ используйте /v1/subreddits, а не поиск содержимого. Этот маршрут ищет представленные в архиве названия по префиксу. Он не возвращает тематическую иерархию, список активных сейчас сообществ или проверенную перепись всех сабреддитов. Знакомое название может отсутствовать, а доступные исторические записи — быть неполными. Не гарантированы период покрытия, постоянная доступность и неизменность результата следующего запроса.

/v1/search предназначен для текстового поиска с разрешёнными фильтрами, /v1/posts — для публикаций, /v1/comments — для комментариев. Известный идентификатор записи передавайте в /v1/item?id=..., а не как фильтр id маршрута списка. Сервис не предоставляет текущие ленты, Reddit OAuth, публикацию, голосование и личные сообщения. Публичный статус отвечает на отдельный вопрос об HTTP и не проверяет доступность поиска или баланс.

Пример запроса

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3"

Проверьте поиск названий с небольшим лимитом

Начните с GET https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3. prefix=program ограничивает начало названия сообщества, limit=3 запрашивает не более трёх элементов каталога. Это не поиск слова program в тексте публикаций и не обещание получить programming. Используйте на сервере X-API-Key: <ключ> либо Authorization: Bearer <ключ>; оба заголовка принимают ключ этого архива.

Синтетический фрагмент ответа, только для демонстрации: {"data":[{"subreddit":"programming","count":7}],"pagination":{"page":1,"limit":3,"total":null,"relation":"unknown"},"credits":{"cost":1,"balance":99}}. Запрос не выполнялся; название, число и баланс иллюстрируют только схему. Счётчики не гарантированы как глобально точные. total=null не означает ноль сообществ. Пример не подтверждает наличие реальных записей в архиве и не показывает текущее количество участников.

Сохраните возвращённые названия как кандидаты для своего интерфейса, затем предложите выбрать сообщество для отдельного запроса содержимого. Поиск сообществ принимает только prefix и limit: параметра page или курсора для полного обхода каталога нет. Короткий список не доказывает полноту охвата Reddit. При переходе к содержимому задавайте subreddit; перенос prefix в поисковый маршрут будет неправильным параметром.

Учитывайте границы выдачи и оплату

Публикации и комментарии возвращаются как плоские записи, состав полей может различаться. Присутствующие parent_id и link_id позволяют связать полученные данные локально, но не гарантируют полную беседу или цепочку родителей. Порядок _doc относится к выдаче документов, не к времени, релевантности или оценке. min_score задаёт числовой порог и не сортирует результаты. Локальная обработка не восстанавливает отсутствующий контекст автоматически.

В запросе содержимого доступно до 100 записей, page принимает от 1 до 100 в отдельных запросах. У поиска названий limit ограничивает число сообществ. Эти пределы не доказывают полноту или уникальность. Каждое успешное защищённое получение стоит один кредит, включая пустой результат и успешный повтор: $1 за 1000 запросов. Публичный /v1/status бесплатен и возвращает лишь статическое описание сервиса с HTTP-ответом.

Регистрация по электронной почте и паролю показывает ключ один раз до оплаты. Условные 100 пробных кредитов зависят от общесетевой защиты от злоупотреблений. Минимальное платное пополнение $50 даёт 50000 кредитов, без подписок и срока действия купленных кредитов. Перед переводом войдите и создайте счёт. Документация, цены, страница ключа и руководство помогут выбрать маршрут без предположений о дополнительных фильтрах или серверной аналитике.