Reddit App API
RU

Исторические данные Reddit · JSON API

Добавьте поиск обсуждений Reddit в приложение

Используйте архивные записи Reddit, чтобы добавлять поиск обсуждений в веб- или мобильное приложение. Пример запрашивает одну страницу, до трёх записей.

Получить API-ключДокументация
GETJSONHTTPS
Схема запроса
Схема запроса/v1/searchidkindcreated_utctextr/SideProject
/v1/searchSideProject
01Каждый успешный запрос стоит один кредит, включая пустой результат.
100Страницы и лимиты
$1 / 1,000Оплата за запросы
01 / Reddit App API

Reddit App API — От запроса к данным для работы

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

01

Выберите записи

Запросите /v1/search с q=search и subreddit=SideProject; начните с limit=3.

02

Подготовьте ответ

Храните API-ключ на своём backend; в браузер или мобильное приложение передавайте только выбранные данные ответа.

03

Примените в проекте

Сохраняйте permalink, если он есть, вместе с заметками как ссылку на источник; сама страница позднее может быть недоступна.

Запрос, который можно адаптировать

GET /v1/search · cURL
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
  -H "Authorization: Bearer ${REDDIT_API_KEY}" \
  --data-urlencode 'q=search' \
  --data-urlencode 'subreddit=SideProject' \
  --data-urlencode 'limit=3' \
  --data-urlencode 'page=1'

Пример запрашивает одну страницу, до трёх записей.

Базовый URL APIhttps://api.redditapp.com/v1
Открыть справочник

Управляйте границами каждого запроса

Текст и сообщество

Сочетайте q с subreddit или author, чтобы сузить выборку.

Диапазон дат в UTC

Передавайте from и to в формате YYYY-MM-DD. Конечная дата включает весь день по UTC.

Страницы и лимиты

Задавайте limit и page и сохраняйте метаданные пагинации вместе с результатами.

Оплата за успешные запросы

Каждый успешный запрос стоит один кредит, включая пустой результат.

$1 за 1 000 успешных запросов

Минимальное пополнение: $50 · 50 000 кредитов

FAQ / 08

Перед интеграцией

Что такое Reddit App API?

Reddit App API — независимый JSON API исторических записей Reddit. Доступны маршруты чтения для поиска, постов, комментариев, отдельных записей и подбора сообществ. Сервис не управляется Reddit и не связан с ним. Используйте архивные записи Reddit, чтобы добавлять поиск обсуждений в веб- или мобильное приложение. Пример запрашивает одну страницу, до трёх записей.

Как получить API-ключ?

Создайте аккаунт с email и паролем на этом сайте. Ключ появится сразу после регистрации, до оплаты; сохраните его безопасно, поскольку он показывается один раз. Передавайте его с сервера через X-API-Key или Authorization: Bearer. Перевыпуск ключа делает прежний ключ недействительным.

Сколько стоит Reddit App API?

Цена — $1 за 1 000 успешных запросов. Минимальное пополнение: $50 за 50 000 кредитов. Каждый успешный запрос расходует один кредит, даже если совпадений нет. Некорректные запросы не оплачиваются; ошибки источника запускают возврат, которому может потребоваться сверка. Один тайм-аут ещё не определяет окончательное списание.

Какие фильтры доступны для поиска записей Reddit?

Используйте q для анализируемого текстового поиска вместе с subreddit, author, kind, from, to или min_score. Несколько слов сочетаются по AND; это не семантический поиск и не произвольный DSL. Даты задаются как YYYY-MM-DD в UTC, причём to включает весь конечный день. Начните с параметров из документации.

Предоставляет ли Reddit App API доступ к Reddit в реальном времени?

Нет. Сервис читает исторический архив, а не текущую ленту Reddit. Он не публикует посты, не голосует, не отправляет личные сообщения и не выполняет действия Reddit OAuth. Публичный маршрут /v1/status описывает границы сервиса, но не доказывает исправность архива, полноту покрытия или текущую доступность исходной страницы Reddit.

Можно выгрузить все записи, подходящие под запрос?

Не обязательно. За запрос возвращается до 100 записей, page принимает значения от 1 до 100. Читайте total вместе с pagination.relation: точное число, нижняя граница или неизвестно. Порядок архивный, без гарантии хронологии или релевантности. Последняя доступная страница не доказывает, что сохранённая выборка исчерпывает все совпадения.

Можно использовать тот же ключ на другом домене?

Нет. Аккаунты, API-ключи и кредитные балансы разделены по сайтам. Используйте ключ этого домена с его HTTPS API. Храните ключ в серверной конфигурации, а не в браузерном JavaScript, публичном репозитории или общем журнале. Ключ другого сайта не заменяет местный аккаунт.

Какой запрос попробовать первым?

Начните с /v1/search, q=search, subreddit=SideProject, limit=3 и page=1. Маленький ответ позволяет проверить поля до разработки импорта или интерфейса. Успешный запрос всё равно стоит один кредит, даже при пустом результате. Меняйте тему и сообщество под свою задачу: пример не обещает фиксированного числа записей.

API / Reddit App API

Соберите первый запрос

Создайте аккаунт, сохраните ключ и адаптируйте пример под свою задачу.

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

Продолжить с руководством

Добавьте остановку для чтения в подготовку к походуПустой список не должен объяснять все исходыТуристу нужно поле поиска, а не ваш ключ архива«Показать ещё» должно означать одну осознанно выбранную страницуПланируйте бюджет запросов приложения, а не видимых записейДата должна объяснять источник, а не украшать карточкуПусть карточка объясняет действительно полученную записьСохраняйте ссылку, не обещая вечной доступностиРазработка функцииРуководства