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.

Uppdateras dagligen

7-dagarsprognos

Global täckning

Bred täckning av pollenarter

OpenAPI Spec (JSON)|OpenAPI Spec (YAML)

API-testare

Välj endpoint

Bygg en API-begäran genom att välja bland egenskaperna nedan:

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

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

Frågeparametrar

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

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	Värde	Beskrivning
x-api-key		Leave empty to try with demo mode, or get a 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": 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

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.

Se prenumerationer