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.

Oppdateres daglig

7-dagers prognose

Global dekning

Bred dekning av pollenarter

OpenAPI Spec (JSON)|OpenAPI Spec (YAML)

API-tester

Velg endepunkt

Bygg en API-forespørsel ved å velge fra egenskapene nedenfor:

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

GET https://pollenapi.com/v1/pollen?lon=10.7522&lat=59.913868&dt=2026-07-05&forecast_days=1

Spørringsparametere

Parameter	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))

Trees

treeAll Trees

birchBirch

betulaceaeBirch family

hazelHazel

alderAlder

pinePine

spruceSpruce

pinaceaePine family

elmElm

salixWillow

oakOak

mapleMaple

hickoryHickory

populusPoplar

cypressCypress

platanusPlane tree

fraxinusAsh

Grasses

grassAll Grasses

timothyTimothy Grass

bermudaBermuda Grass

loliumRyegrass

dactylisCock's-foot

arrhenatherumFalse Oat-grass

poaBluegrass

Weeds

weedAll Weeds

urticaNettle

artemisiaMugwort

ambrosiaRagweed

Headers

Header	Verdi	Beskrivelse
x-api-key		Leave empty to try with demo mode, or get a 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": 25,
    "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]
    }
  }
}

Species Catalog

25 species across 3 categories. Use the species key as the species parameter value.

Trees (16)

birchBirchbetulaceaeBirch familyhazelHazelalderAlderpinePinespruceSprucepinaceaePine familyelmElmsalixWillowoakOakmapleMaplehickoryHickorypopulusPoplarcypressCypressplatanusPlane treefraxinusAsh

Grasses (6)

timothyTimothy GrassbermudaBermuda GrassloliumRyegrassdactylisCock's-footarrhenatherumFalse Oat-grasspoaBluegrass

Weeds (3)

urticaNettleartemisiaMugwortambrosiaRagweed

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.

Se abonnement