IEA

Name: IEA
Creator: IEA

Public energy highlights, country metadata and observations; paid and account-gated non-CC datasets are refused.

3 Firecrawl tools use IEA

Try in Agent

Compare total final energy consumption in France and Germany in 2023, including the source units.

Try IEA now.

Choose an example or ask your own question.

What do you want to do with IEA?

IEA

TRY ASKING

Codefollows the fields above

const result = await firecrawl.scrape({
  alexandria: {
    provider: "iea-org",
    capability: "energy/datasets",
    options: {
      license: "cc_by",
      page_size: 100,
    },
  },
});

2Response example

This is a sample shape. Press Run to see live data from IEA.

{
  "complete": true,
  "count": 8,
  "next_cursor": null,
  "observed_at_ms": 1789442654248,
  "records": [
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/stats?series=BALANCES",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual; highlights refreshed once a year around the World Energy Balances release (July/August) with a preliminary latest year.",
      "coverage": {
        "countries": 165,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "world-energy-balances-highlights",
      "description": "Free highlights of the IEA World Energy Balances: indigenous production, imports, exports, total energy supply, transformation and total final consumption by sector and product for over 185 countries and regions, in TJ. Served by the Energy Statistics Data Browser API.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "frequency": "A",
      "indicators": [
        "TESbySource",
        "TFCbySource",
        "TFCbySector"
      ],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "title": "World Energy Balances Highlights",
      "unit": "TJ"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/stats?series=ELECTRICITYANDHEAT",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual, with the World Energy Balances highlights.",
      "coverage": {
        "countries": 165,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "electricity-and-heat-highlights",
      "description": "Electricity and heat generation by fuel (GWh / TJ) and electricity final consumption by sector from the free World Energy Balances highlights.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "frequency": "A",
      "indicators": [
        "ElecGenByFuel",
        "ElecConsBySector"
      ],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "title": "World Energy Balances Highlights: electricity and heat",
      "unit": "GWh"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/stats?series=OIL",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual, with the World Energy Balances highlights.",
      "coverage": {
        "countries": 165,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "oil-highlights",
      "description": "Annual oil supply and demand balance (production, imports, exports, refinery intake, final consumption by sector) by oil product, in TJ.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "frequency": "A",
      "indicators": [],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "title": "World Energy Balances Highlights: oil",
      "unit": "TJ"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/stats?series=GAS",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual, with the World Energy Balances highlights.",
      "coverage": {
        "countries": 165,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "natural-gas-highlights",
      "description": "Annual natural gas balance (production, imports, exports, transformation, final consumption by sector), in TJ gross.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "frequency": "A",
      "indicators": [],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "title": "World Energy Balances Highlights: natural gas",
      "unit": "TJ gross"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/stats?series=CO2",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual, once a year with the Greenhouse Gas Emissions from Energy release.",
      "coverage": {
        "countries": 165,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "co2-emissions-from-fuel-combustion-highlights",
      "description": "Free highlights of CO2 emissions from fuel combustion by sector (electricity and heat, other energy industries, industry, transport, residential, services, agriculture, fishing) and by fuel (coal, oil, natural gas, other), in Mt CO2, since 1990.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/greenhouse-gas-emissions-from-energy-highlights",
      "frequency": "A",
      "indicators": [
        "CO2BySector",
        "CO2Intensity"
      ],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/greenhouse-gas-emissions-from-energy-highlights",
      "title": "Greenhouse Gas Emissions from Energy Highlights (CO2 emissions from fuel combustion)",
      "unit": "MtCO2"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/mes",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Monthly, published mid-month with a two to three month lag (latest month is checked live via /mes/list/date/latest).",
      "coverage": {
        "countries": 54,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "monthly-electricity-statistics",
      "description": "Monthly net electricity production by source (coal, oil, natural gas, nuclear, hydro, wind, solar, geothermal, combustible renewables and aggregates), imports, exports, supply, pumped storage, distribution losses and final consumption for 47 OECD and selected countries plus OECD/IEA aggregates, in GWh, from January 2010.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/monthly-electricity-statistics",
      "frequency": "M",
      "indicators": null,
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/monthly-electricity-statistics",
      "title": "Monthly Electricity Statistics",
      "unit": "GWh"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/prices",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Annual highlights refreshed with the Energy Prices release; records carry the source updated_at timestamp.",
      "coverage": {
        "countries": 146,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "energy-prices-highlights",
      "description": "Annual end-use energy prices for electricity, natural gas, gasoline, diesel, LPG, light fuel oil, fuel oil and steam coal by sector (residential, industry, transport, electricity generation) in national currency, USD and 2020 USD PPP, plus taxes and ex-tax prices, and household energy cost indicators (heating, cooking, shower, cars).",
      "download_url": "https://www.iea.org/data-and-statistics/data-tools/energy-prices-data-explorer",
      "frequency": "A",
      "indicators": [
        "PRICE",
        "PRICE CONVERTED",
        "HEATHOUSE",
        "COOKING",
        "SHOWER",
        "CARS"
      ],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/energy-prices",
      "title": "Energy Prices Highlights (End-use prices, annual excerpt)",
      "unit": "national currency, USD or 2020 USD PPP per MWh / litre / tonne / GJ (per record)"
    },
    {
      "access": "api",
      "api_endpoint": "https://api.iea.org/prices",
      "attribution": "IEA (2026), <dataset title>, IEA, Paris, <source_url>, Licence: CC BY 4.0",
      "cadence": "Monthly, published around the second week of the following month; records carry the source updated_at timestamp.",
      "coverage": {
        "countries": 146,
        "year_max": null,
        "year_min": null
      },
      "dataset_id": "monthly-oil-price-statistics",
      "description": "Monthly retail prices for gasoline, automotive diesel, light fuel oil (transport and residential) in national currency and USD per litre for IEA and selected countries since 2015.",
      "download_url": "https://www.iea.org/data-and-statistics/data-product/monthly-oil-price-statistics-2",
      "frequency": "M",
      "indicators": [
        "PRICEMONTHLY"
      ],
      "last_updated": null,
      "license": {
        "spdx": "CC-BY-4.0",
        "url": "https://www.iea.org/terms/creative-commons-cc-licenses"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/monthly-oil-price-statistics-2",
      "title": "Monthly Oil Price Statistics (End-use prices, monthly excerpt)",
      "unit": "USD/l or national currency/l (per record)"
    }
  ],
  "retrieved_at": "2026-09-15T03:24:14Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://www.iea.org/data-and-statistics/data-sets?filter=free",
  "vintage": null,
  "warnings": [
    "`last_updated` is null in the static catalog; call `dataset` for a live probe."
  ]
}