Using the HESTIA Data API

The Data API allows anyone to access all public data stored in HESTIA, in a compacted (pivoted) format.

The API does not require creating an account.

You can test the API, and see all endpoints available, on the Swagger docs.

The API is used on the Data Explorer.

Aggregated Data

You can use the Data API to retrieve aggregated data, in the same way as the Data Explorer.

Here are some usage examples:

• Get the releases available in HESTIA:

$ curl -X 'GET' \
  'https://api.hestia.earth/settings/dataReleases' \
  -H 'accept: application/json' \

• Get the first 50 Aggregated data for the v1 release on 2025-05-01:

$ curl -X 'GET' \
  'https://data.hestia.earth/aggregated-nodes?offset=0&limit=50&sortBy=name&sortOrder=asc' \
  -H 'accept: application/json' \
  -H 'X-Data-Version: 2025-05-01'

• Search for aggregated data, for Wheat, grain and Maize, grain, in France and United Kingdom:

$ curl -X 'GET' \
  'https://data.hestia.earth/aggregated-nodes?filter=regions%3DUnited%20Kingdom%7CFrance%3Bproducts%3DWheat%2C%20grain%7CMaize%2C%20grain&offset=0&limit=50&sortBy=name&sortOrder=asc' \
  -H 'accept: application/json'

Notes:

• if you do not set the X-Data-Version header, the latest available data will be returned;
• the limit for a single request is 50 results. If the count in the response is greater than 50, you can paginate using the offset parameter. Example: limit=50&offset=100 will return the results from 100 to 150.