THE DECISION

Source route

# EIA Open Data API ## What It Contains EIA Open Data API is a publisher-operated source for energy production, consumption, prices and electricity data. It offers a documented programmatic route for bounded research queries and operational analysis. Use the official documentation, preserve identifiers and retrieval time, and follow applicable source terms, pagination, and rate limits. The data should be interpreted with its coverage notes and is not a substitute for professional legal, financial, regulatory, or trade advice. ## Search With Codex ```text Use EIA Open Data API only through https://www.eia.gov/opendata/documentation.php. Inspect the official documentation before writing a small Python query for a bounded research question. Respect pagination, rate limits, and error responses; return the documented fields in JSON with the source URL and retrieval timestamp. Do not scrape an unofficial site or invent an endpoint. ``` ## Python Starter Script ```python import json from urllib.request import Request, urlopen url = "https://api.eia.gov/v2/electricity/rto/region-data/data/?api_key=DEMO_KEY&frequency=hourly&data[0]=value&length=1" # Replace with an authorised, documented query. request = Request(url, headers={"User-Agent": "byebuy.ai research (contact: you@example.com)", "Accept": "application/json"}) with urlopen(request, timeout=20) as response: if response.status != 200: raise RuntimeError(f"Unexpected HTTP status: {response.status}") payload = json.load(response) print(json.dumps(payload, indent=2)[:2000]) ``` ## Example Searches - What is the most recent official record for a bounded query? - Which available fields support a reproducible dashboard? - What metadata and retrieval date should accompany an export? ## What You Could Build - A provenance-aware research dashboard using permitted results. - A scheduled alert that records source updates rather than redistributing raw data. - A data-enrichment workflow that preserves the publisher's terms. ## Access and Rights Connect: API + REST. Rights code: M. No API key is required for the documented public route. Follow the official terms and source-specific notices. ## Geography Details Primary coverage is US; use the publisher's metadata for detailed scope. ## Related Databases - Relationships will be added only after targets are independently verified within Query It. ## Sources - [https://www.eia.gov/opendata/documentation.php](https://www.eia.gov/opendata/documentation.php) - [https://www.eia.gov/opendata/documentation.php](https://www.eia.gov/opendata/documentation.php) ## FAQ - **Is this an official route?** Yes; use the linked publisher documentation. - **Can I redistribute results?** Check the linked rights evidence and source-specific terms. - **Does it need credentials?** See Access and Rights. - **Should I scrape the website?** No; use the documented route. - **How current is it?** Check source metadata and the verification date.

THE USEFUL CORE

What you can query

• EIA Open Data API What It Contains EIA Open Data API is a publisher-operated source for energy production, consumption, prices and electricity data.
• It offers a documented programmatic route for bounded research queries and operational analysis.
• Use the official documentation, preserve identifiers and retrieval time, and follow applicable source terms, pagination, and rate limits.
• The data should be interpreted with its coverage notes and is not a substitute for professional legal, financial, regulatory, or trade advice.
• Search With Codex text Use EIA Open Data API only through https://www.eia.gov/opendata/documentation.php.

WHAT TO VERIFY BEFORE USE

What to verify before use

Confirm the source licence, access rules, update cadence, documentation, and whether the data is complete enough for the decision you need to make.