API-dokumentasjon
Oversikt
Atmospore API gir pollendata i sanntid og prognoser for steder over hele verden. Data oppdateres daglig og inkluderer prognoser opptil 7 dager frem i tid. Prognosene blir mer nøyaktige etter hvert som datoen nærmer seg.
API-tester
- Velg spørringsparametrene for forespørselen, sted, tid og prognosedager
- Velg artene du vil spørre etter resultater for
- Til slutt, legg ved API-nøkkelen din som en autorisasjonsheader
Spørringsparametere
| Parameter | Verdi | Type | Beskrivelse |
|---|---|---|---|
| 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. |
Tilgjengelige Pollen Species-alternativer
(Klikk for å legge til i forespørselen (minst én må velges))Headers
| Header | Verdi | Beskrivelse |
|---|---|---|
| x-api-key | Leave empty to try with demo mode, or use your own key from your account. | |
| accept | Accept JSON response |
Endepunktreferanse
GET /v1/pollen
Interpolert pollenprognose for et bestemt punkt. Returnerer artsnivå-data med risikonivåer opptil 14 dager frem. Bruk dette som hovedendepunkt for lokasjonsbaserte allergiapper, widgets og varsler.
| 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"Eksempelsvar
{
"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
Gjennomsnittlig, minimum og maksimum pollennivå over en konfigurerbar radius. Ideelt for regionale dashboards, smarthus-systemer og helsetjenester som trenger områdebasert risikovurdering.
| 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"Eksempelsvar
{
"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 bidragende pollenarter i en tidsperiode, rangert etter alvorlighetsgrad. Bruk dette for "ukens verste allergener"-kort, ukentlige e-postsammendrag eller for å fremheve hva man bør følge med 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"Eksempelsvar
{
"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 visningsnavn på flere språk, kategorier og risikoterskler. Ingen autentisering påkrevd. Kall én gang, lagre lokalt, og bruk for å bygge lokaliserte brukergrensesnitt.
Ingen parametere påkrevd. Ingen API-nøkkel påkrevd.
curl "https://pollenapi.com/v1/species"Eksempelsvar
{
"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]
}
}
}Eksempler på bruksområder
Helseapper
Integrer sanntids pollendata i helse- og velværeapplikasjoner for å hjelpe brukere med å håndtere allergier og planlegge utendørsaktiviteter.
Se casestudie →Smarthus-systemer
Automatiser luftrensesystemer basert på lokale pollennivåer for å opprettholde optimal innendørs luftkvalitet.
Se casestudie →Utdanning
Gjør biologiundervisningen bedre med sanntidsdata om planters livssyklus og miljøvitenskap.
Se casestudie →Klar til å komme i gang?
Registrer deg for en API-nøkkel og ta i bruk pollendata i applikasjonene dine.