Сначала определите форму ответа
До составления запроса назовите результат, который нужен приложению. Список названий сообществ отличается от подходящих публикаций, комментариев и одного известного элемента. Reddit API Hub предоставляет отдельные маршруты для этих задач. Выбор маршрута определяет параметры и форму ответа, но не обещает производительность, полный охват или замену любой операции официального API Reddit. Оценивайте возможности по фактическому контракту, а не по сходству названий.
Начните каталог с https://api.redditapihub.com/v1/subreddits?prefix=program&limit=3. Запрос просит не более трёх сообществ, чьи названия начинаются с program. Он не ищет слово в тексте публикаций, не обещает вернуть programming и не определяет активные сегодня сообщества. Сохраните названия как кандидаты; пропуски архива и негарантированно точные счётчики ограничивают выводы, которые можно сделать из такого поиска.
Для этого маршрута доступны только prefix и limit. Постраничного обхода полного списка сообществ нет. Если ответ содержит truncated=true, зафиксируйте ограничение вместо создания несуществующего токена следующей страницы. Неизвестный итог, возможно null, не равен нулю. Возвращённое название можно передать в subreddit отдельного запроса содержимого; при переходе между маршрутами меняется набор допустимых параметров.
Выберите тип содержимого или известный идентификатор
Используйте /v1/search для текстовых и других разрешённых условий по публикациям и комментариям. /v1/posts ограничивает выдачу публикациями, /v1/comments — комментариями. Разрешены q, subreddit, author, kind, from, to, min_score, limit и page. Значения kind — post и comment. Результат состоит из совпавших записей, а не статистического отчёта или собранного дерева обсуждения; дальнейший анализ выполняется в вашей системе.
При использовании поиска важно помнить, что результаты выдаются в порядке _doc, который не является ни хронологическим, ни релевантным, ни сортированным по оценке. Это означает, что порядок получения данных зависит от внутренней структуры архива, а не от времени публикации или популярности. Разработчикам необходимо учитывать эту специфику при обработке массивов результатов, чтобы правильно структурировать информацию для последующего анализа и визуализации в своих приложениях. from и to фильтруют created_utc в формате YYYY-MM-DD UTC, включая последний день целиком. min_score задаёт только числовой порог, без оценки надёжности совета.
Для известного идентификатора используйте /v1/item?id=... с единственным параметром id. URL не заменяет этот параметр. Наличие записи не гарантируется, а её получение не загружает автоматически родителей или ответы. При работе с содержимым можно локально связывать присутствующие parent_id и link_id, оставляя неразрешённые ссылки видимыми. Это не доказывает полной беседы и не восполняет отсутствующие в архиве материалы.
Рассчитайте стоимость процесса и сохраните ограничения
Храните ключ на сервере и передавайте X-API-Key: <ключ> или Authorization: Bearer <ключ>. Независимый исторический архив не принимает Reddit OAuth и не предоставляет живые обновления, запись, голосование или личные сообщения. Публичный /v1/status бесплатен и не требует ключа, но лишь описывает сервис и подтверждает HTTP-ответ. Он не сообщает, выполнится ли поиск содержимого и достаточно ли кредитов на счёте.
Страница содержимого содержит до 100 записей, page не превышает 100 в отдельных запросах. Читайте total вместе с relation: eq — точный итог для запроса, gte — нижняя граница, unknown — ненадёжное значение или null. Ни один итог не доказывает полной выгрузки. Дробление дат и локальное удаление дублей организуют работу, но не гарантируют охват, уникальность или стабильность следующей выдачи.
Каждый успешный поиск сообществ, запрос страницы, отдельной записи или повтор стоит один кредит, включая пустой результат. Некорректные запросы не списываются, сбой источника возвращает резерв; потерянный ответ может скрывать оплаченный успех. Различайте 400, 401, 402 и 429 и ограничивайте повторы. До оплаты прочитайте цены и страницу ключа: $1 за 1000 успешных запросов, минимум $50 для покупки и условная выдача пробных кредитов.
