GeoAPI
API REST de datos oficiales de España
Accede a los más de 34.000 centros educativos oficiales y al callejero del INE (código postal → localidad → municipio → provincia → comunidad autónoma) mediante una API REST rápida y sencilla. Datos actualizados frecuentemente del Ministerio de Educación y del Instituto Nacional de Estadística.
Ejemplo
Con tu API key, busca centros por nombre:
curl -H "X-API-Key: tu-api-key" \
"https://tu-dominio.com/v1/centros?q=santiago"
const res = await fetch("https://tu-dominio.com/v1/centros?q=santiago", {
headers: { "X-API-Key": "tu-api-key" }
});
const { data } = await res.json();
$ch = curl_init("https://tu-dominio.com/v1/centros?q=santiago");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: tu-api-key"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true)['data'];
import requests
r = requests.get(
"https://tu-dominio.com/v1/centros",
params={"q": "santiago"},
headers={"X-API-Key": "tu-api-key"},
)
data = r.json()["data"]
{
"data": [
{
"codigo": "06000046",
"denominacionEspecifica": "SANTIAGO RAMON Y CAJAL",
"denominacionGenerica": "Colegio de Educación Infantil y Primaria",
"tipo": "publico",
"direccion": "EXTRAMUROS S/N",
…
}
],
"meta": { "count": 10, … }
}
Con tu API key, consulta el callejero por código postal:
curl -H "X-API-Key: tu-api-key" \
"https://tu-dominio.com/v1/codigos-postales/28013"
const res = await fetch("https://tu-dominio.com/v1/codigos-postales/28013", {
headers: { "X-API-Key": "tu-api-key" }
});
const { data } = await res.json();
$ch = curl_init("https://tu-dominio.com/v1/codigos-postales/28013");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: tu-api-key"]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true)['data'];
import requests
r = requests.get(
"https://tu-dominio.com/v1/codigos-postales/28013",
headers={"X-API-Key": "tu-api-key"},
)
data = r.json()["data"]
{
"data": [
{
"codigoPostal": "28013",
"localidad": "Madrid",
"nivel": "municipio",
"municipio": "Madrid",
"provincia": "Madrid",
"comunidadAutonoma": "COMUNIDAD DE MADRID"
}
],
"meta": { "count": 1 }
}
Parámetros
- q
- texto libre: nombre, localidad, provincia, CP o CCAA
- provincia
- filtra por provincia
- comunidadAutonoma
- filtra por comunidad autónoma
- codigoPostal
- filtra por código postal
- tipo
- publico / privado / concertado
- limit, offset
- paginación (máx. 50 por página)
Al menos uno de q, provincia, comunidadAutonoma o codigoPostal es obligatorio.
idioma — español (
es), catalán (ca), gallego
(gl) y euskera (eu): códigos ISO 639-1. También valenciano
(va), cooficial en la Comunitat Valenciana, y aranés (oc),
cooficial en la Val d'Aran — ninguno de los dos tiene código ISO 639-1 propio.
Parámetros
- cpos
- código postal de 5 dígitos, en la ruta
/v1/codigos-postales/{cpos}
No acepta idioma: localidad, municipio, provincia y comunidad autónoma se devuelven siempre en español.
Características
- 34.000+ centros educativos
- Callejero oficial del INE
- Actualización periódica
- JSON
- Respuesta <100 ms
- Cobertura nacional
- Soporte en todos los idiomas cooficiales de España
No afiliado al Ministerio de Educación ni al INE.
Datos procedentes del Registro Estatal de Centros Docentes y del Callejero del INE.