Firecrawl Alexandria

US Energy Information Administration

Discover EIA energy data routes, enumerate facet values and retrieve energy observations with source units and labels.

13 ready-made skills use US Energy Information Administration

Try US Energy Information Administration now.

Choose an example or ask your own question.

US Energy Information Administration
TRY ASKING
1Request
stringRequired

Frequency id from the route metadata: annual, quarterly, monthly, weekly, daily, hourly or local-hourly.

stringRequired

Route path with data, such as `petroleum/pri/spt` (do not append `/data`).

string

Registered EIA API key. Omitted, the public data-browser key is discovered live (see `routes`).

string

`next_cursor` from the previous page (a row offset). Omit for the first page.

string[]

Data columns to return, from the route's `data_columns`. Defaults to ["value"]. Separate values with commas.

object

Facet filters: facet id to list of codes, e.g. {"series": ["RWTC"]} or {"stateid": ["CA"], "sectorid": ["RES"]}.

number

Rows per page; the API caps a page at 5000 rows.

5 credits
Codefollows the fields above
const result = await firecrawl.scrape({
  alexandria: {
    provider: "eia-gov",
    capability: "energy-data/data",
    options: {
      facets: {
        series: [
          "RWTC",
        ],
      },
      frequency: "daily",
      page_size: 3,
      route: "petroleum/pri/spt",
    },
  },
});
2Response example

This is a sample shape. Press Run to see live data from US Energy Information Administration.

{
  "api_version": "2.1.13",
  "complete": true,
  "count": 3,
  "data_columns": [
    {
      "aggregation_method": null,
      "alias": "value",
      "id": "value",
      "units": null
    }
  ],
  "date_format": "YYYY-MM-DD",
  "frequency": "daily",
  "next_cursor": "3",
  "observed_at_ms": 1789110000000,
  "offset": 0,
  "page_size": 3,
  "records": [
    {
      "attributes": {},
      "facets": {
        "duoarea": {
          "code": "YCUOK",
          "name": "NA"
        },
        "process": {
          "code": "PF4",
          "name": "Spot Price FOB"
        },
        "product": {
          "code": "EPCWTI",
          "name": "WTI Crude Oil"
        },
        "series": {
          "code": "RWTC",
          "name": "Cushing, OK WTI Spot Price FOB (Dollars per Barrel)"
        }
      },
      "frequency": "daily",
      "id": "2026-09-09|YCUOK|EPCWTI|PF4|RWTC",
      "period": "2026-09-09",
      "route": "petroleum/pri/spt",
      "series_id": "RWTC",
      "source_url": "https://api.eia.gov/v2/petroleum/pri/spt/data/?frequency=daily&data%5B0%5D=value&facets%5Bseries%5D%5B%5D=RWTC&sort%5B0%5D%5Bcolumn%5D=period&sort%5B0%5D%5Bdirection%5D=desc&offset=0&length=3",
      "units": {
        "value": "$/BBL"
      },
      "values": {
        "value": "97.26"
      }
    },
    {
      "attributes": {},
      "facets": {
        "duoarea": {
          "code": "YCUOK",
          "name": "NA"
        },
        "process": {
          "code": "PF4",
          "name": "Spot Price FOB"
        },
        "product": {
          "code": "EPCWTI",
          "name": "WTI Crude Oil"
        },
        "series": {
          "code": "RWTC",
          "name": "Cushing, OK WTI Spot Price FOB (Dollars per Barrel)"
        }
      },
      "frequency": "daily",
      "id": "2026-09-08|YCUOK|EPCWTI|PF4|RWTC",
      "period": "2026-09-08",
      "route": "petroleum/pri/spt",
      "series_id": "RWTC",
      "source_url": "https://api.eia.gov/v2/petroleum/pri/spt/data/?frequency=daily&data%5B0%5D=value&facets%5Bseries%5D%5B%5D=RWTC&sort%5B0%5D%5Bcolumn%5D=period&sort%5B0%5D%5Bdirection%5D=desc&offset=0&length=3",
      "units": {
        "value": "$/BBL"
      },
      "values": {
        "value": "94.21"
      }
    },
    {
      "attributes": {},
      "facets": {
        "duoarea": {
          "code": "YCUOK",
          "name": "NA"
        },
        "process": {
          "code": "PF4",
          "name": "Spot Price FOB"
        },
        "product": {
          "code": "EPCWTI",
          "name": "WTI Crude Oil"
        },
        "series": {
          "code": "RWTC",
          "name": "Cushing, OK WTI Spot Price FOB (Dollars per Barrel)"
        }
      },
      "frequency": "daily",
      "id": "2026-09-04|YCUOK|EPCWTI|PF4|RWTC",
      "period": "2026-09-04",
      "route": "petroleum/pri/spt",
      "series_id": "RWTC",
      "source_url": "https://api.eia.gov/v2/petroleum/pri/spt/data/?frequency=daily&data%5B0%5D=value&facets%5Bseries%5D%5B%5D=RWTC&sort%5B0%5D%5Bcolumn%5D=period&sort%5B0%5D%5Bdirection%5D=desc&offset=0&length=3",
      "units": {
        "value": "$/BBL"
      },
      "values": {
        "value": "92.69"
      }
    }
  ],
  "retrieved_at": "2026-09-11T07:00:00Z",
  "route": "petroleum/pri/spt",
  "route_period_range": {
    "end": "2026-09-04",
    "start": "1986-01-03"
  },
  "schema_version": "1.0.0",
  "source_updated_at": null,
  "source_url": "https://api.eia.gov/v2/petroleum/pri/spt/data/?frequency=daily&data%5B0%5D=value&facets%5Bseries%5D%5B%5D=RWTC&sort%5B0%5D%5Bcolumn%5D=period&sort%5B0%5D%5Bdirection%5D=desc&offset=0&length=3",
  "total": 10245,
  "warnings": [
    "incomplete return: The API can only return 5000 rows in JSON format.  Please consider constraining your request with facet, start, or end, or using offset to paginate results."
  ]
}

Use cases

13

Built-in skills that call US Energy Information Administration.

Browse the library
//
Get started
//
Give your agent US Energy Information Administration.
One API key for the live web and every provider in Alexandria.
Are you an AI agent? See setup options