Portales inmobiliarios
Completa cada anuncio con superficie, año de construcción y uso oficiales, sin que el anunciante tenga que escribirlos.
descriptiva.inmuebleEnvía una referencia catastral y recibe en JSON el valor de referencia, la superficie, el año de construcción, la parcela, las construcciones y el certificado oficial en PDF. Sin pagar nunca.
Más de 35 campos por inmuebleHTTPS + token personal5–10 s por consulta
Esto es lo que devuelve la API para un solo inmueble. Elige un bloque para ver sus datos o cámbialo a JSON para ver la respuesta tal cual.
5163834XH7856S0292SXRef.Ejemplo de respuesta de la API para un inmueble residencial de Caudete (Albacete).
Si tu producto toca inmuebles en España, el Catastro es la fuente de verdad. Ahora la tienes a una llamada de distancia.
Completa cada anuncio con superficie, año de construcción y uso oficiales, sin que el anunciante tenga que escribirlos.
descriptiva.inmuebleMuestra junto a cada lote su valor de referencia y la ficha catastral, y ayuda a pujar con datos.
valor.valorReferenciaEl valor de referencia es la base mínima en el ITP y en Sucesiones y Donaciones. Tenlo en el expediente al instante.
valor.fechaValorAlimenta tus modelos de valoración con superficie, antigüedad y valor de referencia de cada inmueble.
anioConstruccionValida en segundos los datos de la garantía antes de analizar una operación.
fullDescarga el certificado oficial en PDF y adjúntalo directamente al expediente.
certificado.pdfBase64POST /jobs con la referencia catastralPOST /jobs y recibe un jobId al momento.GET /jobs/:jobId o indica una callbackUrl y te avisamos.# 1. Crear el job curl -X POST https://api.catastroapi.com/jobs \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{"reference":"5163834XH7856S0292SX","includes":["full"]}' # 2. Recoger el resultado curl https://api.catastroapi.com/jobs/42 \ -H "Authorization: Bearer $TOKEN"
const API = 'https://api.catastroapi.com'; const headers = { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' }; const { jobId } = await (await fetch(`${API}/jobs`, { method: 'POST', headers, body: JSON.stringify({ reference: '5163834XH7856S0292SX', includes: ['full'] }), })).json(); let job; do { await new Promise(r => setTimeout(r, 10000)); job = await (await fetch(`${API}/jobs/${jobId}`, { headers })).json(); } while (['waiting', 'active', 'delayed'].includes(job.status)); console.log(job.result.full.data.valor.valorReferencia); // 79883.22
import time, requests API = "https://api.catastroapi.com" H = {"Authorization": f"Bearer {TOKEN}"} job_id = requests.post(f"{API}/jobs", headers=H, json={ "reference": "5163834XH7856S0292SX", "includes": ["full"], }).json()["jobId"] while True: time.sleep(10) job = requests.get(f"{API}/jobs/{job_id}", headers=H).json() if job["status"] in ("completed", "failed"): break print(job["result"]["full"]["data"]["valor"]["valorReferencia"])
$api = 'https://api.catastroapi.com'; $ctx = fn($method, $body = null) => stream_context_create(['http' => [ 'method' => $method, 'header' => "Authorization: Bearer $token\r\nContent-Type: application/json", 'content' => $body ? json_encode($body) : '', ]]); $job = json_decode(file_get_contents("$api/jobs", false, $ctx('POST', [ 'reference' => '5163834XH7856S0292SX', 'includes' => ['full'], ])), true); do { sleep(10); $r = json_decode(file_get_contents("$api/jobs/{$job['jobId']}", false, $ctx('GET')), true); } while (in_array($r['status'], ['waiting', 'active', 'delayed'])); echo $r['result']['full']['data']['valor']['valorReferencia'];
No hay plan "Pro" esperando detrás. Pedimos solo una cosa: un uso razonable, para que vaya rápido para todos.
Sí. CatastroAPI es gratuita para siempre: no hay planes de pago, no pedimos tarjeta y no hay periodo de prueba. Solo tienes que solicitar acceso.
El valor de referencia con su fecha, la dirección, el código postal, el municipio, la provincia, la clase y el uso del inmueble, la superficie construida, el año de construcción, los datos de la parcela, el desglose de construcciones y el certificado oficial en PDF.
De media entre 5 y 10 segundos por consulta. Las peticiones entran en una cola, así que tu aplicación recibe un identificador al momento y recoge el resultado después.
Rellena el formulario de solicitud. Revisamos cada solicitud a mano y, cuando la aprobamos, te enviamos tu token personal por email.
No. CatastroAPI es un servicio independiente y no está vinculado a la Dirección General del Catastro. Los datos se obtienen de la Sede Electrónica del Catastro.
La API acepta referencias catastrales completas de 20 caracteres alfanuméricos, por ejemplo 5163834XH7856S0292SX. Te explicamos cómo leerla en nuestra guía de la referencia catastral.
La base mínima del ITP y de Sucesiones y Donaciones desde 2022, explicada sin tecnicismos.
Leer artículo → GuíaLos 20 caracteres que identifican cada inmueble de España, desglosados uno a uno.
Leer artículo → DesarrolladoresDe la referencia catastral al JSON en tres pasos, con código en JavaScript, Python y PHP.
Leer artículo →