Open-Meteo Air Quality

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/air-quality?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/air-quality', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/air-quality",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/air-quality"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/air-quality")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "elevation": 38,
  "generationtime_ms": 0.3,
  "hourly": {
    "european_aqi": [
      21
    ],
    "pm10": [
      12.4
    ],
    "pm2_5": [
      8.1
    ],
    "time": [
      "2024-01-01T00:00"
    ]
  },
  "hourly_units": {
    "european_aqi": "EAQI",
    "pm10": "μg/m³",
    "pm2_5": "μg/m³",
    "time": "iso8601"
  },
  "latitude": 52.5,
  "longitude": 13.4,
  "timezone": "GMT",
  "utc_offset_seconds": 0
}

GET

https://api.aisa.one

apis

openmeteo

air-quality

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/openmeteo/air-quality?latitude=52.52&longitude=13.41' \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/openmeteo/air-quality', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/openmeteo/air-quality",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/openmeteo/air-quality"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/openmeteo/air-quality")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "elevation": 38,
  "generationtime_ms": 0.3,
  "hourly": {
    "european_aqi": [
      21
    ],
    "pm10": [
      12.4
    ],
    "pm2_5": [
      8.1
    ],
    "time": [
      "2024-01-01T00:00"
    ]
  },
  "hourly_units": {
    "european_aqi": "EAQI",
    "pm10": "μg/m³",
    "pm2_5": "μg/m³",
    "time": "iso8601"
  },
  "latitude": 52.5,
  "longitude": 13.4,
  "timezone": "GMT",
  "utc_offset_seconds": 0
}

Fetch an air-quality forecast (CAMS European or global model) for any coordinate. Request pollutants and indices with hourly and/or current variable lists — e.g. pm10, pm2_5, carbon_monoxide, nitrogen_dioxide, ozone, dust, uv_index, european_aqi, us_aqi — plus pollen species such as birch_pollen or grass_pollen. Control span with forecast_days (up to 7) and past_days, or pin domains to cams_europe / cams_global. The response returns grid-cell metadata and an hourly (and optional current) block with a time array, one array per variable, and a matching *_units object. Example:

GET /apis/v1/openmeteo/air-quality?latitude=52.52&longitude=13.41&hourly=pm10,pm2_5,european_aqi&forecast_days=5&timezone=Europe/Berlin

