v1 API reference

The meteofeed weather API

One bearer token, many authoritative sources — forecast, observations, radar, marine, air quality, climate, historical and geocoding across the globe. The full machine-readable contract is below; here is what you need to make the first call.

Quick start

Base URL

https://api.meteofeed.com/v1

Every endpoint is versioned under /v1. Responses are JSON; radar returns PNG tiles.

Authentication

Every protected endpoint takes a bearer token. Send it in the Authorization header on each request:

Authorization: Bearer mtfd_…

Keys look like mtfd_… and are shown once, when created. Keep them server-side.

Tiers & rate limits

Free includes 500 requests per month; Basic, Pro and Business raise the monthly quota up to 1,000,000. The per-key burst limit scales with the plan: 120 requests per minute on Free, 240 on Basic, 360 on Pro and 600 on Business. Exceeding the quota or the burst returns 429 with a Retry-After header.

Get a key

Sign in to your dashboard to create a key. During the private preview, new accounts are approved from the access-request queue.

Get an API key →

Example request

Current conditions at a point (Amsterdam). Swap in your own token.

curl -H "Authorization: Bearer mtfd_…" \
  "https://api.meteofeed.com/v1/current?lat=52.37&lng=4.90"

This page is available in 12 languages — use the switcher above. The reference below is in English, the API contract.