{"openapi":"3.1.0","info":{"title":"DealerMax Italia — Search API per ChatGPT","description":"API pubbliche del network DealerMax per ChatGPT Custom GPT Actions. Ricerca cross-dealer su veicoli usati, offerte di noleggio a lungo termine (NLT), directory concessionari attivi in Italia. Dati live aggregati da 27+ dealer del network. Read-only, pubblico, rate-limited. Same-origin dealer wrapper: this schema is served from https://www.matareseautomobili.it and its Actions paths are proxied to the read-only DealerMax public plane.","version":"1.0.0","contact":{"name":"DealerMax — Azure Automotive","url":"https://dealermax.app","email":"info@dealermax.app"},"license":{"name":"Proprietary (Read-only public API)","url":"https://dealermax.app/terms"},"x-privacy-policy":"https://dealermax.app/privacy"},"servers":[{"url":"https://www.matareseautomobili.it","description":"Dealer same-origin Custom GPT Actions proxy"}],"paths":{"/public/custom-gpt/search-vehicles-network":{"post":{"operationId":"searchVehiclesNetwork","summary":"Cerca veicoli usati nella rete DealerMax","description":"Semantic search cross-dealer su veicoli usati e km0. Filtra per marca, alimentazione, budget massimo, regione/provincia/citta. Ritorna lista con prezzo EUR, km, anno, dealer di pertinenza (nome + citta + provincia), URL canonico al sito dealer per dettaglio + contatto.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleSearchRequest"}}}},"responses":{"200":{"description":"Lista veicoli trovati","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleSearchResponse"}}}},"429":{"description":"Rate limit exceeded (60/min/IP). Retry-After header."},"503":{"description":"Search backend temporarily unavailable."}}}},"/public/custom-gpt/search-nlt-offers-network":{"post":{"operationId":"searchNltOffersNetwork","summary":"Cerca offerte NLT (autovetture + veicoli commerciali)","description":"Semantic search cross-dealer su offerte NLT del network. Catalogo unificato AUTOVETTURE + VEICOLI COMMERCIALI ≤35 q.li (furgoni, cassonati, multispazio, pickup, bus). Filtra per canone mensile massimo, durata contratto (36/48/60 mesi), regione, query semantica, vehicle_type (auto/vcom), vcom_type macro tipo commerciale. Ritorna canone EUR mensile, durata, km/anno inclusi, dealer di pertinenza, link offerta, vehicle_type per discriminare auto vs commerciali.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NltSearchRequest"}}}},"responses":{"200":{"description":"Lista offerte NLT trovate","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NltSearchResponse"}}}},"429":{"description":"Rate limit exceeded."},"503":{"description":"Search backend unavailable."}}}},"/public/custom-gpt/get-vehicle-details":{"post":{"operationId":"getVehicleDetails","summary":"Dettaglio completo veicolo usato","description":"Scheda completa veicolo usato: specs tecniche (motore, consumi, dimensioni), prezzo, dealer di pertinenza con contatti + indirizzo + rating, gallery immagini, podcast audio e video se disponibili. Input UUID veicolo o slug friendly.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VehicleDetailsRequest"}}}},"responses":{"200":{"description":"Dettaglio veicolo"},"404":{"description":"Veicolo non trovato"},"429":{"description":"Rate limit exceeded."}}}},"/public/custom-gpt/get-nlt-offer-details":{"post":{"operationId":"getNltOfferDetails","summary":"Dettaglio offerta NLT + 18 quotazioni","description":"Dettaglio completo offerta NLT: 18 quotazioni complete (3 durate 36/48/60 mesi × 6 fasce km/anno 10k/15k/20k/25k/30k/40k), 3 scenari anticipo (zero/medio/standard), accessori inclusi, servizi (manutenzione, assicurazione), tag, gallery, dealer del network che propongono l'offerta.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NltOfferDetailsRequest"}}}},"responses":{"200":{"description":"Dettaglio NLT con quotazioni"},"404":{"description":"Offerta NLT non trovata"},"429":{"description":"Rate limit exceeded."}}}},"/public/custom-gpt/find-dealer-in-region":{"post":{"operationId":"findDealerInRegion","summary":"Trova concessionari attivi DealerMax","description":"Directory dealer attivi del network DealerMax filtrabili per regione/provincia/citta italiana e marca trattata. Ritorna anagrafica completa: nome, indirizzo, telefono, email, Google Maps, sito web, rating e recensioni.","x-openai-isConsequential":false,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FindDealerRequest"}}}},"responses":{"200":{"description":"Lista dealer trovati"},"429":{"description":"Rate limit exceeded."}}}}},"components":{"schemas":{"VehicleSearchRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":2,"maxLength":500,"description":"Query semantica italiana (es. 'SUV ibrido familiare', 'berlina diesel automatica')."},"region":{"type":"string","description":"Filtro geografico: regione ('Lombardia'), codice provincia 2 lettere ('MI'), provincia ('Milano'), o citta ('Cusago'). Case-insensitive."},"brand":{"type":"string","description":"Marca veicolo (case-insensitive). Es. 'BMW', 'Mercedes', 'Toyota'."},"fuel_type":{"type":"string","enum":["benzina","diesel","ibrida","elettrica","gpl","metano"],"description":"Tipo alimentazione."},"budget_max":{"type":"integer","minimum":0,"description":"Budget massimo in EUR (prezzo vendita IVA inclusa)."},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10,"description":"Numero massimo risultati."}}},"VehicleSearchResponse":{"type":"object","properties":{"mode":{"type":"string","enum":["semantic","fallback_fulltext"]},"query":{"type":"string"},"total":{"type":"integer"},"hits":{"type":"array","items":{"$ref":"#/components/schemas/VehicleHit"}}}},"VehicleHit":{"type":"object","properties":{"id_auto":{"type":"string"},"title":{"type":"string"},"snippet":{"type":"string"},"marca":{"type":"string"},"modello":{"type":"string"},"allestimento":{"type":"string"},"anno":{"type":"integer"},"km":{"type":"integer"},"prezzo_eur":{"type":"number"},"fuel_type":{"type":"string"},"transmission":{"type":"string"},"url":{"type":"string"},"image_url":{"type":"string"},"dealer":{"$ref":"#/components/schemas/DealerStub"},"score":{"type":"number"}}},"NltSearchRequest":{"type":"object","required":["query"],"properties":{"query":{"type":"string","minLength":2,"maxLength":500,"description":"Query semantica (es. 'SUV diesel automatico per famiglia')."},"canone_max":{"type":"integer","minimum":0,"description":"Canone mensile massimo in EUR (es. 500)."},"durata_max_mesi":{"type":"integer","enum":[36,48,60],"description":"Durata contratto massima."},"region":{"type":"string","description":"Filtro geografico dealer."},"segmento":{"type":"array","items":{"type":"string","enum":["suv-compatti","suv-piccoli","suv-medi","suv-grandi","utilitarie","superutilitarie","medio-inferiori","medie","superiori","fuoristrada","multispazio"]},"description":"Filtra per categoria autovettura (slug Motornet). Applicabile solo se vehicle_type='auto' o non specificato. Allineato a /noleggio-lungo-termine/autovetture/<slug>."},"alimentazione":{"type":"array","items":{"type":"string","enum":["elettrico","ibrido-benzina","ibrido-diesel","benzina","diesel","gpl","metano"]},"description":"Filtra per alimentazione (slug). Allineato a /noleggio-lungo-termine/alimentazione/<slug>."},"cambio":{"type":"array","items":{"type":"string","enum":["automatico","automatico-sequenziale","automatico-doppia-frizione","cvt","manuale"]},"description":"Filtra per cambio (slug)."},"vehicle_type":{"type":"string","enum":["auto","vcom"],"description":"Macro categoria: 'auto' (autovetture: SUV, berline, utilitarie) o 'vcom' (veicoli commerciali ≤35 quintali: furgoni, cassonati, multispazio, pickup, bus). Default omesso = catalogo misto. Usa 'vcom' per query tipo 'furgone diesel', 'cassonato per cantiere', 'pickup 4x4 lavoro'."},"vcom_type":{"type":"array","items":{"type":"string","enum":["furgoni","cassonati","multispazio","pickup","bus"]},"description":"Filtra VCOM (≤35q.li) per macro tipo Motornet. Applicato solo se vehicle_type='vcom' o non specificato. Allineato a /noleggio-lungo-termine/veicoli-commerciali/<slug>."},"min_seats":{"type":"integer","minimum":1,"description":"Numero minimo di posti a sedere. Es. 7 per monovolume / van 9 posti / NCC (7-9 posti), 9 per soli 9 posti. Ogni hit espone i posti effettivi nel campo 'seats'. Allineato al filtro sito '7 o + posti'."},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}}},"NltSearchResponse":{"type":"object","properties":{"mode":{"type":"string"},"query":{"type":"string"},"total":{"type":"integer"},"hits":{"type":"array","items":{"$ref":"#/components/schemas/NltHit"}},"network_total_offers":{"type":"integer"}}},"NltHit":{"type":"object","properties":{"id_offerta":{"type":"string"},"slug":{"type":"string"},"marca":{"type":"string"},"modello":{"type":"string"},"versione":{"type":"string"},"fuel_type":{"type":"string"},"transmission":{"type":"string"},"snippet":{"type":"string"},"image_url":{"type":"string"},"canone_mensile_min_eur":{"type":"number"},"quotazioni":{"type":"array","description":"18 quotazioni (3 durate x 6 fasce km/anno) con canone EUR mensile.","items":{"type":"object","properties":{"durata_mesi":{"type":"integer"},"km_inclusi_anno":{"type":"integer"},"canone_mensile_eur":{"type":"number"}}}},"url":{"type":"string"},"score":{"type":"number"},"segmento":{"type":"string","description":"Categoria Motornet del veicolo (es. 'SUV compatti'). NULL per i VCOM (commerciali ≤35q.li)."},"category_page_url":{"type":"string","format":"uri","description":"URL filter page SEO (es. https://dealermax.app/noleggio-lungo-termine/autovetture/suv-compatti). NULL per VCOM (segmento non applicabile)."},"vehicle_type":{"type":"string","enum":["auto","vcom"],"description":"Macro categoria: 'auto' (autovetture) o 'vcom' (veicoli commerciali ≤35 quintali: furgoni, cassonati, multispazio, pickup, bus). Permette al GPT di raggruppare/filtrare risultati per tipo veicolo."},"seats":{"type":"integer","description":"Numero di posti a sedere del veicolo (es. 5, 7, 9). NULL se non disponibile. Combinabile col filtro min_seats della request."}}},"VehicleDetailsRequest":{"type":"object","required":["vehicle_slug"],"properties":{"vehicle_slug":{"type":"string","minLength":8,"description":"UUID veicolo o slug friendly 'marca-modello-uuid'."}}},"NltOfferDetailsRequest":{"type":"object","required":["slug"],"properties":{"slug":{"type":"string","minLength":3,"description":"Slug univoco offerta NLT."}}},"FindDealerRequest":{"type":"object","properties":{"region":{"type":"string","description":"Regione/provincia/citta italiana."},"brand":{"type":"string","description":"Marca trattata (case-insensitive)."}}},"DealerStub":{"type":"object","properties":{"dealer_id":{"type":"integer"},"name":{"type":"string"},"city":{"type":"string"},"province":{"type":"string"}}}}}}