API y MCP de Vistazona

Valora inmuebles y busca oportunidades de suelo, subastas y señales urbanísticas de España —con datos oficiales reales— desde tu código, desde Claude o desde ChatGPT. Autenticación por clave API y créditos prepago.

1 · Consigue tu clave

Entra en la app → API · Desarrolladores, crea una clave vz_live_… y compra créditos. Pásala en cada petición en la URL: ?apikey=vz_live_… (sin cabeceras).

2 · API REST

curl -X POST 'https://vistazona.com/v1/valorar?apikey=vz_live_…' \ -d '{"direccion":"Calle Larios 5, Málaga","provincia":"Málaga","m2":90}' # GET con la clave en la URL: curl 'https://vistazona.com/v1/oportunidades?apikey=vz_live_…&provincia=Málaga'

POST

/v1/valorar

Valora vivienda o suelo · 5 créd.

GET

/v1/oportunidades

Busca oportunidades · 2 créd.

GET

/v1/oportunidades/{clase}/{id}

Ficha completa (contacto, plazo, feasibility) · 1 créd.

GET

/v1/mercado

€/m² por municipio · 1 créd.

GET

/v1/indice

Agregados nacionales · 1 créd.

POST

/v1/leads

Registra un lead consentido · gratis

Especificación OpenAPI →

3 · Conéctalo a Claude o ChatGPT (MCP)

Añade el conector MCP remoto con tu clave en la URL; consume tus mismos créditos:

https://mcp.vistazona.com/mcp?apikey=vz_live_…

⬇ Descargar para Claude Desktop (.mcpb) un clic; te pide tu clave al instalar.

Claude / ChatGPT (conector MCP): Ajustes → Conectores → Conector personalizado y pega la URL de arriba con tu clave (?apikey=…).
ChatGPT (Custom GPT): crea un GPT, añade una Action e importa openapi.json; pon tu clave API en la autenticación de la Action.

Precios

1000 créditos

29 € · pago único

5000 créditos

99 € · pago único

25.000 créditos

299 € · pago único

Endpoint	Coste
`valorar`	5 créd.
`oportunidades`	2 créd.
`ficha`	1 créd.
`lead_write`	gratis
`lead_read`	5 créd.
`mercado`	1 créd.
`indice`	1 créd.

Datos de fuentes oficiales (Notariado, Catastro, BOP/BOE). Nunca inventamos cifras: si no hay datos fiables, lo decimos.