LoginSign Up
← Back to all sparks
E

eiaapi

ANALYTICS
Velocity0.0

R package eiaapi by ramikrispin — release notes from GitHub.

github.com/ramikrispin/eiaapi ↗

A thin EIA energy-data client whose whole story is making bulk queries survive the API's limits.

energy-dataapi-clienteiatime-seriesr-package
◆Current state
eiaapi wraps the US Energy Information Administration API: eia_get() issues a single query, and eia_backfill() decomposes a large date range into chunks the API will actually serve. Three releases across two years cover the package's entire history, and the second and third both exist because of eia_backfill().
◆Where it's heading
The package's development is a single problem being worked: pulling more data than one request allows. Version 0.1.2 introduced eia_backfill() for exactly that, and 0.2.0 fixed it for non-hourly frequencies by adding the frequency and data arguments so it matches eia_get()'s interface and by reworking Date handling. That convergence of the two functions' signatures is the visible design direction — one query idiom regardless of range size.
◆Prediction
With the two functions now taking aligned arguments, further work most plausibly extends coverage to more EIA endpoints or response shapes. The entries name no specific target.

◆Recent moves

  1. 1y ago

    eia_backfill() works for non-hourly frequencies

    Fixes eia_backfill() for non-hourly data by adding frequency and data arguments that mirror eia_get(), and reworks how Date objects are processed. Framed as a bug fix, but it is the release that made backfill usable beyond hourly series.

    View source ↗
  2. 3y ago

    eia_backfill() added for large data queries

    Adds eia_backfill() to break large queries into servable chunks, with a vignette showing its use. Also fixes eia_get() failing to send queries containing brackets, which the API's filter syntax requires.

    View source ↗
  3. 3y ago

    Initial release with eia_get() API query function

    The initial release, providing eia_get() to query the EIA API and a NEWS file. A single-function starting point that the next two releases built the bulk-query path on top of.

    View source ↗