. Billing: per call, metered per request. Current prices are on aisa.one/api. All Open-Meteo endpoints are GET pass-through — authenticate with your AIsa API key as a bearer token (the same key used across every AIsa /apis/* endpoint); AIsa handles provider access.

Request contract

Method and path: GET /apis/v1/openmeteo/air-quality
Availability: enabled
Request URL template: https://api.aisa.one/apis/v1/openmeteo/air-quality
cell_selection: query; optional
current: query; optional
domains: query; optional
end_date: query; optional
forecast_days: query; optional
forecast_hours: query; optional
hourly: query; optional
latitude: query; required
longitude: query; required
past_days: query; optional
past_hours: query; optional
start_date: query; optional
timeformat: query; optional
timezone: query; optional
Runtime facts: sha256:36f55c225a89aa6e29290270a8eeed85c6f6224160884d7fa3a086ea2ad602ef

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_openmeteo_air_quality",
  "method": "GET",
  "path": "/apis/v1/openmeteo/air-quality",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Grid-cell preference for the coordinate. Default `nearest`.",
      "in": "query",
      "name": "cell_selection",
      "required": false,
      "schema": {
        "default": "nearest",
        "enum": [
          "land",
          "sea",
          "nearest"
        ],
        "type": "string"
      }
    },
    {
      "description": "Comma-separated list of current-condition variables to return. Same variable set as `hourly`.",
      "in": "query",
      "name": "current",
      "required": false,
      "schema": {
        "example": "european_aqi,pm2_5",
        "type": "string"
      }
    },
    {
      "description": "Model domain. Default `auto`.",
      "in": "query",
      "name": "domains",
      "required": false,
      "schema": {
        "default": "auto",
        "enum": [
          "auto",
          "cams_europe",
          "cams_global"
        ],
        "type": "string"
      }
    },
    {
      "description": "End of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "end_date",
      "required": false,
      "schema": {
        "example": "2024-01-07",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Number of forecast days to return (0-7). Default 5.",
      "in": "query",
      "name": "forecast_days",
      "required": false,
      "schema": {
        "default": 5,
        "example": 7,
        "type": "integer"
      }
    },
    {
      "description": "Limit forecast to a given number of hours.",
      "in": "query",
      "name": "forecast_hours",
      "required": false,
      "schema": {
        "type": "integer"
      }
    },
    {
      "description": "Comma-separated list of hourly variables to return. Common values: `pm10`, `pm2_5`, `carbon_monoxide`, `nitrogen_dioxide`, `sulphur_dioxide`, `ozone`, `aerosol_optical_depth`, `dust`, `uv_index`, `ammonia`, `european_aqi`, `us_aqi`, and pollen (`alder_pollen`, `birch_pollen`, `grass_pollen`, `mugwort_pollen`, `olive_pollen`, `ragweed_pollen`).",
      "in": "query",
      "name": "hourly",
      "required": false,
      "schema": {
        "example": "pm10,pm2_5,european_aqi",
        "type": "string"
      }
    },
    {
      "description": "WGS84 latitude of the location. Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "latitude",
      "required": true,
      "schema": {
        "example": "52.52",
        "type": "string"
      }
    },
    {
      "description": "WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.",
      "in": "query",
      "name": "longitude",
      "required": true,
      "schema": {
        "example": "13.41",
        "type": "string"
      }
    },
    {
      "description": "Number of past days to include (0-92). Default 0.",
      "in": "query",
      "name": "past_days",
      "required": false,
      "schema": {
        "default": 0,
        "type": "integer"
      }
    },
    {
      "description": "Include a given number of past hours.",
      "in": "query",
      "name": "past_hours",
      "required": false,
      "schema": {
        "type": "integer"
      }
    },
    {
      "description": "Start of the interval, `yyyy-mm-dd` (ISO 8601).",
      "in": "query",
      "name": "start_date",
      "required": false,
      "schema": {
        "example": "2024-01-01",
        "format": "date",
        "type": "string"
      }
    },
    {
      "description": "Time output format. Default `iso8601`.",
      "in": "query",
      "name": "timeformat",
      "required": false,
      "schema": {
        "default": "iso8601",
        "enum": [
          "iso8601",
          "unixtime"
        ],
        "type": "string"
      }
    },
    {
      "description": "IANA time zone name (e.g. `Europe/Berlin`) or `auto` to resolve from coordinates. Defaults to `GMT`.",
      "in": "query",
      "name": "timezone",
      "required": false,
      "schema": {
        "example": "Europe/Berlin",
        "type": "string"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.0001,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.0001 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Default request reference estimate (USD): 0.0001
Cost contract: fixed_success
Settlement evidence source: request_snapshot

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

cell_selection

enum<string>

default:nearest

Grid-cell preference for the coordinate. Default nearest.

Available options:

land,

sea,

nearest

current

string

Comma-separated list of current-condition variables to return. Same variable set as hourly.

Example:

"european_aqi,pm2_5"

domains

enum<string>

default:auto

Model domain. Default auto.

Available options:

auto,

cams_europe,

cams_global

end_date

string<date>

End of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-07"

forecast_days

integer

default:5

Number of forecast days to return (0-7). Default 5.

Example:

7

forecast_hours

integer

Limit forecast to a given number of hours.

hourly

string

Comma-separated list of hourly variables to return. Common values: pm10, pm2_5, carbon_monoxide, nitrogen_dioxide, sulphur_dioxide, ozone, aerosol_optical_depth, dust, uv_index, ammonia, european_aqi, us_aqi, and pollen (alder_pollen, birch_pollen, grass_pollen, mugwort_pollen, olive_pollen, ragweed_pollen).

Example:

"pm10,pm2_5,european_aqi"

latitude

string

required

WGS84 latitude of the location. Multiple coordinates can be comma-separated.

Example:

"52.52"

longitude

string

required

WGS84 longitude of the location (negative for the Americas). Multiple coordinates can be comma-separated.

Example:

"13.41"

past_days

integer

default:0

Number of past days to include (0-92). Default 0.

past_hours

integer

Include a given number of past hours.

start_date

string<date>

Start of the interval, yyyy-mm-dd (ISO 8601).

Example:

"2024-01-01"

timeformat

enum<string>

default:iso8601

Time output format. Default iso8601.

Available options:

iso8601,

unixtime

timezone

string

IANA time zone name (e.g. Europe/Berlin) or auto to resolve from coordinates. Defaults to GMT.

Example:

"Europe/Berlin"

Response

Air-quality forecast for the coordinate.

The response is of type object.

Overview

Models

Search & Research

Finance & Crypto

Social & Media

SEO & Web Intel

Sales & Email

Travel & Other

Open-Meteo Air Quality

Request contract

Cost and request rules

Authorizations

Query Parameters

Response

​Request contract

​Cost and request rules

Authorizations

Query Parameters

Response

Request contract

Cost and request rules