Ember Electricity Data Scraper

Pull country-level electricity-sector data from Ember — the leading independent global electricity think tank. Covers generation by fuel, capacity, CO2 emissions, CO2 intensity, and demand for ~250 countries. Yearly data back to 1985, monthly data back to 2010. The closest free substitute for the IEA's paywalled Electricity Information product.

No API key, no proxy, no captcha. Data is published under CC-BY 4.0 by Ember.

---

What data is available

Ember publishes four public CSV datasets:

Dataset	Coverage	Records	Updated
Global yearly	~250 countries, 1985–present	~300,000 rows	Monthly
EU yearly	EU + wider Europe, 1985–present	~60,000 rows	Monthly
Global monthly	~80 countries, 2010–present	~1.3M rows	Monthly
EU monthly	EU + wider Europe, 2010–present	~250,000 rows	Monthly

Each row is one country × period × fuel × variable record, e.g.:

• Germany / 2023 / Solar / Generation → 59.7 TWh
• Germany / 2023 / — / CO2 intensity → 385 gCO2/kWh
• France / 2023-07 / Nuclear / Share of generation → 67.4 %

---

Fields returned

Field	Type	Description
country	string	Country or region name (e.g. Germany, European Union)
country_iso3	string	ISO-3 code (e.g. DEU)
continent	string	Continent
ember_region	string	Ember's regional grouping
period_type	string	yearly or monthly
year	integer	Year (e.g. 2023)
month	integer	Month 1–12 for monthly rows; null for yearly
category	string	Electricity generation, Capacity, Electricity demand, Emissions, Imports
subcategory	string	Fuel: Coal, Gas, Nuclear, Solar, Wind, Hydro, Bioenergy, Other fossil, Clean, Fossil
variable	string	Metric: Generation, Share of generation, Capacity, CO2 intensity, Demand, …
unit	string	TWh, GW, gCO2/kWh, MtCO2, %, MWh
value	number	Value in the indicated unit
source_dataset	string	ember-yearly-global | ember-yearly-eu | ember-monthly-global | ember-monthly-eu

---

Input options

Field	Type	Default	Description
periodType	select	yearly	yearly, monthly, or both
scope	select	global	global, europe, or both
countries	string[]	all	Country names or ISO-3 codes to include
yearFrom	integer	2010	Earliest year (yearly data starts 1985; monthly 2010)
yearTo	integer	2024	Latest year (inclusive)
variables	string[]	all	Filter by variable name (e.g. CO2 intensity, Generation)
maxItems	integer	10	Maximum records to return (0 = unlimited)

Example: Scope 2 carbon intensity by country (2023)

{
  "periodType": "yearly",
  "scope": "global",
  "variables": ["CO2 intensity"],
  "yearFrom": 2023,
  "yearTo": 2023,
  "maxItems": 300
}

Returns one row per country with the grid CO2 intensity (gCO2/kWh) — exactly what Scope-2 location-based GHG accounting requires.

Example: Germany full electricity mix (monthly, last 2 years)

{
  "periodType": "monthly",
  "scope": "global",
  "countries": ["Germany"],
  "yearFrom": 2023,
  "yearTo": 2024,
  "maxItems": 500
}

Example: EU solar generation history

{
  "periodType": "yearly",
  "scope": "europe",
  "variables": ["Generation"],
  "yearFrom": 2010,
  "yearTo": 2024,
  "maxItems": 0
}

---

Use cases

• Scope-2 GHG reporting — location-based grid carbon intensity by country x year, as required by the GHG Protocol.
• Corporate sustainability benchmarking — compare grid decarbonisation across supplier countries.
• Climate equity research — multi-decade fuel mix and emissions by country for academic and Bloomberg Green / FT-style analysis.
• LCA / EPD providers — background electricity data for product carbon footprints (replaces manual IEA downloads).
• Energy policy analysis — track solar/wind penetration, coal retirement, and clean share by country.
• Data journalism — verified reference dataset for carbon intensity stories.

---

Data source and attribution

Data sourced from Ember, published under CC-BY 4.0. When using this data, attribute as: "Source: Ember (ember-energy.org)".

Ember publishes updates monthly. Run this actor after each Ember release to keep your dataset current.

---

Sister actors

• ENTSO-E European Power Market Scraper — sub-hourly EU market prices, cross-border flows, and actual generation by bidding zone (complements Ember's annual/monthly country aggregates).
• EnergiDataService Nordic Power Scraper — Nordic balancing market data.