API-dokumentation
Översikt
Atmospore API ger pollendata i realtid och prognoser för platser över hela världen. Data uppdateras dagligen och inkluderar prognoser upp till 7 dagar framåt. Prognoserna blir mer noggranna ju närmare datumet kommer.
API-testare
- Välj frågeparametrarna för begäran, plats, tid och prognosdagar
- Välj de arter du vill fråga efter resultat för
- Till sist, bifoga din API-nyckel som en Authorization-header
Frågeparametrar
| Parameter | Värde | Typ | Beskrivning |
|---|---|---|---|
| lon * | number | Longitude coordinate | |
| lat * | number | Latitude coordinate | |
| dt * | string | Date (YYYY-MM-DD) | |
| forecast_days * | number | Days to forecast (1-14) | |
| species | string | Species or group (optional). Use the selector below. |
Tillgängliga Pollen Species-alternativ
(Klicka för att lägga till i begäran (minst ett måste väljas))Headers
| Header | Värde | Beskrivning |
|---|---|---|
| x-api-key | Leave empty to try with demo mode, or use your own key from your account. | |
| accept | Accept JSON response |
Endpoint-referens
GET /v1/pollen
Interpolerad pollenprognos för en specifik punkt. Returnerar artsnivå-data med risknivåer upp till 14 dagar framåt. Använd detta som primärt endpoint för platsbaserade allergiappar, widgets och varningar.
| Parameter | Type | Required | Description |
|---|---|---|---|
lon | number | Yes | Longitude |
lat | number | Yes | Latitude |
dt | string | Yes | Start date (YYYY-MM-DD) |
forecast_days | number | Yes | Days to forecast (1-14) |
species | string | No | Comma-separated species or groups (tree, grass, weed, all). Defaults to all species. |
curl "https://pollenapi.com/v1/pollen?lon=-0.13&lat=51.51&dt=2026-04-02&forecast_days=3&species=birch,grass" \
-H "x-api-key: YOUR_API_KEY"Exempelsvar
{
"meta": {
"location": { "lat": 51.51, "lon": -0.13 },
"units": "grains/m³",
"generated_at": "2026-04-02T07:11:00Z"
},
"data": [
{
"date": "2026-04-02",
"overall_risk": "moderate",
"species": {
"birch": {
"value": 12.5,
"risk_level": "low",
"display_name": "Birch",
"category": "tree"
},
"timothy": {
"value": 0,
"risk_level": "low",
"display_name": "Timothy Grass",
"category": "grass"
}
}
}
]
}GET /v1/pollen-area
Genomsnittlig, minimala och maximala pollennivåer över en konfigurerbar radie. Perfekt för regionala dashboards, smarta hem-system och hälsotjänster som behöver områdesbaserad riskbedömning.
| Parameter | Type | Required | Description |
|---|---|---|---|
lon | number | Yes | Center longitude |
lat | number | Yes | Center latitude |
dt | string | Yes | Start date (YYYY-MM-DD) |
forecast_days | number | Yes | Days to forecast (1-14) |
species | string | No | Comma-separated species or groups. Defaults to all. |
radius | number | No | Search radius in meters (default: 25000, max: 50000) |
curl "https://pollenapi.com/v1/pollen-area?lon=-0.13&lat=51.51&dt=2026-04-02&forecast_days=3&species=tree_tot,grass_tot&radius=50000" \
-H "x-api-key: YOUR_API_KEY"Exempelsvar
{
"meta": {
"location": { "lat": 51.51, "lon": -0.13 },
"radius": 50000,
"units": "grains/m³",
"generated_at": "2026-04-02T07:11:01Z"
},
"data": [
{
"date": "2026-04-02",
"overall_risk": "moderate",
"species": {
"tree_tot": {
"avg": 77.5,
"min": 37,
"max": 151,
"risk_level": "moderate",
"display_name": "Tree Pollen (Total)",
"category": "tree"
},
"grass_tot": {
"avg": 0,
"min": 0,
"max": 0,
"risk_level": "low",
"display_name": "Grass Pollen (Total)",
"category": "grass"
}
}
}
]
}GET /v1/pollen-top
Mest bidragande pollenarter under en tidsperiod, rankade efter allvarlighetsgrad. Använd för "veckans värsta allergener"-kort, veckovisa e-postsammanfattningar eller för att markera vad man bör vara uppmärksam på.
| Parameter | Type | Required | Description |
|---|---|---|---|
lon | number | Yes | Longitude |
lat | number | Yes | Latitude |
dt | string | Yes | Start date (YYYY-MM-DD) |
forecast_days | number | Yes | Days to include in range (1-14) |
curl "https://pollenapi.com/v1/pollen-top?lon=-0.13&lat=51.51&dt=2026-03-26&forecast_days=7" \
-H "x-api-key: YOUR_API_KEY"Exempelsvar
{
"meta": {
"location": { "lat": 51.51, "lon": -0.13 },
"units": "grains/m³",
"date_range": ["2026-03-26", "2026-04-01"],
"generated_at": "2026-04-02T07:11:01Z"
},
"data": [
{
"species": "pinaceae",
"display_name": "Pine family",
"category": "tree",
"max": 48,
"avg": 35,
"risk_level": "moderate"
},
{
"species": "salix",
"display_name": "Willow",
"category": "tree",
"max": 28,
"avg": 22,
"risk_level": "moderate"
}
]
}GET /v1/species
Artsmetadata med visningsnamn på flera språk, kategorier och risktrösklar. Ingen autentisering krävs. Anropa en gång, cacha lokalt och använd för att bygga lokaliserade gränssnitt.
Inga parametrar krävs. Ingen API-nyckel krävs.
curl "https://pollenapi.com/v1/species"Exempelsvar
{
"meta": {
"total_species": 21,
"categories": ["tree", "grass", "weed"],
"risk_levels": ["low", "moderate", "high", "very high"],
"units": "grains/m³"
},
"data": {
"birch": {
"display_name": "Birch",
"category": "tree",
"names": { "en": "Birch", "sv": "Björk", "no": "Bjørk" },
"risk_thresholds": [15, 90, 500, 1500]
},
"artemisia": {
"display_name": "Mugwort",
"category": "weed",
"names": { "en": "Mugwort", "sv": "Gråbo", "no": "Burot" },
"risk_thresholds": [10, 50, 200, 500]
}
}
}Exempel på användningsområden
Hälsoappar
Integrera realtids pollendata i hälso- och välmåendeappar för att hjälpa användare hantera allergier och planera utomhusaktiviteter.
Se fallstudie →Smarta hem-system
Automatisera luftreningssystem baserat på lokala pollennivåer för att upprätthålla optimal inomhusluftkvalitet.
Se fallstudie →Utbildning
Förbättra biologiundervisningen med realtidsdata om växters livscykel och miljövetenskap.
Se fallstudie →Redo att komma igång?
Registrera dig för en API-nyckel och börja använda pollendata i dina applikationer.