Documentacion de la API

IberAPIs proporciona acceso a datos publicos de Espana a traves de una API REST. Todas las respuestas son en formato JSON.

Autenticacion

Todas las peticiones requieren una API key valida en el header X-API-Key:

curl -H "X-API-Key: iber_tu_api_key" https://iberapis.es/liciscan/latest
Nota: Los endpoints /info de cada modulo son publicos y no requieren autenticacion.

Rate Limits

Cada plan tiene un limite de peticiones por minuto:

Plan Peticiones/min Modulos
Free 5 LiciScan
Startup 100 LiciScan, EnergyStats
Business 500 Todos
Enterprise Ilimitado Todos + SLA

Los headers de respuesta incluyen informacion del rate limit:

  • X-RateLimit-Limit: Limite maximo por minuto
  • X-RateLimit-Remaining: Peticiones restantes
  • X-RateLimit-Reset: Segundos hasta reset

Errores

La API utiliza codigos HTTP estandar:

Codigo Descripcion
200 OK - Peticion exitosa
400 Bad Request - Parametros invalidos
401 Unauthorized - API key no proporcionada
403 Forbidden - API key invalida o sin permisos
429 Too Many Requests - Rate limit excedido
500 Internal Server Error

Las respuestas de error incluyen un mensaje descriptivo:

{
  "detail": "API Key no válida o revocada"
}

Paginacion

Los endpoints que devuelven listas soportan paginacion:

GET /liciscan/latest?page=1&page_size=20

La respuesta incluye metadata de paginacion:

{
  "data": [...],
  "meta": {
    "page": 1,
    "page_size": 20,
    "total": 150,
    "pages": 8
  }
}

LiciScan

Licitaciones publicas de la Plataforma de Contratacion del Estado

Endpoints

Metodo Endpoint Descripcion
GET /liciscan/info Informacion del modulo
GET /liciscan/latest Ultimas licitaciones
GET /liciscan/search Buscar licitaciones
GET /liciscan/{id} Detalle de licitacion
GET /liciscan/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/liciscan/info

EnergyStats

Precios de electricidad (ESIOS) y gasolineras (MITECO)

Endpoints

Metodo Endpoint Descripcion
GET /energy/info Informacion del modulo
GET /energy/electricidad/hoy Precios PVPC de hoy
GET /energy/electricidad/ahora Precio actual
GET /energy/gasolineras/cercanas Gasolineras cercanas
GET /energy/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/energy/info

CatastroAPI

Datos catastrales del Ministerio de Hacienda

Endpoints

Metodo Endpoint Descripcion
GET /catastro/info Informacion del modulo
GET /catastro/referencia/{rc} Consulta por referencia
GET /catastro/coordenadas Consulta por GPS
GET /catastro/provincias Lista provincias
GET /catastro/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/catastro/info

AutoData

Distintivos ambientales DGT para vehiculos

Endpoints

Metodo Endpoint Descripcion
GET /autodata/info Informacion del modulo
GET /autodata/vehiculo/{matricula} Consultar vehiculo
GET /autodata/calcular-distintivo Calcular distintivo
GET /autodata/distintivos Listar distintivos
GET /autodata/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/autodata/info

SociedadesScan

Inteligencia corporativa desde el BORME

Endpoints

Metodo Endpoint Descripcion
GET /sociedades/info Informacion del modulo
GET /sociedades/buscar Buscar empresas
GET /sociedades/empresa/{cif} Detalle de empresa
GET /sociedades/actos/recientes Actos recientes
GET /sociedades/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/sociedades/info

Subvenio

Subvenciones y ayudas publicas de la BDNS

Endpoints

Metodo Endpoint Descripcion
GET /subvenio/info Informacion del modulo
GET /subvenio/buscar Buscar subvenciones
GET /subvenio/subvencion/{bdns_id} Detalle
GET /subvenio/recientes Subvenciones recientes
GET /subvenio/stats Estadisticas

Ejemplo

curl -H "X-API-Key: iber_xxx" https://iberapis.es/subvenio/info

Para documentacion interactiva completa, visita /docs (OpenAPI/Swagger).