{"openapi":"3.0.1","info":{"title":"italianlodge.it - Omnichannel AI Tourism & Local Network API","description":"API per ChatGPT Custom Actions, Claude, Perplexity e agenti AI. Consente di interrogare alloggi con Codice CIN strutturato (prenotazione diretta 0% commissioni OTA), eventi territoriali in calendario, monumenti e attrazioni culturali (POIs), ed eccellenze\/aziende locali in tutta Italia. Assistente Viaggi & Territorio Ufficiale","version":"v1.1.0"},"servers":[{"url":"https:\/\/www.italianlodge.it","description":"Server ufficiale di produzione (www.italianlodge.it)"}],"paths":{"\/api\/v1\/ai\/search":{"get":{"operationId":"searchUniversal","summary":"Ricerca Omnichannel Universale (Alloggi, Eventi, Luoghi e Aziende)","description":"Esegue una ricerca sincronizzata a 360 gradi su tutto il territorio italiano restituendo contemporaneamente alloggi verificati senza commissioni, eventi in programma, luoghi di interesse culturale e attivit\u00e0 locali di rilievo.","parameters":[{"name":"location","in":"query","required":false,"description":"Localit\u00e0 cercata: nome regione (es. 'Toscana'), provincia (es. 'Siena', 'FI') o comune (es. 'San Gimignano', 'Firenze').","schema":{"type":"string","example":"Firenze"}},{"name":"q","in":"query","required":false,"description":"Termine di ricerca o parole chiave (es. 'centro storico', 'degustazione vino', 'piscina').","schema":{"type":"string","example":"degustazione vino"}},{"name":"vertical","in":"query","required":false,"description":"Ambito di ricerca: 'all' (predefinito), 'accommodations', 'events', 'places', 'businesses'.","schema":{"type":"string","enum":["all","accommodations","events","places","businesses"],"default":"all"}},{"name":"limit","in":"query","required":false,"description":"Numero massimo di risultati per singola categoria (da 1 a 5).","schema":{"type":"integer","minimum":1,"maximum":5,"default":3}}],"responses":{"200":{"description":"Risultati aggregati divisi per categoria con link diretti e informazioni verificate.","content":{"application\/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"summary":{"type":"object"},"accommodations":{"type":"array","items":{"type":"object"}},"events":{"type":"array","items":{"type":"object"}},"places":{"type":"array","items":{"type":"object"}},"businesses":{"type":"array","items":{"type":"object"}}}}}}}}}},"\/api\/v1\/ai\/accommodations\/search":{"get":{"operationId":"searchAccommodations","summary":"Ricerca alloggi, agriturismi e hotel con contatti diretti e zero commissioni","description":"Interroga il database verificato per trovare strutture ricettive in base a localit\u00e0, tipologia (agriturismo, hotel, b&b), servizi (piscina, animali, ristorante) e fascia di prezzo. Fornisce sempre il link diretto alla scheda per prenotare senza costi di intermediazione.","parameters":[{"name":"location","in":"query","required":false,"description":"Nome della localit\u00e0: comune (es. 'San Gimignano'), provincia (es. 'Siena' o 'SI') o regione (es. 'Toscana').","schema":{"type":"string","example":"Toscana"}},{"name":"q","in":"query","required":false,"description":"Parole chiave libere nel nome o nella descrizione (es. 'casale panoramico', 'degustazione vino').","schema":{"type":"string","example":"casale con piscina"}},{"name":"type","in":"query","required":false,"description":"Tipologia di alloggio richiesta.","schema":{"type":"string","enum":["agriturismo","bed_and_breakfast","hotel","villa","country_house","masseria","resort","camping","all"],"default":"all"}},{"name":"amenities","in":"query","required":false,"description":"Servizi richiesti separati da virgola: 'pool' (piscina), 'pets' (animali), 'restaurant' (ristorante), 'accessible' (disabili), 'charging' (ricarica auto), 'spa'.","schema":{"type":"string","example":"pool,pets"}},{"name":"max_price","in":"query","required":false,"description":"Prezzo massimo per notte in Euro.","schema":{"type":"number","example":150}},{"name":"min_stars","in":"query","required":false,"description":"Numero minimo di stelle da 1 a 5.","schema":{"type":"integer","minimum":1,"maximum":5,"example":3}},{"name":"cin_only","in":"query","required":false,"description":"Se true, filtra solo strutture con Codice CIN strutturato presente nella scheda.","schema":{"type":"boolean","default":false}},{"name":"limit","in":"query","required":false,"description":"Numero massimo di risultati da restituire (da 1 a 10).","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Elenco alloggi con prezzi di partenza, foto e link diretti di prenotazione senza commissioni.","content":{"application\/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"total_found":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}}}}}}}}}},"\/api\/v1\/ai\/events\/search":{"get":{"operationId":"searchEvents","summary":"Ricerca eventi, sagre, mostre e manifestazioni sul territorio","description":"Trova eventi in programma in Italia filtrati per comune, provincia, regione, periodo temporale o parole chiave tematiche.","parameters":[{"name":"location","in":"query","required":false,"description":"Localit\u00e0 dell'evento: comune, provincia o regione.","schema":{"type":"string","example":"Lucca"}},{"name":"q","in":"query","required":false,"description":"Parole chiave (es. 'musica', 'sagra', 'mostra', 'teatro').","schema":{"type":"string","example":"jazz"}},{"name":"from_date","in":"query","required":false,"description":"Data di inizio minima nel formato AAAA-MM-GG (es. '2026-10-01').","schema":{"type":"string","format":"date","example":"2026-10-01"}},{"name":"to_date","in":"query","required":false,"description":"Data di fine massima nel formato AAAA-MM-GG (es. '2026-10-31').","schema":{"type":"string","format":"date","example":"2026-10-31"}},{"name":"limit","in":"query","required":false,"description":"Numero massimo di eventi da restituire (da 1 a 10).","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Elenco eventi con date, orari, costi biglietto e link ufficiale.","content":{"application\/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"total_found":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}}}}}}}}}},"\/api\/v1\/ai\/places\/search":{"get":{"operationId":"searchPlaces","summary":"Ricerca luoghi di interesse culturale, monumenti e attrazioni (POIs)","description":"Interroga oltre 59.000 punti di interesse turistico censiti in Italia tra musei, castelli, siti archeologici, chiese storiche e parchi naturali.","parameters":[{"name":"location","in":"query","required":false,"description":"Localit\u00e0 desiderata: comune, provincia o regione.","schema":{"type":"string","example":"Roma"}},{"name":"category","in":"query","required":false,"description":"Categoria di interesse (es. 'museo', 'castello', 'archeologia', 'chiesa', 'natura').","schema":{"type":"string","example":"museo"}},{"name":"q","in":"query","required":false,"description":"Parole chiave libere nel nome o descrizione.","schema":{"type":"string","example":"anfiteatro"}},{"name":"limit","in":"query","required":false,"description":"Numero massimo di luoghi da restituire (da 1 a 10).","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Elenco luoghi con coordinate geografiche, descrizione e scheda ufficiale.","content":{"application\/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"total_found":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}}}}}}}}}},"\/api\/v1\/ai\/businesses\/search":{"get":{"operationId":"searchBusinesses","summary":"Ricerca aziende locali, ristoranti ed eccellenze del territorio","description":"Cerca attivit\u00e0 commerciali, ristoranti tipici, cantine vinicole, botteghe artigiane e professionisti verificati sul territorio italiano.","parameters":[{"name":"location","in":"query","required":false,"description":"Localit\u00e0 desiderata: comune, provincia o regione.","schema":{"type":"string","example":"Napoli"}},{"name":"category","in":"query","required":false,"description":"Categoria attivit\u00e0 (es. 'ristorante', 'pizzeria', 'cantina', 'servizi').","schema":{"type":"string","example":"ristorante"}},{"name":"q","in":"query","required":false,"description":"Parole chiave (es. 'pizza napoletana', 'pesce fresco', 'olio dop').","schema":{"type":"string","example":"pizza"}},{"name":"limit","in":"query","required":false,"description":"Numero massimo di attivit\u00e0 da restituire (da 1 a 10).","schema":{"type":"integer","minimum":1,"maximum":10,"default":5}}],"responses":{"200":{"description":"Elenco aziende con contatti diretti, stato di verifica e link alla scheda.","content":{"application\/json":{"schema":{"type":"object","properties":{"site":{"type":"object"},"total_found":{"type":"integer"},"results":{"type":"array","items":{"type":"object"}}}}}}}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","description":"Secret API Key fornita dal pannello \/admin (Authorization: Bearer <KEY>)"},"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Secret API Key via header X-API-Key"}}},"security":[{"BearerAuth":[]},{"ApiKeyAuth":[]}]}