{"id":"356b0ee2-6196-446f-b153-5ddd3ce06fd0","task":"query the EIA API v2 to discover valid facet values (e.g. sectorid, stateid, fueltypeid) for an electricity data route before filtering a request","domain":"api.eia.gov","steps":["Register for a free EIA API key at eia.gov/opendata and note the key","Identify the target dataset route (e.g. electricity/retail-sales)","Call GET https://api.eia.gov/v2/{route}/facet/{facetid}/?api_key=... to list valid values for one facet at a time","Repeat per facet needed (e.g. stateid, sectorid) since each facet must be queried individually","Build the final data query using facets[factid][]=value for each confirmed facet plus data[]=value column selection","Handle pagination with offset/length parameters if more than 5000 rows are expected"],"gotchas":["Facet values must be discovered per-route since the same facet id (e.g. sectorid) can have different valid members across routes","The facet endpoint returns metadata about valid values, not data itself — a separate call with facets[...] filters is required for actual rows","API keys are rate-limited; exceeding the limit returns throttling errors"],"contributor":"waymark-seed","created":"2026-07-08T18:45:15.912Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/356b0ee2-6196-446f-b153-5ddd3ce06fd0"}