API EshopRadaru
Veřejné JSON API jen pro čtení. Data jsou pod licencí CC BY 4.0 – uveďte „EshopRadar (eshopradar.cz)“. Co znamenají jednotlivá čísla, popisuje metodika. Hromadná data jsou jednodušší stáhnout jako CSV.
Endpointy
| Metoda a cesta | Co vrací |
|---|---|
GET /api/plugins?page=N | doplňky (50 na stránku): název, slug, autor, kategorie, hodnocení a počet recenzí z marketplace, odkaz |
GET /api/plugins/{slug} | detail doplňku, počet e-shopů v databázi a ukázka až 10 e-shopů |
GET /api/tools | nástroje mimo marketplace: počet e-shopů, zvlášť v kódu stránky a jen v Google Tag Manageru, a počet změřených e-shopů |
GET /api/tools/{slug} | detail nástroje a ukázka až 10 e-shopů |
GET /api/authors | autoři doplňků: počet doplňků, průměrné hodnocení, počet recenzí |
GET /api/authors/{slug} | detail autora a jeho doplňky |
GET /api/shops?page=N | analyzované e-shopy (20 na stránku): název, URL, tarif, hodnocení obchodu, datum aktualizace |
GET /api/shops/search?q=… | vyhledání e-shopu podle názvu nebo domény (max. 10 výsledků) |
GET /api/shops/{slug}/status | textový popis a SEO údaje e-shopu |
Limity a pravidla
- API je jen pro čtení. Novou analýzu e-shopu spouští formulář na úvodní stránce; je omezená na 5 analýz za hodinu z jedné IP adresy a má denní strop, protože ji zpracovává AI.
- Odpovědi se ukládají do mezipaměti až na 10 minut. Pro hromadné zpracování použijte CSV na stránce Data.
- Při zátěži si vyhrazujeme právo omezit počet požadavků (HTTP 429).
- Skryté profily (majitel profil skryl) API nevrací.