Get Dataset Data

Retrieves actual data points for a dataset, with optional filters like facets, frequency, date range, sorting, and pagination.

byU.S. Energy Information Administration (EIA)

696calls

N/Alatency

Discover -> Inspect -> Call

Call setup

Tool IDeia.datasets.data.v2

Request parametersJSON

Before this Call

1 credit / call

The final charge is settled from actual provider usage and will appear in Usage.

Field reference

categorystringRequired

The parent category, e.g., 'electricity'.

subcategorystringRequired

The subcategory or dataset, e.g., 'retail-sales'.

data[]arrayOptional

Array of data columns to retrieve, e.g., ['price', 'revenue'].

facets[{facet_id}][]arrayOptional

Facet filters, e.g., facets[sectorid][]=RES.

frequencystringOptional

Data frequency, e.g., 'monthly', 'quarterly', 'annual'.

startstringOptional

Start date for data range, e.g., '2008-01-31'.

endstringOptional

End date for data range, e.g., '2008-03-01'.

sort[{precedence}][column]stringOptional

Sorting column, e.g., sort[0][column]=period.

sort[{precedence}][direction]stringOptional

Sort direction, 'asc' or 'desc'.

lengthintegerOptional

Number of rows to return, max 5000 for JSON.

offsetintegerOptional

Row offset for pagination.

outstringOptional

Output format, 'json' or 'xml'.