IEA Energy Data — SDG7 & Energy Indicators

Query any indicator in the public IEA indicator catalogue by country and year, with a free indicator list, flow and product dimensions, provenance and source age. Built for energy research, policy analysis, and SDG7 monitoring. One row per indicator-country-year, clean JSON out.

---

Why use this scraper

• Full indicator catalogue. Query any IEA indicator — SDG7 (access to electricity, clean cooking, renewables, energy efficiency) plus broader energy statistics (TPES, TFC, CO2 emissions, electricity generation, energy intensity).
• Country and year filtering. Query any combination of ISO3 country codes and years. WORLD for global aggregates.
• Flow and product dimensions. Energy data broken down by flow (consumption, production, transformation) and product (coal, oil, gas, renewables, electricity).
• Provenance and source age. Each data point includes its source and how recent it is.
• Free indicator list. Optionally fetch the full IEA indicator catalogue to discover available codes.

---

Overview

The International Energy Agency (IEA) publishes energy data through a public API at api.iea.org. This actor queries that API by indicator, country, and year, returning structured data with flow/product dimensions, provenance, and source age. It covers SDG7 indicators (access to electricity, clean cooking, renewable energy share, energy efficiency) plus broader energy statistics (total final consumption, total primary energy supply, CO2 emissions, electricity generation).

---

Use cases

• SDG7 monitoring — track progress on access to electricity, clean cooking, renewables, and energy efficiency.
• Energy research — analyze energy consumption, production, and transformation by country and year.
• Policy analysis — compare countries on CO2 emissions, energy intensity, and renewable share.
• Data journalism — source IEA data for energy reporting and visualizations.
• Academic research — build energy datasets for econometric and climate modeling.

---

How it works

1. You provide indicator codes, ISO3 country codes, and years.
2. The actor queries the IEA API (api.iea.org/indicator) for each combination.
3. It normalizes the response into flat rows with indicator, country, year, value, unit, flow, product, source, and source age.
4. Each data point becomes one row in the dataset.

---

Input

Field	Type	Default	Notes
indicators	array	SDG7 + energy defaults	IEA indicator codes (e.g. TFCBySector, TPESBySource).
countries	array	WORLD	ISO3 country codes (e.g. USA, CHN, WORLD).
years	array	2020–2022	Years to query.
includeIndicatorList	boolean	false	Fetch the free IEA indicator catalogue.
maxItems	integer	10000	Maximum data rows to output.
proxy	object	Apify proxy	Residential recommended — IEA API is behind Cloudflare Turnstile.

{
  "indicators": ["TFCBySector", "TPESBySource", "CO2EmissionsBySector"],
  "countries": ["WORLD", "USA", "CHN"],
  "years": [2020, 2021, 2022]
}

---

Default indicators

When indicators is empty, the actor uses these defaults:

• TFCBySector — Total Final Consumption by Sector
• TPESBySource — Total Primary Energy Supply by Source
• CO2EmissionsBySector — CO2 Emissions by Sector
• ElectricityGenerationBySource — Electricity Generation by Source
• EnergyIntensity — Energy Intensity (GDP-based)
• AccessToElectricity — SDG7: Access to Electricity
• AccessToCleanCooking — SDG7: Access to Clean Cooking
• RenewableShare — SDG7: Renewable Energy Share

---

Output

One row per indicator-country-year:

{
  "type": "energy-indicator",
  "indicator": "TFCBySector",
  "country": "WORLD",
  "year": 2022,
  "value": 439.7,
  "unit": "Mtoe",
  "flow": "Final consumption",
  "product": "Total",
  "source": "IEA Energy Balances",
  "sourceAge": 45,
  "scrapedAt": "2026-10-03T22:30:00.000Z"
}

Key output fields

• indicator — IEA indicator code.
• country — ISO3 country code.
• year — data year.
• value — indicator value.
• unit — unit of measurement (Mtoe, GWh, %, etc.).
• flow — energy flow dimension (consumption, production, transformation).
• product — energy product dimension (coal, oil, gas, renewables, electricity).
• source — data source (IEA Energy Balances, IEA CO2 Emissions, etc.).
• sourceAge — source age in days.

---

⚠️ Cloudflare Turnstile

The IEA API (api.iea.org) is behind Cloudflare Turnstile. From datacenter IPs, all endpoints return 404. Use residential proxies (Apify's residential pool) to bypass the challenge. The actor is configured to use Apify proxy by default — switch to residential in the proxy settings for production runs.

---

⚠️ Disclaimer

This Actor queries the public IEA API. The data is © IEA and is used here under their published terms. You are responsible for using the output in line with IEA's terms and any applicable law in your jurisdiction. This Actor is not affiliated with, endorsed by, or sponsored by the IEA.

---

SEO Keywords

iea energy data, iea api, sdg7 data, energy indicators, energy statistics, energy balances, total final consumption, total primary energy supply, co2 emissions, electricity generation, energy intensity, access to electricity, clean cooking, renewable energy share, iea data browser, energy data by country, energy data by year, international energy agency data