GET
/api/callejero/provinciasListar provincias
Respuestas
200Listado de provincias
Ejemplo
Contraer JSON
Errores
401API key inválida o ausente
429Límite de peticiones alcanzado
API de consulta al catastro español. Todos los endpoints requieren API key en el header `x-api-key`.
Todas las peticiones requieren autenticación mediante API key. Las respuestas son JSON y los endpoints de éxito incluyen cabeceras de rate limit.
La forma más fácil de empezar
Importa la colección de Postman en la aplicación, crea una cuenta para activar una suscripción de prueba sin pago ni tarjeta, genera una API key y configúrala en la variable apiKey de la colección. Así podrás probar todas las peticiones directamente desde Postman.
URL base
https://api.catastro-api.esAutenticación
API key con prefijo ctr_
x-api-keyEjemplo rápido
curl "https://api.catastro-api.es/api/callejero/provincias" \
-H "x-api-key: ctr_tu_api_key" \
-H "Accept: application/json"Postman
Importa la colección completa de endpoints en Postman para probar la API de forma interactiva.
Swagger UI
Explora y prueba los endpoints directamente desde la interfaz interactiva de Swagger.
Integra los buscadores de CatastroAPI en tu web mediante un iframe. Las peticiones usan embed keys públicas y validan el dominio donde está embebido el widget.
Cómo empezar
Parámetros de la URL del widget
Puedes personalizar el widget añadiendo query params a la URL del iframe.
| Parámetro | Requerido | Descripción | Ejemplo |
|---|---|---|---|
key | requerido | Embed key pública (pub_...). | pub_... |
tab | opcional | Pestaña inicial: address, map o reference. | address | map | reference |
tabs | opcional | Pestañas visibles separadas por comas: address, map y/o reference. Por defecto se muestran las tres. | address,map | address,reference |
lang | opcional | Idioma del widget: es o en. | es | en |
theme | opcional | Tema visual del widget: dark o light. | dark | light |
URL de ejemplo
https://catastro-api.es/embed/widget?key=pub_ejemplo&tab=address&theme=lightCódigo iframe
Sustituye pub_... por tu embed key.
<iframe
src="https://catastro-api.es/embed/widget?key=pub_..."
width="100%"
height="720"
style="border:0;background:transparent;color-scheme:normal;"
loading="lazy"
title="Buscador catastral CatastroAPI"
></iframe>Consultas por nombre de provincia, municipio y vía
/api/callejero/provinciasErrores
/api/callejero/municipiosqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero/viasqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero/numerosqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero/inmueble-localizacionqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero/inmueble-rcqueryopcionalqueryobjectParámetros de consulta
Errores
Consultas por códigos INE/MEH
/api/callejero-codigos/provinciasErrores
/api/callejero-codigos/municipiosqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero-codigos/viasqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero-codigos/numerosqueryopcionalqueryobjectParámetros de consulta
Errores
/api/callejero-codigos/inmueblesqueryopcionalqueryobjectParámetros de consulta
Errores
Referencias catastrales y coordenadas
/api/coordenadas/rc-por-coordenadasqueryopcionalqueryobjectParámetros de consulta
Errores
/api/coordenadas/coordenadas-por-rcqueryopcionalqueryobjectParámetros de consulta
Errores