Sign up
All data sources

EIA

Your key

U.S. energy data from the EIA: prices, inventories, production, power plants, and forecasts.

oil-and-gas
Set up this sourceGet the full contract and schemas as JSONConnect this source →

Needs your own EIA key. Included on Free.

Questions you can ask

  • “Weekly U.S. crude oil inventories for the last 8 weeks.”
  • “Henry Hub spot price by month this year.”
  • “Which gas-fired generators in Texas are scheduled to retire by 2030?”
Sample outputfor “Weekly U.S. crude oil inventories.”
Week endingCrude stocks (MMbbl)Change
Sep 5421.4-1.2
Sep 12419.9-1.5
Sep 19422.3+2.4

Illustrative values showing the shape of an answer, not live data.

About this source

U.S. Energy Information Administration (EIA) API. Datasets: electricity, natural gas, coal, petroleum, STEO/AEO/SEDS, plus plant-level Form 860 generator capacity and Form 923 monthly net generation. RULES: 1. API key required (eia.gov/opendata). 2. getRoutes/getFacets discover datasets and filter values. 3. Plant-level: searchGenerators / searchPlants / getPlantGeneration / getRetirementSchedule / getFuelMix / getServiceInfo. 4. Form 860 facets: stateid, energy_source_code, prime_mover_code, balancing_authority_code, sector, status (OP/SB/OS/OA). 5. Form 923 facility-fuel facets are camelCase: plantCode, fuel2002, primeMover, state. 6. Dates: YYYY-MM (Form 860/923) or YYYY-MM-DD; pagination capped at 5000 rows/JSON response.

Connector ID eia

Provenance

PublisherEIA
API basehttps://api.eia.gov/

Freshness & coverage

FreshnessFreshness not declared
GeographicNot declared
TemporalNot declared
AuthenticationCredentials required (API key)

› Methods (22)

Technical detail for developers: parameters, pagination, units, and freshness per method.

  • getRoutes

    read

    List available EIA routes, optionally within a parent route.

    Paginationnone

  • getData

    read

    Query any EIA dataset route with filters, date bounds, and paging.

    Required paramsroute
    Paginationoffset (offsetField: offset, limitField: length)

  • getFacets

    read

    Get available filter options (facets) for a dataset

    Required paramsroute
    Paginationnone

  • getFacetDetails

    read

    Get available values for a specific facet

    Required paramsroutefacetId
    Paginationnone

  • getElectricityData

    read

    Query a curated EIA electricity dataset.

    Required paramsdataset
    Paginationoffset (offsetField: offset, limitField: length)

  • getNaturalGasData

    read

    Query EIA natural-gas data by route. Henry Hub spot: route1="pri", route2="fut", series RNGWHHD.

    Required paramsroute1
    Entitiescommodity
    Paginationoffset (offsetField: offset, limitField: length)

  • getCoalData

    read

    Convenience function for coal datasets

    Required paramsdataset
    Paginationoffset (offsetField: offset, limitField: length)

  • getPetroleumData

    read

    Weekly or monthly US crude oil inventories (stocks), petroleum prices and production by date range.

    Required paramsdataset
    Entitiescommodity
    Paginationoffset (offsetField: offset, limitField: length)

    stoc/wstk stocks; pnp/wiup refinery; pri/spt spot (RWTC, RBRTE): set frequency.

  • getSTEOData

    read

    Get Short-Term Energy Outlook (STEO) forecast projections (EIA).

    Paginationoffset (offsetField: offset, limitField: length)

  • getAEOData

    read

    Get Annual Energy Outlook (AEO) forecast projections (EIA).

    Required paramsroute1
    Paginationoffset (offsetField: offset, limitField: length)

  • getIEOData

    read

    Get International Energy Outlook (IEO) forecast projections (EIA).

    Required paramsroute1
    Paginationoffset (offsetField: offset, limitField: length)

  • getSEDSData

    read

    Get State Energy Data System (SEDS) data

    Paginationoffset (offsetField: offset, limitField: length)

  • getTotalEnergyData

    read

    Get Total Energy data

    Paginationoffset (offsetField: offset, limitField: length)

  • getCO2EmissionsData

    read

    Get CO2 Emissions data

    Required paramsdataset
    Paginationoffset (offsetField: offset, limitField: length)

  • getInternationalData

    read

    Get International energy data

    Paginationoffset (offsetField: offset, limitField: length)

  • getNuclearOutagesData

    read

    Get Nuclear Outages data

    Required paramsdataset
    Paginationoffset (offsetField: offset, limitField: length)

  • searchGenerators

    read

    Form 860 generator-level capacity search with state/fuel/BA/status filters.

    Paginationoffset (offsetField: offset, limitField: length)

  • getPlantGeneration

    read

    Form 923 monthly net generation and fuel use for a single plant.

    Required paramsplantIdstartend
    Paginationoffset (offsetField: offset, limitField: length)

  • searchPlants

    read

    One row per plant from Form 860 generators, sorted by total nameplate MW.

    Paginationnone

  • getRetirementSchedule

    read

    Find planned generator retirements by state, fuel, BA code, and year.

    Paginationoffset (offsetField: offset, limitField: length)

  • getFuelMix

    read

    EIA electricity generation fuel mix by fuel type (Form 923), state or national.

    Required paramstime
    Paginationnone

    14 non-overlapping fuels (COW, NG, NUC, WND, ...) sum to all fuels; 1000 MWh.

  • getServiceInfo

    read

    Form 860/923 routes, facets, enum values, date format, and pagination cap.

    Entitiesmetadata
    Paginationnone