Pollen Sense APIs

Pollen Sense Customer APIs

Pollen Sense provides two customer-facing API products:

Both APIs are designed for programmatic access to Pollen Sense data, but serve different target customers.

Which API applies to your account?

Sensor API

If your organization has purchased Pollen Sense sensors, this is the API family you will generally use.

The Sensor API is intended for sensor owners and provides access to data tied to your organization's monitored sites and deployed sensors.

Typical use cases:

  • list the sensors and sites available to your organization
  • retrieve concentration metrics for a site
  • export site metrics as CSV
  • inspect site provisioning history
  • look up category, sensor mode, status, branch, and revision metadata

The current Sensor API surface is centered on the v2 site metrics endpoints:

  • GET /v2/sites/{siteId}/metrics
  • GET /v2/sites/{siteId}/metrics-export

V1 APIs exist for historical data; new data ingestions stopped stopped after March 11, 2026. These APIs will continue to exist until all data is backfilled into the V2 APIs.

Grid Data API

If your organization has purchased a data package without purchasing sensors, this is the API family you will generally use.

The Grid Data API provides access to modeled regional allergen data rather than organization-specific site data.

Typical use cases:

  • retrieve regional allergen rasters as .geotiff
  • retrieve the set of supported allergen categories
  • retrieve Airthority confidence rasters for analytical or decision-support workflows

The current Grid Data API surface is compact and focused:

  • GET /region
  • GET /categories
  • GET /airthority

The region and Airthority endpoints return raster datasets intended for downstream processing and mapping workflows. They are not tile-rendering APIs.

Sensor data model

The Sensor API is organized around a few core concepts:

  • Sites are geospatial locations where data is associated
  • Sensors are the physical APS devices that can be provisioned to a site
  • Metrics are the data products derived from sampled particles and sampled air volume

In the current v2 metrics API, the response is closer to the raw data model than the older v1 endpoints. It returns counts, sampled air volume, timestamps, and category metadata. From that, integrators can derive:

  • PPM3: particles per cubic meter
  • NMI / Misery Index: the normalized severity scale derived from PPM3 plus category metadata

If you are building around concentration or misery calculations, start with the v2 metrics endpoints and the category metadata they return.

Grid data model

The Grid Data API exposes modeled allergen data generated from the Pollen Sense sensor network plus interpolation and forecasting workflows.

Important characteristics from the current spec:

  • observed and forecasted values are both available
  • grid outputs may change as processing and modeling improve
  • some outputs are generated daily and may be unstable during early-morning UTC processing windows

The Grid API is best suited for analytics, geospatial processing, and downstream applications that can consume structured raster outputs.

Authentication

API Keys can be generated inside of the Pollen Sense Portal by org owners.

The live specs describe two supported patterns:

  • query parameter: ?key=<KEY>
  • header: x-ps-key

For hands-on exploration, use the authorization support built into the API references.

Start here