Il nostro catalogo tecnico auto, disponibile via API
Marche, modelli, allestimenti e schede tecniche complete — una banca dati di nostra proprietà, costruita da fonti pubbliche e mantenuta aggiornata. Integrabile nel tuo software, portale o app.
Gerarchia marca → modello → allestimento con anni, segmento e carrozzeria.
Potenza, coppia, cambio, trazione, dimensioni, bagagliaio, consumi WLTP, CO₂, batteria e autonomia per gli elettrici.
Prezzo del nuovo stimato e valutazione dell'usato per anno, km e condizione, con tracciamento della fonte.
Endpoint pubblici · API v1
Base URL https://quiconcessionario.it/api/v1 ·
REST, risposta JSON, sola lettura.
| Metodo | Endpoint | Descrizione |
|---|---|---|
| GET | /api/v1 | Indice e descrizione delle risorse |
| GET | /api/v1/stats | Statistiche del catalogo |
| GET | /api/v1/brands | Elenco marche (filtri q, country) |
| GET | /api/v1/brands/{marca} | Marca con elenco modelli |
| GET | /api/v1/models/{marca}/{modello} | Modello con allestimenti e scheda completa |
| GET | /api/v1/trims/{id} | Allestimento singolo con valutazione usato |
| GET | /api/v1/compare | Confronto diretto di allestimenti (max 6) |
| GET | /api/v1/search | Ricerca + faceting/aggregazioni e ordinamento |
| GET | /api/v1/valuation | Valutazione usato parametrica (anno, km, condizione) |
| GET | /api/v1/changes | Sync incrementale: modifiche dopo un timestamp |
| GET | /api/v1/me | La tua chiave: piano, limiti e consumo |
| GET | /api/v1/openapi.json | Specifica OpenAPI 3.1 (machine-readable) |
Esempi di codice
curl -H "X-API-Key: qc_..." "https://quiconcessionario.it/api/v1/search?fuel=elettrica&facets=brand"const r = await fetch("https://quiconcessionario.it/api/v1/search?fuel=elettrica&facets=brand", {
headers: { "X-API-Key": "qc_..." }
});
const data = await r.json();import requests
r = requests.get("https://quiconcessionario.it/api/v1/search?fuel=elettrica&facets=brand",
headers={"X-API-Key": "qc_..."})
data = r.json()$res = Http::withHeaders(['X-API-Key' => 'qc_...'])
->get('https://quiconcessionario.it/api/v1/search?fuel=elettrica&facets=brand')->json();
Endpoint di lettura, con rate limit e quota. Risposte con ETag /
Cache-Control (304 Not Modified), errori in formato Problem Details (RFC 9457), CORS abilitato.
Piani e limiti
Accesso pubblico per provare, piani a chiave per la produzione. Quota al minuto e mensile per piano.
Chiave nell'header X-API-Key ·
consumo e residui visibili su /api/v1/me ·
header X-RateLimit-* e X-Quota-* in ogni risposta.
Per i concessionari: integrazione & widget
- ▸ Scrittura stock:
POST /api/v1/dealer/vehicles(chiave con scopewrite:stock) - ▸ Auto-compilazione scheda da targa/VIN e dal catalogo (allestimenti via
/api/v1/models/{id}/trims) - ▸ Feed dello stock:
/feed/dealer/{slug}/feed.json|xml(formati marketplace) - ▸ Webhook firmati (lead, pubblicazione, prezzo) e chiavi self-service dal pannello concessionario
Widget da incorporare
<!-- Valutazione usato -->
<iframe src="https://quiconcessionario.it/widget/valutazione" width="100%" height="520" style="border:0"></iframe>
<!-- Badge valore usato -->
<iframe src="https://quiconcessionario.it/widget/badge?trim_id=123&year=2020&km=60000" width="220" height="110" style="border:0"></iframe>Per chi è
- ▸ Concessionari e gestionali che vogliono auto-compilare le schede veicolo
- ▸ Portali e marketplace che servono dati tecnici aggiornati
- ▸ App, comparatori e configuratori di terze parti
- ▸ Periti, assicurazioni e servizi finanziari
Come funziona
API REST v1 di sola lettura, risposta JSON, endpoint per marche, modelli, allestimenti, ricerca, valutazione usato e statistiche. In licenza commerciale: chiave API dedicata, quote più alte, SLA e cache locale via ETag/304. Disponibile la specifica OpenAPI 3.1 e una collection Postman per generare client automaticamente. Copertura attuale: 192 marche, 2.066 modelli e 4.334 allestimenti — in costante aggiornamento.