Za partnere i AI asistente
Javni API pretrage.
Isti API koji pokreće wagen.hr i aplikaciju. Samo čitanje, bez ključa, odgovor u JSON-u. Namijenjen AI asistentima, agregatorima i medijima koji žele točne, žive podatke o vozilima u Hrvatskoj. Za veći volumen ili pisanje (objava oglasa, DMS sync) javite se na kontakt@wagen.hr.
Pretraga oglasa
GET https://wagen.hr/api/searchOdgovor: hits (oglasi s naslovom u dva reda, cijenom, kilometražom, godištem, gorivom, mjenjačem, snagom, lokacijom, prodavačem i naslovnom fotografijom), total, page, totalPages, facets (broj oglasa po marki, modelu, gorivu, karoseriji, vrsti…) i parsed (kako je AI razumio slobodan tekst). Cijene su u eurima bez decimala. Stranica oglasa: https://wagen.hr/oglas/{slug}.
| Parametar | Značenje |
|---|---|
| q | Slobodan tekst; AI sloj ga pretvara u filtere (npr. "dizel karavan do 15.000 € u Zagrebu"). |
| category | putnicki (zadano) · motocikli · transportni · kamperi |
| make, model | Marka (jedna) i model (više puta). Vrijednosti iz faceta odgovora. |
| vehicle | Do 3 kombinacije marka/model, oblik "Marka|Model1,Model2". |
| year_from, year_to | Godište prve registracije. |
| price_from, price_to | Cijena u eurima, cijeli brojevi. |
| km_from, km_to | Kilometraža. |
| power_from, power_to | Snaga u kW. |
| fuel | benzin · dizel · hibrid · plug-in-hibrid · elektricni · plin · cng (više puta) |
| transmission | rucni · automatski |
| drive | prednji · straznji · 4x4 (više puta) |
| body_type | limuzina · karavan · hatchback · suv · coupe · kabriolet · monovolumen · kombi · pickup (više puta) |
| color | Boja, vrijednosti iz faceta (više puta). |
| subtype, body_variant | Vrsta unutar kategorije (naked, skuter, kombi-dostavno, kamion…) i nadgradnja transportnih. |
| ccm_from, ccm_to | Obujam motora (motocikli). |
| payload_from, gvw_to, seats_from | Nosivost, dopuštena masa i sjedala (transportni). |
| beds_from, length_to | Ležaji i duljina u cm (kamperi). |
| vat_deductible | true = samo vozila u sustavu PDV-a (R1). |
| seller, dealer | private · dealer; dealer = slug salona. |
| country, county, city | Država (ISO-2), županija (više puta, ključevi iz faceta), grad. |
| damaged | hide (zadano) · only · include |
| sort | newest (zadano) · price_asc · price_desc · km_asc · year_desc · distance (uz near_lat i near_lng; pogoci tada nose distance_km) |
| page, limit | Stranica od 1; limit 1–50 (zadano 20). |
Primjer:
https://wagen.hr/api/search?category=putnicki&make=Volkswagen&model=Golf&price_to=15000&county=grad-zagreb&sort=price_asc&limit=5Kategorije
GET https://wagen.hr/api/kategorijeJavno aktivne kategorije sa slugom, nazivom i putanjom hub stranice. Kategorija postaje javna kad ima dovoljno oglasa.
Strukturirani podaci i sitemap
Svaka stranica oglasa nosi schema.org Car / Motorcycle / Vehicle JSON-LD s ponudom (Offer), motorom, karoserijom, kilometražom, bojom, stanjem i prodavačem (AutoDealer s adresom i telefonom).
https://wagen.hr/sitemap.xmlPravila korištenja
- Podaci su vlasništvo prodavača i wagen.hr; dopušteno je prikazivanje s poveznicom na oglas, nije dopušteno preprodavanje baze ni gradnja konkurentskog oglasnika.
- Razuman ritam upita (do 60 u minuti po IP-u); za veći volumen dogovaramo ključ i feed.
- Fotografije su potpisani URL-ovi s rokom trajanja; ne pohranjujte ih, dohvaćajte ih iz odgovora.
- Uvjeti su u Uvjetima korištenja.