Поиск по историческим обсуждениям через Reddit Search API

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

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

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

cURL

curl --fail-with-body -H "Authorization: Bearer YOUR_API_KEY" "https://api.redditsearchapi.com/v1/search?q=quantization&subreddit=LocalLLaMA&limit=3"

Сначала определите вопрос, затем задайте фильтры

Reddit Search API предназначен для разработчиков, которым нужен программный поиск по архивным публикациям и комментариям. Это независимый исторический архив, а не официальный сервис Reddit и не источник текущих обновлений. Используйте его, когда приложению требуется обратиться к прошлым обсуждениям и показать, какие условия поиска были заданы. Наличие архива само по себе не означает полного охвата, постоянной доступности записей или неизменности результатов при повторении запроса через некоторое время.

Поисковую форму полезно строить вокруг задачи пользователя. Например, исследователь ремонта может искать упоминания замены аккумулятора в определённом сообществе за выбранный период. Фраза, название сообщества и границы дат здесь отвечают на разные вопросы, поэтому их стоит показывать отдельно. Сохраните выбранные условия рядом с выдачей, чтобы читатель не принимал результат узкого запроса за описание всех обсуждений на Reddit. Изменение фильтра должно быть заметным изменением контекста, а не скрытой особенностью интерфейса.

Показывайте границы результата вместе с самим результатом

Запросы к api.redditsearchapi.com возвращают записи в формате JSON. Для поиска доступны q, subreddit, author, kind, from, to, min_score, limit и page. Значение kind ограничивается post или comment. Даты задаются в UTC в формате YYYY-MM-DD, причём дата to включается в интервал. Минимальная оценка ограничивает состав подходящих записей, но не сортирует их: выдача следует внутреннему порядку документов архива, а не времени публикации, релевантности или величине оценки.

За один запрос можно получить не более 100 записей, а для одного набора условий доступны не более 100 страниц. Обход разрешённых страниц не доказывает, что получены все совпадения. Записи плоские: если присутствуют parent_id или link_id, приложение может связать уже полученные элементы локально. Такая группировка не восстанавливает отсутствующие сообщения и не подтверждает полноту ветки. Отмечайте эти ограничения там, где пользователь сравнивает обсуждения, считает найденные упоминания или переносит результаты в собственное исследование.

Получите ключ до оплаты и учитывайте успешные запросы

Для регистрации нужны электронная почта и пароль длиной 12–72 байта. Ключ показывается один раз сразу после регистрации, до внесения средств. Возможность получить пробные 100 кредитов зависит от общесетевых ограничений против злоупотреблений. Каждый успешный запрос на получение данных стоит один кредит, включая пустую выдачу. Цена составляет $1 за 1000 таких запросов; минимальное платное пополнение $50 даёт 50 000 кредитов. Подписки нет, оплаченные кредиты не сгорают.

Чтобы пополнить баланс, войдите в учётную запись и создайте счёт в панели на странице ключа. Переведите точную сумму на адрес получателя, указанный в счёте, выбрав USDT в сети TRON TRC20 либо USDC в основной сети Ethereum ERC20. Затем отправьте хеш транзакции на проверку. Кредиты начисляются только за подтверждённый подлинный перевод, без обещанного срока расчёта. Документация объясняет ответы 401, 402 и 429. Открытый /v1/status подтверждает ответ HTTP-приложения, но не исправность поисковой системы.