{"openapi":"3.1.0","info":{"title":"Vistazona API","version":"1.0.0","description":"Valoración inmobiliaria (vivienda y suelo) y oportunidades (suelo, subastas y señales urbanísticas de boletines oficiales) de España, con datos oficiales reales. Autenticación por clave API (Bearer); cada llamada consume créditos prepago."},"servers":[{"url":"https://vistazona.com"}],"security":[{"apiKeyQuery":[]},{"bearerAuth":[]}],"components":{"securitySchemes":{"apiKeyQuery":{"type":"apiKey","in":"query","name":"apikey","description":"Tu clave API en la URL: ?apikey=vz_live_… (panel «API · Desarrolladores»)."},"bearerAuth":{"type":"http","scheme":"bearer","description":"Alternativa: la misma clave como Bearer."}}},"paths":{"/v1/valorar":{"post":{"operationId":"valorar","summary":"Valora una vivienda o un suelo (5 créditos)","description":"Tasación anclada en el precio notarial real y el Catastro. Para suelo: clase='suelo', superficie y edificabilidad.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"direccion":{"type":"string"},"provincia":{"type":"string"},"m2":{"type":"number"},"clase":{"type":"string","enum":["vivienda","suelo"]},"superficie":{"type":"number"},"edificabilidad":{"type":"number"},"tipo":{"type":"string"},"estado":{"type":"string"}},"required":["direccion"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"402":{"description":"Sin créditos suficientes","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/oportunidades":{"get":{"operationId":"buscarOportunidades","summary":"Busca oportunidades (2 créditos)","description":"Señales urbanísticas y subastas de boletines oficiales. Filtra por provincia, municipio, tipo y clase.","parameters":[{"name":"provincia","in":"query","schema":{"type":"string"}},{"name":"municipio","in":"query","schema":{"type":"string"}},{"name":"tipo","in":"query","schema":{"type":"string"}},{"name":"clase","in":"query","schema":{"type":"string"}},{"name":"limite","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"402":{"description":"Sin créditos suficientes","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/oportunidades/{clase}/{id}":{"get":{"operationId":"fichaOportunidad","summary":"Detalle de una oportunidad (1 crédito)","description":"Ficha completa: contacto (promotor/ayuntamiento/órgano de subasta), trámite (a quién dirigirse, plazo), feasibility.","parameters":[{"name":"clase","in":"path","required":true,"schema":{"type":"string","enum":["senal","subasta"]}},{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"404":{"description":"No encontrada"}}}},"/v1/mercado":{"get":{"operationId":"mercado","summary":"Serie €/m² por municipio (1 crédito)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"402":{"description":"Sin créditos suficientes","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/indice":{"get":{"operationId":"indice","summary":"Agregados nacionales · Índice Vistazona (1 crédito)","responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"402":{"description":"Sin créditos suficientes","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/leads":{"post":{"operationId":"capturarLead","summary":"Registra un lead consentido (gratis)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"email":{"type":"string"},"consentimiento":{"type":"boolean"},"tipo":{"type":"string","enum":["vivienda","suelo"]},"intencion":{"type":"string"},"municipio":{"type":"string"},"provincia":{"type":"string"},"nombre":{"type":"string"},"telefono":{"type":"string"}},"required":["email","consentimiento"]}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Faltan datos"},"401":{"description":"Clave API ausente o no válida"}}},"get":{"operationId":"consultarLeads","summary":"Consulta leads de tu zona (5 créditos · plan agencia/promotor)","parameters":[{"name":"provincia","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"401":{"description":"Clave API ausente o no válida"},"402":{"description":"Sin créditos suficientes","content":{"application/json":{"schema":{"type":"object"}}}},"403":{"description":"Plan requerido"}}}}}}