Маршрути та автентифікація
Базова адреса — https://api.subredditdata.com. /v1/search шукає історичні записи, /v1/posts та /v1/comments обмежують вид матеріалу. Ці списки не вимагають id, тоді як /v1/item потребує id окремого запису. /v1/subreddits використовує prefix і limit для пошуку назв спільнот. Він не є повним профілем із числом учасників та історією зростання. /v1/status відкритий і не витрачає кредити.
Для захищеного читання передавайте ключ subredditdata.com без префікса в X-API-Key або альтернативно в Authorization: Bearer з тим самим секретом. Обидва способи підтримуються. Ключ і баланс іншого домену мережі не підходять цьому сайту. Кабінет використовує окрему Secure HttpOnly cookie сеансу; вона не замінює ключ у програмі отримання даних.
Параметри пошуку вмісту: q, subreddit, author, kind, from, to, min_score, limit і page. kind допускає post або comment та є необов’язковим для search. q шукає в title і text, поєднуючи кілька аналізованих слів через AND усередині поля, що збігається. Не обов’язково, щоб усі слова були в обох полях одночасно. Пошук не гарантує точну фразу чи охоплення всіх синонімів.
Кожен маршрут має свій набір параметрів: item приймає id, subreddits — prefix і limit. Невідоме ім’я параметра спричиняє помилку. Довільної мови запитів, фільтрів за parent_id, link_id, тональністю чи демографією немає. У порівняльній таблиці фіксуйте також відсутність необов’язкової умови, щоб колега міг зрозуміти відбір.
Дати, пропуски та підрахунок
from і to приймають точну дату YYYY-MM-DD та фільтрують created_utc у UTC. from починається опівночі, to включає цілу добу до 23:59:59. Наприклад, from=2026-04-01 і to=2026-04-30 задають квітневі календарні дні. Коли to дорівнює сьогодні, межа також охоплює всю поточну добу UTC, не лише час до звернення. Це не обіцянка наявності майбутніх чи пропущених записів.
Відповіді містять плоскі записи, а не складені сервером дерева обговорень. Необов’язкове поле може бути порожнім або відсутнім. parent_id і link_id допомагають зіставляти наявні записи локально, але не гарантують повноти контексту чи доступу до батьківського повідомлення. Не підміняйте пропуск вигаданим значенням і не рахуйте повторні записи як різних учасників.
limit і page мають діапазон від 1 до 100. Порядок _doc не відповідає часу, релевантності чи рейтингу, а min_score є лише числовим порогом. Перегляд усіх дозволених сторінок не є повним експортом архіву. Локальне сортування за датою впорядковує тільки отриманий матеріал, не відновлюючи відсутню активність спільноти.
У підсумках eq означає точне число для відповіді, gte — нижню межу, unknown — відсутність надійного загального числа, яке може бути null. Жоден варіант не доводить репрезентативності. Агреговані кількості для назв спільнот також не гарантовані як глобально точні. Локальний підрахунок тем має спиратися на прочитані записи з окремим обліком перетинів та виключень.
Помилки та невизначені мережеві спроби
HTTP 400 означає некоректний запит, 401 — відсутній або недійсний ключ, 402 — недостатній баланс, 429 — обмеження частоти. Виправте причину перед повтором. Помилка не доводить відсутності транспортної теми. /v1/status повертає статичне пояснення історичного сервісу та підтверджує HTTP-відповідь, не перевіряючи пошукове джерело або доступність архіву.
Успішне отримання коштує один кредит навіть за порожньої відповіді. Некоректні запити не списують кредит, збій джерела повертає резерв. Але тайм-аут клієнта або втрачена відповідь не доводять збою на сервері: запит міг успішно завершитися й бути оплаченим. Успішний повтор списується окремо. Помилка власного обробника після успіху також не скасовує вартість.
