IEA Energy Data Scraper [$1.50/1K💰] | CO2 | Electricity

IEA Public Energy Data Scraper

Extract free energy statistics from the International Energy Agency (IEA) — CO2 emissions, electricity generation, renewables, oil, gas, coal, energy supply and consumption, prices, efficiency and SDG7 indicators — without a browser, an API key, or a paid subscription.

This Apify Actor uses the public API behind the IEA Data Browser and returns tidy, analysis-ready rows that drop straight into CSV, Excel, BI tools or a database.

Build Energy & Climate Datasets For Analysis

• CO2 and emissions research — pull greenhouse-gas and CO2 emission time series by country or region.
• Electricity and renewables tracking — extract generation by source (solar, wind, hydro, nuclear) for any country set.
• Energy market and price analysis — compare energy prices, supply, consumption and efficiency indicators across countries.
• Climate and SDG reporting — collect SDG7 energy-access and renewables indicators for dashboards and reports.
• Data journalism and academic research — assemble reproducible historical time series from a single run.

How It Works

The Actor loads the live IEA indicator and country catalogs, validates every selected code and batches countries into parallel indicator requests. Year, flow, product, null-value and latest-only filters are applied before rows are pushed.

Each row covers one indicator, country, year, flow and product with its value, unit, labels, categories and source dataset. Catalog modes return indicator and country metadata.

1. The Actor fetches the live IEA indicator and country catalogs.
2. Selected indicators and countries are validated and normalized (unknown codes fail with suggestions, never silent wrong data).
3. Countries are split into batches and each indicator is fetched in parallel with a configurable concurrency limit.
4. Year, flow, product, null-value and latest-only filters are applied.
5. Normalized rows are pushed to the Apify dataset in batches.

No Apify Proxy is needed and no browser is launched. The Actor identifies itself with a clear User-Agent, retries rate limits and transient server errors with exponential backoff, and reports partial failures and graceful cancellation.

Input Parameters

Field	Type	Required	Default	Notes
mode	string	No	data	data fetches statistics; indicators and countries return the live catalogs.
indicators	array	No	["TESbySource"]	Indicator IDs such as TotCO2, ElecGenByFuel, SDG71, GasPrice, or ["all"] for all 78.
countries	array	No	["WORLD"]	ISO 2/3 codes, IEA codes, names, regions, or ["all"]. E.g. DE, DEU, Germany, EU27_2020.
startYear	integer	No	1990	First year, inclusive. 0 = earliest available.
endYear	integer	No	0	Last year, inclusive. 0 = latest available.
latestOnly	boolean	No	false	Keep only the most recent year per indicator and country/region.
includeNullValues	boolean	No	false	Keep rows where the IEA reports no numeric value.
flows	array	No	[]	Optional flow codes or labels, e.g. ESOLARPV, EWIND, Coal.
products	array	No	[]	Optional product codes or labels, e.g. ELECTR, TOTAL, Electricity.
maxConcurrency	integer	No	6	Simultaneous requests, 1–20.
countryBatchSize	integer	No	25	Countries per API request, 1–100.
maxRows	integer	No	0	Stop after this many rows. 0 = no limit.

Flow and product filters match both API codes and human-readable labels, case-insensitively.

Output Fields

One row per indicator, country/region, year, flow and product:

recordType (energyStat, indicator, country), indicator, indicatorName, categories, country, countryName, iso2, iso3, year, value, unit, flow, flowLabel, product, productLabel, seriesLabel, statsCode, isRegion, sourceDataset, sourceUrl, retrievedAt, note.

The dataset includes two views: Energy data and Catalogs.

Example Input

Latest CO2 emissions for three countries:

{
  "mode": "data",
  "indicators": ["TotCO2"],
  "countries": ["DEU", "FRA", "USA"],
  "latestOnly": true
}

Solar and wind electricity generation for the EU since 2015:

{
  "mode": "data",
  "indicators": ["ElecGenByFuel"],
  "countries": ["EU27_2020"],
  "startYear": 2015,
  "flows": ["ESOLARPV", "EWIND"]
}

List the full indicator catalog:

{ "mode": "indicators" }

Example Output

{
  "recordType": "energyStat",
  "indicator": "ElecGenByFuel",
  "indicatorName": "Electricity generation by source",
  "categories": ["Electricity and heat", "Energy supply"],
  "country": "DEU",
  "countryName": "Germany",
  "year": 2022,
  "value": 61022,
  "unit": "GWh",
  "flow": "ESOLARPV",
  "flowLabel": "Solar PV",
  "product": "ELECTR",
  "productLabel": "Electricity",
  "seriesLabel": "Solar PV",
  "sourceDataset": "Electricity Information",
  "sourceUrl": "https://www.iea.org/data-and-statistics",
  "retrievedAt": "2026-10-20T12:00:00.000Z"
}

