API Documentation

Overview

The Atmospore API provides real-time and forecast pollen data for locations worldwide. Data is updated daily and includes forecasts up to 7 days into the future. Our forecasts are continuously refined as the target date approaches, ensuring the highest possible accuracy.

Updates daily

7-day forecast

Global coverage

Big catalog of modelled species

OpenAPI Spec (JSON)|OpenAPI Spec (YAML)

API Tester

Select endpoint

Build an API-request by selecting from the properties below:

Select the Query parameters for the request, location, time and forecast days
Select the species you want to query for results
Finally attach your API-key as an Authorization header

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

Query Parameters

Parameter	Type	Description
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.

Available Pollen Species Options

(Click to add to request, at least one required)

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	Value	Description
x-api-key		Leave empty to try with demo mode, or get a key from your account.
accept		Accept JSON response

Endpoint Reference

GET /v1/pollen

Interpolated pollen forecast at a specific point. Returns species-level data with risk levels for up to 14 days. Use this as your primary endpoint for location-based allergy apps, widgets, and alerts.

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"

Example response

{
  "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

Average, minimum, and maximum pollen levels across a configurable radius. Ideal for regional dashboards, smart home systems, and health services that need area-wide risk assessment rather than a single point.

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"

Example response

{
  "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

Top contributing pollen species in a date range, ranked by severity. Use this for "this week's worst allergens" cards, weekly email summaries, or highlighting what to watch out for.

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"

Example response

{
  "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

Species metadata with display names in multiple languages, categories, and risk thresholds. No authentication required. Call once, cache client-side, and use for building localized UIs.

No parameters required. No API key required.

curl "https://pollenapi.com/v1/species"

Example response

{
  "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

Example Use Cases

Health Apps

Integrate real-time pollen data into health and wellness applications to help users manage allergies and plan outdoor activities.

View Case Study →

Smart Home Systems

Automate air purification systems based on local pollen levels to maintain optimal indoor air quality.

View Case Study →

Education

Enhance biology education by integrating real-time data for teaching about plant life cycles and environmental science.

View Case Study →

Ready to get started?

View Plans