Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Documentation for your Premium plan Weather API
description: 'This interactive documentation lets you try real API requests. Select an endpoint on the left and read its description for details about the available parameters. Click `Test Request` to open the interactive API client, fill in the parameters, and press `Send` to view a full API response. You can then inspect the JSON response, copy the `curl` command to run it on your machine, or obtain a URL of the request.
The Meteosource API is a RESTful API. Requests are made with `GET` and query parameters; responses are JSON-encoded, except where noted (e.g. the weather map endpoints return `image/png`).
### Base URL
The base URL for this documentation is `https://www.meteosource.com/api/v1/premium`.
### Authentication
Requests are authenticated with your unique API key, supplied in one of these ways:
* the `key` query parameter
* the `X-API-Key` header
* the `Authorization: Bearer ` header
Specifying the `key` query parameter together with either header is rejected with a `403` error, as is specifying none of them. If both headers are present, `X-API-Key` takes precedence and `Authorization` is ignored. You can find and manage your API key in your dashboard.
### Errors
The API returns standard HTTP status codes. Error responses include a JSON body with a `detail` field describing the problem:
```json
{ "detail": "explanation of what went wrong" }
```
Common error codes: `400` (invalid parameter), `402` (daily request limit exceeded), `403` (API key missing, invalid, or specified twice), `429` (per-minute rate limit exceeded).
### Pagination
The Meteosource API does not use pagination - all results for a request are returned at once.
### Important notes
* For a detailed description of the response variables, consult the response `Schema`
* Don''t assume a fixed set or order of variables and sections - new ones may be added over time. Always check a field is present before using it.
* The response includes an `Expires` header marking when the data will next change. Use it to avoid unnecessary requests and improve your app''s performance.
* HTTP compression is supported - add an `Accept-Encoding: gzip` header to enable it.'
version: v1
servers:
- url: https://www.meteosource.com/api/v1/premium
tags:
# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/meteosource-air-quality-data-api/refs/heads/main/openapi/meteosource-air-quality-data-api-weather-api-openapi.yml