Por referencia catastral
La RC de 20 caracteres → el inmueble.
curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX \
-H "x-api-key: $PREDIO_API_KEY"Para proptech, inmobiliarias y agentes de IA · REST + MCP
El Catastro español, en JSON limpio.
Resuelve y enriquece cualquier inmueble español y recibe JSON estructurado y versionado — sin pelearte con el SOAP del Catastro.
- Resuelve por referencia catastral, coordenadas o dirección
- JSON estructurado y versionado — urbano y rústico, misma forma
- REST y MCP — mismo core, errores en JSON nunca XML
- Pago por uso, sin tarjeta — primera llamada en 2 minutos
Sin tarjeta. Free-tier de 250 créditos/mes para probar antes de conectar la billetera.
Tu primera llamada
curl https://api.prediohq.com/v1/inmueble/9872023VH5797S0001WX \
-H "x-api-key: $PREDIO_API_KEY"78,9 M
Bienes inmuebles del territorio común (Catastro, ene. 2026)
Urbano + rústico
~40,2 M urbanos · ~38,7 M rústicos, misma salida
Oficial
Datos de la Sede Electrónica del Catastro (DGC)
3 formas
Por referencia, coordenadas o dirección
/v1
Contrato versionado, errores en JSON
Serve-stale
Resiliente si la fuente oficial cae
01
El dato es público; consumirlo, no
Los datos catastrales son públicos, pero difíciles de consumir por máquinas: SOAP/XML pesado, errores que no respetan los códigos HTTP y un esquema pensado para humanos. Tu producto proptech —o el agente que evalúa un inmueble a mitad de tarea— quema tiempo y tokens, y se rompe.
Predio te los da limpios, estructurados y predecibles — para que tu agente no se ahogue en el dato. Misma forma para urbano y rústico, errores en JSON, y un dato cacheado marcado stalesi la fuente cae.
02
Resuelve por…
Tres entradas, la misma salida normalizada (clase, uso, m² construidos, año, dirección, desglose). Autentícate con tu cabecera x-api-key; los errores de negocio no cobran.
Por coordenadas
lat/lon (WGS84 o ETRS89) → el inmueble que contiene el punto.
curl "https://api.prediohq.com/v1/inmueble/by-coords?lat=41.3915&lon=2.1620" \
-H "x-api-key: $PREDIO_API_KEY"Por dirección
Provincia, municipio, vía y número (inmueble urbano).
curl "https://api.prediohq.com/v1/inmueble/by-address?province=CIUDAD+REAL&municipality=SANTA+CRUZ+DE+MUDELA&streetType=CL&streetName=GLORIA&streetNumber=51" \
-H "x-api-key: $PREDIO_API_KEY"Mismo core por REST o MCP. Lee el llms.txty la spec OpenAPI, conecta y recibe JSON listo para encadenar.
03
Para agentes, primero
Descubrible y nativo (MCP)
Servidor MCP listo para Claude, GPT y tu agente: la herramienta aparece y se invoca sola, con su JSON Schema.
Endpoint MCP →REST espejo (/v1)
Mismo dominio, contrato versionado y estable. Para todo lo que no hable MCP, con errores predecibles en JSON.
Spec OpenAPI →Descubrimiento AEO
llms.txt, precios legibles por máquina y la spec OpenAPI servidos desde el dominio. Evalúa antes de pagar.
llms.txt →Nuevo · early access
ParcelGuard — las afecciones de una parcela, por referencia catastral
Inundabilidad (SNCZI), Red Natura 2000, costas y vías pecuarias en un JSON con fuente y fecha por capa: el pre-screening de una due diligence de suelo, sin abrir cinco visores. Pago por informe.
04
Precios sin sorpresas
Pago por uso: 1 crédito por respuesta con éxito, sea cual sea el endpoint. El €/llamada baja en los packs grandes. Packs prepago vía Stripe; X402 como fast-follow.
Free
0€
250 créditos/mes
Para sandbox y diagnóstico antes de conectar la billetera.
Mini
5€
2500 créditos
≈ 0,002€/llamada
Starter
9€
5000 créditos
≈ 0,0018€/llamada
Growth
Popular29€
25.000 créditos
≈ 0,00116€/llamada
Scale
99€
150.000 créditos
≈ 0,00066€/llamada
1 crédito = 1 respuesta con éxito. Los errores de negocio (404/422) no cobran; cache hits y serve-stale sí (precio por valor). Versión legible por máquina en/pricing.json.
05
Preguntas frecuentes
¿Qué pasa si me quedo sin saldo?
El gate de créditos responde 402 (pago requerido); no se corta a mitad de respuesta. Con auto-recarga activada, recargas sola al cruzar el umbral; sin ella, compras un pack y sigues.
¿Qué cobertura tiene?
Territorio común de España, urbano y rústico. Excluye País Vasco y Navarra, que tienen catastro foral propio.
¿Cuándo se consume un crédito?
1 crédito por respuesta con éxito (200 con cuerpo). Los errores de negocio (404 no encontrado, 422 entrada inválida) no cobran. Las respuestas cacheadas y el serve-stale sí cobran: pagas por el valor, no por nuestro coste.
¿Puedo redistribuir los datos del Catastro?
Son datos públicos no protegidos de la Dirección General del Catastro, reutilizables conforme a su licencia. Predio es un servicio no oficial; revisa la licencia de la DGC para tu caso de uso.
¿Cómo de actualizados están los datos?
Predio consulta la fuente oficial (Sede Electrónica del Catastro) y cachea por valor. Si la fuente cae, sirve el último dato cacheado marcado stale para que tu integración no se rompa.
¿REST o MCP?
Ambos, mismo core y contrato. MCP para agentes (la herramienta se descubre e invoca sola); REST /v1 para todo lo demás.
Confianza por diseño
Fuente y licencia
Datos no protegidos de la Dirección General del Catastro, reutilizados conforme a su licencia. Servicio no oficial, sin garantía de exactitud.
Contrato estable
Salida versionada (/v1), errores predecibles en JSON (404/422/402/401/502), nunca XML ni status ambiguo.
Cobertura clara
Territorio común de España. Excluye País Vasco y Navarra (catastro foral propio).
Empieza a consultar el Catastro hoy
Free-tier sin tarjeta. De cero a tu primera llamada en 2 minutos, por REST o MCP.