Autenticación
Todas las peticiones a la API requieren autenticación mediante API Key. Incluye tu clave en el header de cada petición:
curl -H "Authorization: Bearer YOUR_API_KEY" \ https://api.licitago.es/v1/licitaciones
Endpoints
GET
/v1/licitaciones
Obtiene un listado de licitaciones activas filtradas por los parámetros especificados.
Parámetros de query
| Nombre | Tipo | Descripción |
|---|---|---|
| q | string | Búsqueda por texto en título y descripción |
| provincia | string | Filtrar por provincia (ej: "Madrid", "Barcelona") |
| sector | string | Código CPV o nombre del sector |
| presupuesto_min | number | Presupuesto mínimo en euros |
| presupuesto_max | number | Presupuesto máximo en euros |
| limit | number | Resultados por página (máx: 100, default: 20) |
| offset | number | Número de resultados a omitir (paginación) |
// Ejemplo de respuesta { "total": 1542, "limit": 20, "offset": 0, "data": [ { "id": "abc123", "titulo": "Servicio de consultoría tecnológica", "organismo": "Ayuntamiento de Madrid", "presupuesto": 150000, "fecha_limite": "2026-02-15", "provincia": "Madrid", "enlace": "https://..." } ] }
GET
/v1/licitaciones/{id}
Obtiene los detalles completos de una licitación específica.
POST
/v1/alertas
Crea una nueva alerta para recibir notificaciones de licitaciones que coincidan con los criterios.
GET
/v1/estadisticas
Obtiene estadísticas agregadas del mercado de licitaciones.