U.S. Energy Information Administration logo
Skip to sub-navigation


Committed to making energy data more accessible, understandable, relevant, and responsive to your needs.

Notice: EIA retired its legacy API (APIv1) on March 13th, 2023. Excel add-in v1 sheets will continue to function as they are. Please refer to our documentation for the APIv2 interaction methods.

The U.S. Energy Information Administration is committed to its free and open data by making it available through an Application Programming Interface (API) and its open data tools. EIA's API is multi-facetted and contains the following time-series data sets organized by the main energy categories.

Browse the APIor Translate APIv1 Series ID to APIv2

Expand all Collapse all


  • Capability
  • includes monthly generator-level capability by fuel type, sector, and state
  • Retail sales
  • includes monthly price, customers, revenue, and sales by sector and state

Natural Gas

  • Production
  • includes monthly and annual withdrawals and production, gross withdrawals, offshore production, plant liquids, lease condensate, and methane production, and wellhead values and marketed production.
  • Prices
  • includes spot and futures prices and delivered prices to consumers.
  • Consumption/end use
  • monthly and annual natural gas consumed by product, process, and region, with heat content, deliveries, and number of consumers.
  • Exploration and reserves
  • includes annual proved reserves, natural gas wet, dry plant liquids, crude oil wells, deep sea wells, offshore, coalbed, shalegas, lease condensate, and proved non-producing.
  • Imports/exports and pipelines
  • includes monthly and annual exports, and re-exports by country, imports by state and point of entry, intra and interstate movements.
  • Storage
  • includes weekly working gas in underground storage, monthly and annual by additions and withdrawals, and storage capacity.
  • Summary
  • includes monthly and annual natural gas supply and disposition summary.


  • Crude reserves and production
  • includes monthly and annual crude oil and crude plus lease consdensate reserves and non-producing reserves, production, gulf of mexico and federal offshore, wells, drilling activity and exploration.
  • Prices
  • includes daily, weekly, monthly, and annual prices for retail gasoline and diesel fuel, spot and futures, heating oil, refiner gasoline, no.2 heating oil, propane, residual fuel, and refiner acquisition, f.o.b, and landed costs.
  • Consumption and sales
  • includes weekly product supplied, monthly and annual supplier sales volumes, motor gasoline, residual fuel oil and no. 4, kerosene, distillate fuel oil by end use.
  • Refining and processing
  • includes weekly refiner and blender net production, monthly and annual refiner and blender, etanol plant production, feeds, utilization and capacity.
  • Imports/exports and movements
  • includes weekly imports and exports and preleminary crude imports, monthly and annual crude oil imports by port of entry, processing area, exports by destination, country, api grade and by tanker, pipeline, and barge.
  • Stocks
  • includes weekly, monthly, and annual stocks by type propane/propylene, motor gasoline, distillate, and residual fuel oil for refinery, plant, and bulk terminals.
  • Summary
  • includes weekly, monthly, and annual summary data for oil supply and disposition, supply estimates, prices, and sales volumes.

Crude oil imports


  • Aggregate production
  • coal state aggregated data by mine type, includes production, productivity, labor hours, employees, and coal rank.
  • Shipments
  • mine- to plant-level data, reciepts and aggregate data including price, quantity, quality, and rank.
  • Consumption and quality
  • coal consumption and quality data by state and sector, including price, reciepts, heat content, sulfur content, ash content, and stocks.
  • Market sales and prices
  • coal market sales prices and amounts by mine types for regions and states (unless withheld for pricing protections).
  • Mine production
  • coal mine-level data, including production, region, state, county, rank, status, type, name and description.
  • Reserves capacity
  • coal capacity data, including productive capacity, stocks, and recoverable reserves by state, region and mine type.

Densified biomass

Nuclear plant generator outages

  • Pulled daily from NRC

Outlook of energy market/projections data

  • Short-term - monthly, long-term U.S. annual, and International
  • Annual Energy Outlook
  • Annual U.S. projections using National Energy Modeling System (NEMS) by release year.

Total energy

  • Total energy consolidated across all energy sources
    • Electricity
    • includes monthly and annual by grade, rank, country of origin and port of entry.
    • Natural Gas
    • seriend associated categories
    • Petroleum
    • includes monthly and annual by grade, rank, country of origin and port of entry.
    • Coal
    • seriend associated categories


  • SEDS (State Energy Data System)
    • Total Energy
    • annual state and U.S.-level data by energy source and sector in Btu units.
    • Production
    • annual state, federal offshore, and U.S.-level data by energy source in physical units and Btu for 1960 forward.
    • Consumption
    • annual state and U.S.-level data by energy source and sector in physical units and Btu for 1960 forward.
    • Prices
    • annual state and U.S.-level data by energy source and sector in current dollars per million Btu for 1970 forward.
    • Expenditures
    • annual state and U.S.-level data by energy source and sector in current dollars for 1970 forward.

CO2 Emissions

International energy

  • International energy
    • International data includes monthly and annual by grade, rank, country of origin and port of entry.
  • Spreadsheet Add-Ins

  • API Spreadsheet Adds Icon

    Access EIA data — right in your spreadsheet

  • You can download EIA energy data (and economic data from the St. Louis Federal Reserve (FRED)) directly to your spreadsheet for charts, graphs, and tables. Version 2.1.0 was released March 30, 2023.
  • Microsoft Excel Add-Ins
  • Embed Graphs & Maps

  • API Widgets

    Access EIA data — right on your website

  • Stay current and embed EIA charts and maps on your website that automatically update when the data is updated.
  • Widgets
  • Webinar

  • Watch a hands-on demo of APIv2 and live Q&A with the web development team.