Доберіть маршрут для конкретного завдання
Базова адреса API — https://api.redditsearchapi.com. Для захищених запитів на отримання даних передавайте ключ у заголовку Authorization за схемою Bearer. Маршрут /v1/search призначений для тематичного пошуку, /v1/posts повертає дописи, а /v1/comments — коментарі. Останні два маршрути не потребують id. Якщо ідентифікатор уже відомий, використовуйте /v1/item з id. Для пошуку назв спільнот за початком рядка є /v1/subreddits із prefix; він не обіцяє повного переліку всіх спільнот.
Маршрут /v1/status відкритий без ключа й не витрачає кредитів. Його статична відповідь описує незалежний історичний сервіс і засвідчує, що HTTP-застосунок відповів. Вона не перевіряє пошукове джерело, наявність окремих записів чи затримку отримання результатів. Тому відповідь цього маршруту не доводить справності пошуку після невдалого запиту. Сервіс не надає оновлень Reddit наживо, OAuth-доступу, публікації дописів, голосування або приватного листування: його призначенням є читання архівних матеріалів, а не взаємодія з поточною платформою.
Задайте умови та правильно прочитайте результат
Пошук приймає q, subreddit, author, kind, from, to, min_score, limit і page. Є лише два допустимі значення kind: post і comment. Дати задаються як YYYY-MM-DD в UTC; to включає зазначений день. У власному інтерфейсі зберігайте ці межі окремо від часу публікації запису. Це дає читачеві змогу відрізнити період дослідження від дати конкретного коментаря й не змішувати різні інтервали під час подальшого порівняння результатів між запитами або спільнотами.
Параметр min_score задає поріг оцінки, а не сортування. Видача дотримується внутрішнього порядку документів архіву. Доступні щонайбільше 100 записів у відповіді та 100 сторінок на запит. Загальна кількість збігів може бути точною, нижньою оцінкою або невідомою, зокрема null. Навіть точний підсумок не означає, що клієнт отримав усі записи. Числа в агрегації спільнот також не варто вважати гарантовано точними значеннями для всього архіву чи доказом його повного охоплення.
Розмежуйте будову даних, помилки й оплату
Відповіді містять плоскі записи, а не зібране сервером дерево розмови. Якщо повернуті об'єкти мають parent_id та link_id, клієнт може групувати їх самостійно. Фільтрів пошуку за цими полями немає. Відсутність батьківського повідомлення не дозволяє вигадувати зв'язок або вважати обговорення повним. Зберігайте початкові ідентифікатори у власному відображенні й відокремлюйте текст джерела від інтерпретацій застосунку. Висновки про тон розмови чи її учасників належать вашому аналізу, а не окремій функції API.
HTTP 400 означає некоректний запит, 401 — відсутній або недійсний ключ, 402 — недостатній баланс, 429 — обмеження частоти. Перш ніж повторювати звернення, усуньте його причину; новий успішний запит обліковується окремо. Успішне отримання даних, навіть із порожньою відповіддю, коштує один кредит. Некоректні запити не списують кредитів, а помилки джерела повертають резерв. Ключі та баланси належать цьому домену: облікові дані іншого бренду мережі не відкривають тут доступу до захищених маршрутів.
