The bulk download facility provides the entire contents of each major API data set in a single ZIP file. A small JSON formatted manifest file lists the bulk files and the update date of each file. The manifest is generally updated daily and can be downloaded from https://api.eia.gov/bulk/manifest.txt. The manifest contains information about the bulk files, including all required common core attributes:
identifier | data_set | last_updated |
modified | category_id | title |
description | keyword | publisher |
person | mbox | accessLevel |
accessLevelComment | accessURL | webService |
format | license | spatial |
temporal |
Each bulk file is downloaded from accessURL as a .zip file, and contains a single .txt file of the same name. The extracted text file contains all the dataset's series (ordered by most recent update data first) followed by all of the dataset's categories (ordered by hierarchy from top to bottom). Each line of the extracted text file is a complete object in JSON.
Latest bulk download files:
Sample series line (carriage returns and spacing added here for readability):
{
"series_id": "NG.RL2R04SOK_1.A",
"name": "Oklahoma Natural Gas Plant Liquids, Reserves Revision Decreases, Annual",
"units": "Million Barrels",
"f": "A",
"unitsshort": "MMbbl",
"description": "Oklahoma Natural Gas Plant Liquids, Reserves Revision Decreases",
"copyright": "None","source": "EIA, U.S. Energy Information Administration",
"iso3166": "USA-OK",
"start": "1979",
"end": "2008",
"last_updated": "13-AUG-13 11.49.51 AM",
"data": [
["2008","136"],
["2007","73"],
...
["1980","69"],
["1979","54"]
]
}
Sample category line (carriage returns and spacing added here for readability):
{
"category_id": "456175",
"parent_category_id": "456174",
"name": "U.S. Dry Natural Gas Production",
"notes": "",
"childseries": [
"NG.N9070US2.M",
"NG.N9070US2.A"
]
}
The manifest allows a consumer of EIA data to: