Reddit App API
UK

Історичні дані 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-ключ

Продовжити з посібником

Додайте зупинку для читання до підготовки подорожіНе змушуйте порожній список пояснювати кожен результатМандрівникові потрібне поле пошуку, а не ваш ключ архіву«Показати ще» має означати одну свідомо вибрану сторінкуПлануйте бюджет запитів застосунку, а не того, що бачить читачДата має пояснювати матеріал, а не прикрашати карткуНехай кожна картка пояснює справді отриманий записЗберігайте посилання без обіцянки вічної доступностіРозробка функціїПосібники