API для розробників
Дані каталогу відкриті. Читати можна без ключа й з будь-якого домену, змінювати щось через API не можна.
GET
/api
Перелік усіх ендпоїнтів — довідка просто в JSON
GET
/api/sites
Сайти з фільтрами, пагінацією та посиланнями на сусідні сторінки
GET
/api/site/{slug}
Один сайт: опис, оцінки за критеріями, теги, стек, знімок
GET
/api/site/{slug}/similar
Схожі сайти — основа для рекомендацій
GET
/api/categories
Розділи та кількість сайтів у кожному
GET
/api/tags
Теги за популярністю
GET
/api/trending
Те, що набирає голоси просто зараз
GET
/api/top
Лідери за день, тиждень, місяць, рік або за весь час
GET
/api/people
Користувачі каталогу з їхнім внеском
GET
/api/collections
Публічні добірки
GET
/api/collection/{slug}
Добірка разом зі списком сайтів
GET
/sitemap.xml
Мапа сайту: індекс, з якого йдуть окремі файли
Формат відповіді
Кожна відповідь має поле version і заголовок API-Version.
Список приходить у data, службові числа — у meta,
посилання на сусідні сторінки — у links. Клієнту не треба
вгадувати схему параметрів: наступна сторінка вже лежить готовим посиланням.
Обмеження
Відповіді кешуються на пʼять хвилин. Жорсткого ліміту запитів немає, але будьте розважливі: каталог живе на звичайному хостингу, а не на кластері.
Умови
Користуйтесь вільно, зокрема в комерційних проєктах. Єдине прохання — посилання на WEBzo.TOP там, де показуєте наші дані.