Understand and optimize the carbon footprint of electricity

electricityMap API is the world's most comprehensive platform measuring the carbon footprint of your electricity consumption.

electricityMap API usecase engage


Climate think tank Ember uses the electricityMap API to illustrate trends in the global electricity system.

electricityMap API usecase mobility


Danish electricity retailer Barry is using the electricityMap API to show customers the carbon footprint of their electricity.

electricityMap API usecase engage


Electric radiator startup Lancey Energy Storage uses the electricityMap API to optimize and reduce the carbon footprint of their product.

The leading platform for understanding the climate impact of electricity

Access hourly live, historical, and forecasted data from 223 areas around the world.

Comprehensive data

Historical, live, and forecast data
Carbon intensity and power breakdown
Exclusive marginal data

Global Coverage

Worldwide coverage
Standardized across regions
Includes imports & exports across regions

High frequency

Hourly granularity
24h ahead forecasts
Updated in real-time

Read more about our methodology on our blog, or take a look at our recently published paper.

See the grid's past, present, and future

Live carbon intensity

GET /carbon-intensity/latest

Live power breakdown

GET /power-breakdown/latest

Marginal carbon intensity

GET /marginal-carbon-intensity/latest

Marginal power breakdown

GET /marginal-power-consumption-breakdown/latest

Recent carbon intensity

GET /carbon-intensity/history

Recent power breakdown

GET /power-breakdown/history

Forecasted carbon intensity

GET /carbon-intensity/forecast

Forecasted power breakdown

GET /power-breakdown/forecast

Marginal carbon intensity

GET /marginal-carbon-intensity/forecast

Marginal power breakdown

GET /marginal-power-consumption-breakdown/forecast

carbonIntensity: 302,
datetime: 2019-04-25T18:07:00.350Z

Learn more by reading our marginal emissions guide, API documentation and FAQs.

Customers and Partners


Full access for a single country
  • Commercial use license
  • Single country access
  • Live and forecasted data
  • Carbon intensity data
  • Power breakdown data
  • Complete historical data

Marginal data available

with annual commitment

Complete access for all countries
  • Commercial use license
  • Access to all countries
  • Live and forecasted data
  • Carbon intensity data
  • Power breakdown data
  • Complete historical data
  • Dedicated support

Marginal data available

Contact us
for a quote

Students can use our CO2 Signal API free of charge for non-commercial use. At this time, we do not offer historical data free of charge.

Available in 223 geographies

And growing.

Get started today!

Premium and Enterprise services come with historical, live, and forecasted data. At this time, we do not offer electricityMap API access free of charge.


Thank you for your interest in electricityMap API, we'll be in touch with you shortly.

Frequently asked questions

What kinds of data can you get from the API?

Broadly speaking, we offer hourly electricity production, consumption, and carbon intensity data in over 100 geographies around the world, including breakdowns of fuel sources used and imports/exports of power between countries and regions. You can learn more about the data we offer, including a sample output CSV and the specific units of each column here.

Where do you get your data from?

The raw data comes into our system from a variety of public data sources, which are listed here. Our system then standardizes and aggregates these data sources to account for imports and exports of power between countries and uses this data to train our marginal and forecast models.

The emission factors we use to calculate our carbon intensity data are from the Intergovernmental Panel on Climate Change (IPCC) 5th assessment report. However, since our API returns power production/consumption data as well as carbon intensity data, the user can use their own emission factors and come to their own carbon intensity calculations if they would like.

How often is the data updated? How relevant is the data I am seeing?

All of our API data is updated every hour for that hour, while our historical data is only updated if we are made aware of a data quality issue (though we periodically monitor for these issues). Our forecasts are also updated every hour, meaning that at any given time, our Forecast API returns forecasted values for the next 24 hours.

Do you have historical data as well as live and forecast data?

Yes, we have an extensive historical database for most areas on the electricityMap. You can learn more about how many years back our datasets go for a given area here under the “Zone covered” tab.

We offer our historical data as a paid product either in the form of our API or in the form of CSV files. If you’re interested, please reach out with the contact form.

How do you make your calculations? I’d like to learn more about your methodology.

In addition to writing extensive on our public Github repo about our methodology, we have also published a paper in collaboration with the Technical University of Denmark, Real-time carbon accounting method for the European electricity markets.

Finally, if you’d like to learn more about our Marginal methodology specifically, this post and this post from our blog will be helpful.

So what is “marginal” anyways?

When a consumer is asking for more electricity from the grid, that additional electricity will come from the cheapest power plant that still has spare capacity at that time. This power plant is called the marginal power plant. Typically the marginal plant is a system that can react quickly to changes in electricity demand, such as a gas turbine. It however cannot be a wind turbine or solar cells, as you can’t command them to produce more (unless you command the weather that is). The carbon footprint of that additional electricity represents the consumer’s marginal emissions, and via our Marginal API we have built a model to estimate this. To learn more about the marginal methodology and how to use it, read our blog post about it.

[X region] isn’t showing any data on the electricityMap - why?

We have set ourselves a data standard - we currently only show live, hourly-updated data on the electricityMap that is derived from hourly (or even more frequently updated) publicly available data from trusted sources. When a country or region doesn’t have any data on the map, this is either because our data source was not reporting up to our standards or because we have not found a public data source that fits our standards.

Much of the data on the electricityMap can be attributed to our amazing community of enthusiastic contributors who have found public data sources - join us and help fill in the blanks at our public Github repo!

How much does the electricityMap API cost?

You can see our starting pricing for each API tier here

What do the borders on the electricityMap mean? I see some countries that appear to be split up on the map.

The electricityMap is divided into “zones” which are represented from the boundaries depicted on electricityMap.org. These zones correspond to zones in the electricityMap API.

Often, one country equals one zone, but there are many instances where this is not the case. Countries are sometimes split into several zones, mainly because our data sources show a significant difference in power production/consumption in different regions of a country (usually this means the country is running on several distinct grids) and we have access to the public data needed to depict this.

Do you offer any discounts?

Yes. We offer a 60% discount from our normal pricing for educational institutions and non-profits. This means the "Premium" tier starts at 200€/month, with yearly commitment instead of 500€/month.

Can you give me a quote?

Sure! Please reach out to us via the contact form.

Can I have a free trial of your API/sample of your historical data?

Sure! Reach out to us with your request via the contact form.

Can I pay up front/quarterly instead of monthly?

For larger commercial arrangements or for institutions with strict payment constraints such as universities, we will work with you to find the payment arrangement that best fits your constraints.