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

1Request

countriesstring[]Required

Required in practice: ISO3 codes (FRA), ISO2, IEA names (France, People's Republic of China), stats codes (FRANCE, WORLD, OECDTOT, CHINAREG) or aggregate short names (EU27, OECD, IEA, World). Separate values with commas.

dataset idstringRequired

cursorstring

next_cursor from the previous page of the same query; maximum offset 200000.

flowsstring[]

Stats flow codes (TES, TFC, INDPROD, IMPORTS, EXPORTS, TOTIND, TOTTRANS, RESIDENT, ...; CO2: CO2FUEL, ELECHEAT, TOTTRANS, TOTIND, RESIDENT, ...) or price sectors (RESID, IND, TRANS, COMM, ELGEN). Not for MES. Separate values with commas.

frequencystring

Must match the dataset (annual highlights: A; monthly electricity statistics and monthly oil prices: M).

productsstring[]

Stats product codes (TOTAL, COAL, NATGAS, ELECTR, MTOTOIL, COMRENEW, GEOTHERM, HEAT, TOTPRODS; CO2: COAL, OIL, GAS, OTHER, TOTAL), MES product names (Wind, Solar, Nuclear, Hydro, Coal, Natural gas, Net electricity production, ...) or price product codes (ELECTR, NATGAS, GASOLINE, DIESEL, LPG, KEROSENE, RESFUEL, COAL). Separate values with commas.

year fromnumber

year_from

year tonumber

year_to

5 credits⌘

Codefollows the fields above

const result = await firecrawl.scrape({
  alexandria: {
    provider: "iea-org",
    capability: "energy/data",
    options: {
      countries: [
        "FRA",
      ],
      dataset_id: "world-energy-balances-highlights",
      flows: [
        "TFC",
      ],
      products: [
        "TOTAL",
      ],
      year_from: 2023,
      year_to: 2023,
    },
  },
});

2Response example

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

{
  "complete": true,
  "count": 1,
  "dataset_id": "world-energy-balances-highlights",
  "next_cursor": null,
  "observed_at_ms": 1789442654244,
  "query": {
    "countries": [
      "FRANCE"
    ],
    "dataset_id": "world-energy-balances-highlights",
    "flows": [
      "TFC"
    ],
    "frequency": "A",
    "indicators": null,
    "page_size": 20,
    "products": [
      "TOTAL"
    ],
    "year_from": 2023,
    "year_to": 2023
  },
  "records": [
    {
      "country": {
        "iea_name": "France",
        "is_aggregate": false,
        "iso3": "FRA",
        "stats_code": "FRANCE"
      },
      "dataset_id": "world-energy-balances-highlights",
      "flag": null,
      "flow": "TFC",
      "flow_label": "Total final consumption",
      "frequency": "A",
      "indicator": null,
      "indicator_label": null,
      "observed_at_ms": 1789442481218,
      "period": "2023",
      "product": "TOTAL",
      "product_label": "Total",
      "record_id": "world-energy-balances-highlights|FRANCE|TFC|TOTAL||2023",
      "scale": null,
      "source_codes": {
        "country": "FRA",
        "flow": "TFC",
        "flowLabel": "Total final consumption",
        "flowOrder": 20,
        "product": "TOTAL",
        "productLabel": "Total",
        "productOrder": 11,
        "short": "FRANCE",
        "units": "TJ",
        "value": 5700875,
        "year": "2023"
      },
      "source_updated_at": null,
      "source_url": "https://www.iea.org/data-and-statistics/data-product/world-energy-balances-highlights",
      "unit": "TJ",
      "unit_source": "api.iea.org row field `units`",
      "value": "5700875",
      "vintage": null
    }
  ],
  "retrieved_at": "2026-09-15T03:24:14Z",
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": [
    "https://api.iea.org/stats?series=BALANCES&countries=FRANCE&year=2023&products=TOTAL&flows=TFC"
  ],
  "total_records": 1,
  "vintage": null,
  "warnings": []
}