Data Nauto.cz pro chatboty a aplikace
Veřejné API pro přesné vyhledávání vozidel
API vrací stejná aktuální vozidla jako NAVI na webu. Je pouze pro čtení, nevyžaduje přihlášení a neposkytuje telefon, e-mail, VIN ani interní údaje účtu.
Základní endpoint
Použijte buď přirozený parametr q, nebo samostatné strukturované parametry. Oba způsoby v jednom požadavku nekombinujte.
Přirozený přesný dotaz
GET https://nauto.cz/api/search/?q=žlutá%20dodávkaStejný strukturovaný dotaz
GET https://nauto.cz/api/search/?color=yellow&type=utility&body=vanPřesná pravidla výsledků
- Různé parametry se spojují jako AND: vozidlo musí splnit všechny.
- Opakované hodnoty stejného filtru jsou OR; opakovaná výbava vyžaduje všechny prvky.
- Číselné meze jsou včetně a mají pevné jednotky: Kč, km, kW a cm³.
- Nulový výsledek zůstane nulový. API nepřidává podobné ani náhradní nabídky.
- Ve výsledcích jsou pouze právě aktivní veřejné inzeráty.
- Barva, karoserie a další pole jsou údaje inzerátu, nikoli odhad z fotografie.
Strukturované parametry
Úplný kontrakt a schémata odpovědí jsou v OpenAPI specifikaci. Hodnoty, které se právě vyskytují v nabídce, vrací schema endpoint.
| Parametr | Význam | Příklad |
|---|---|---|
| type | druh vozidla | utility |
| brand | značka | Fiat |
| model | model | Dobló |
| body | karoserie | van |
| color | barva | yellow |
| fuel | palivo | diesel |
| transmission | převodovka | automatic |
| price_min / price_max | cena v Kč | 100000 |
| year_min / year_max | rok výroby | 2020 |
| mileage_max | maximální nájezd v km | 150000 |
| power_min_kw / power_max_kw | výkon v kW | 110 |
| engine_min_cc / engine_max_cc | objem v cm³ | 1968 |
| location / radius_km | lokalita a volitelný okruh | České Budějovice / 2 |
Použití v GPT nebo jiném agentovi
Jako popis nástroje použijte https://nauto.cz/openapi.json. Operace searchVehicles vrací bezpečný veřejný výstup a odkaz na každý inzerát. Před sestavením strukturovaného dotazu lze načíst /api/search/schema/.