The planet's live data, in your own code.
The same feeds the globe runs on, as JSON, CSV or GeoJSON. That's 25 datasets in 4 groups, from earthquakes and lightning to the UK grid, rivers and the sea. Every answer carries its credit line, so a saved file never loses it.
25 datasets, ready to call.
These counts come from the API's own description, so when a dataset is added or withdrawn, this page follows. Tap one to jump to its fields, parameters and an example answer.
It comes with Pro.
There's no separate API plan to work out. Pro is the plan with the API in it, and every Pro account can make keys.
Pro
£12a month
or £108 a year. The price comes straight from checkout, so it can't disagree with it.
Soon
Pro isn't on sale yet. Its price shows here the moment checkout has it, read live like the rest of this site.
Calls
10,000a day, per key
- The count starts again at midnight UK time.
- A refusal doesn't count against your key.
- A 304 does count (it still did the work).
- A grid range read counts one call for every 24 time steps it reads.
Your first call, in three steps.
- Make a key.
On Pro, open your account panel at askthe.earth and make a key under API keys. Give it a name. It's shown once, so copy it then.
- Call a dataset.
Send the key in the Authorization header. A key in the URL is refused, so it never ends up in a log or your browser history.
curl -H "Authorization: Bearer le_live_YOUR_KEY" \ "https://api.askthe.earth/v1/quakes?format=geojson" - Show the credit.
It's in the
X-LE-Creditheader and in the body. Wherever the data appears, the credit goes with it.X-LE-Calls-Lefttells you how many calls the key has left today.
Want a look before you buy? The dataset list and the health check need no key at all:
curl "https://api.askthe.earth/v1/datasets"
Every dataset, field and error.
Generated from the API's own code, so it says what the service actually sends. Want the file? openapi.json is OpenAPI 3.1, ready for your code generator or API tool. The full guide covers the archive, the limits and the small print.
The reference needs JavaScript. Without it, read openapi.json or the full guide.