Catalog modes return metadata rows instead:

{
  "recordType": "indicator",
  "indicator": "TotCO2",
  "indicatorName": "Total CO2 emissions",
  "categories": ["CO2 emissions", "Key indicators"],
  "sourceDataset": "World Energy Balances",
  "sourceUrl": "https://www.iea.org/data-and-statistics",
  "note": null
}

Automate Energy Data Refreshes With Schedules & Webhooks

• Schedule monthly or quarterly runs to keep energy and emissions time series current as the IEA republishes data.
• Pipe results to Google Sheets, a data warehouse, Zapier, Make or your own webhook for automated dashboards and alerts.
• Read the dataset through the Apify REST API to feed a data pipeline, BI tool or research notebook.
• Use latestOnly for compact "current value" snapshots, or a year range for full history.

Related Actors

• EIA Energy Scraper — US Energy Information Administration data (petroleum, electricity sales, natural gas prices) to complement IEA global series.
• IEA Energy Data (SDG7 & energy indicators) — an alternative IEA indicator query tool with batch, HTTP and MCP access.
• FRANCE Energy Ratings (DPE) — building-level energy performance certificates for France.
• data.gov.my Scraper — Malaysia open-data statistics, including fuel prices and industrial production.
• Wikipedia Scraper — enrich country and topic context for reports.

Frequently Asked Questions

Why use this Actor instead of the official IEA API?

The IEA's formal Releases API with an API key is offered only to customers on an Enterprise or Global Enterprise licence. The public data behind the IEA Data Browser, however, is free to query. This Actor uses that free public API, so you get the Data Browser's indicators without a paid licence or API key.

What are alternatives to scraping IEA data?

Alternatives include the EIA (US data) for US-specific energy series, Eurostat for EU statistics, or the free IEA Data Browser manually. This Actor automates the public IEA Data Browser into clean rows and adds live indicator and country catalogs so you can discover valid codes in-run.

Is IEA data free to use?

Many IEA series are published under the CC BY 4.0 licence, but terms can vary by dataset. This Actor only accesses free, public data; it does not access IEA paywalled products or paid licences. Check the source page for each indicator before redistributing derived data.

How many indicators and countries are covered?

78 public IEA indicators and 185 countries, regions and aggregates, including ISO country codes, WORLD, EU27_2020, G20, OECD aggregates and IEA regions.

Can I get historical time series?

Yes. Coverage is typically 1960 or 1990 through the latest available year, depending on the indicator. Use startYear and endYear to bound the range.

Why does latestOnly sometimes return a projection?

Some indicators include projections — for example the SDG7 series extends to 2050 — so latestOnly selects the latest reported year, which can be a projection. Set endYear to a historical year to exclude projections.

For AI Agents & LLM Apps

Purpose: return tidy IEA energy statistics rows (or catalog metadata) for selected indicators, countries and years.

Minimal working input:

{ "mode": "data", "indicators": ["TotCO2"], "countries": ["DEU"], "latestOnly": true }

Catalog-discovery variant:

{ "mode": "indicators" }

Output fields: recordType, indicator, indicatorName, categories, country, countryName, iso2, iso3, year, value, unit, flow, flowLabel, product, productLabel, seriesLabel, statsCode, isRegion, sourceDataset, sourceUrl, retrievedAt, note.

Behaviors an agent should know:

• mode controls the output shape: data = statistics rows, indicators / countries = catalog metadata rows.
• ["all"] in indicators or countries expands to every available code — this can be very large; bound it with maxRows and year filters.
• latestOnly: true keeps one row per indicator/country; it can select a projection year (see FAQ).
• Indicator IDs are case-insensitive and also accept full names; unknown values fail with suggestions rather than returning wrong data.
• Billing: pay-per-event — each result row is $0.0015, plus a symbolic $0.00005 Actor-start event.

Legal & Compliance Disclaimer

This is an independent Actor and is not affiliated with, endorsed by, or sponsored by the International Energy Agency (IEA). It accesses only the free, public data exposed through the public API used by the IEA Data Browser; no login is required, no CAPTCHA solving is performed, and it does not access IEA paywalled products, licences or access controls. IEA statistics are subject to the IEA terms and, for many series, the CC BY 4.0 licence; terms vary by dataset. Users are responsible for attributing the source and complying with the applicable IEA licence terms and any other applicable law when using or redistributing the data.

SEO Keywords

iea energy data, iea data browser, iea statistics api, international energy agency data, energy statistics scraper, co2 emissions data, co2 emissions by country, electricity generation by source, renewables data, energy supply and consumption data, energy price data, energy efficiency indicators, sdg7 energy access data, climate data scraper, open energy data, energy time series, world energy balances data, greenhouse gas emissions data, energy data api, iea alternative