Firecrawl Alexandria

US Energy Information Administration

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."
  ]
}
Browse the library