API de datos
PolenMadrid ofrece una API REST que permite consultar niveles de polen, datos históricos, estaciones y tipos polínicos en formato JSON.
Autenticación
Todas las peticiones requieren un token de acceso. Envía el token en la cabecera Authorization: Bearer <token> o como parámetro ?token=<token>.
Para solicitar acceso a la API, contacta con [email protected].
Endpoints disponibles
| Endpoint | Parámetros | Descripción |
|---|---|---|
GET /api/niveles | fecha, estacion, tipo | Niveles actuales de polen por estación y tipo. |
GET /api/historico | estacion, tipo, desde, hasta, page, per_page | Datos históricos con paginación. |
GET /api/estaciones | — | Lista de estaciones con nivel actual. |
GET /api/estaciones/{code} | — | Detalle de una estación. |
GET /api/tipos | — | Lista de tipos polínicos con nivel actual. |
GET /api/tipos/{code} | — | Detalle de un tipo polínico. |
GET /api/estadisticas | estacion, tipo, agrupacion, desde, hasta | Estadísticas agregadas (diario, semanal, mensual, anual). |
Ejemplo de uso
curl -H "Authorization: Bearer YOUR_TOKEN" https://polenmadrid.com/api/niveles curl "https://polenmadrid.com/api/niveles?token=YOUR_TOKEN" Límite de peticiones
Máximo 60 peticiones por minuto por IP. Las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset indican el estado del límite.
Formato de respuesta
{
"ok": true,
"data": [...],
"meta": {
"total": 150,
"last_updated": "2026-02-18"
}
}