{"ok":true,"site":"eia","host":"eia.gov","about":"U.S. Energy Information Administration (EIA): energy statistics through the public Open Data API v2 (routes, data queries, facets, legacy series IDs), dnav data tables, Today in Energy articles, daily and weekly fuel prices, glossary and FAQs.","commands":[{"command":"list-api-datasets","summary":"List the top-level EIA Open Data API v2 dataset categories (coal, electricity, natural-gas, petroleum, ...).","params":[],"exampleUrl":"https://clify-dev.netlify.app/eia/list-api-datasets"},{"command":"get-api-route","summary":"Get metadata for a top-level API v2 category (e.g. natural-gas, electricity): its child routes.","params":[{"name":"route","type":"string","required":true,"description":"Single path segment category id from list-api-datasets, e.g. natural-gas, electricity, petroleum (multi-level paths containing '/' are not supported because the slash gets encoded)"}],"exampleUrl":"https://clify-dev.netlify.app/eia/get-api-route"},{"command":"list-api-facet-values","summary":"List the allowed values (id and name) of one facet of a two-level API v2 dataset, e.g. all stateid codes for electricity/retail-sales.","params":[{"name":"category","type":"string","required":true,"description":"Top-level category id, e.g. electricity"},{"name":"dataset","type":"string","required":true,"description":"Leaf dataset id under the category (single segment), e.g. retail-sales"},{"name":"facet","type":"string","required":true,"description":"Facet id from the route metadata, e.g. stateid, sectorid"}],"exampleUrl":"https://clify-dev.netlify.app/eia/list-api-facet-values"},{"command":"get-data-table","summary":"Read a dnav summary data table (e.g. U.S. or state natural gas prices): one row per series with the latest values and a link to its history.","params":[{"name":"program","type":"string","description":"dnav program directory","oneOf":["ng","pet"],"default":"ng"},{"name":"table","type":"string","required":true,"description":"Table id. The area and frequency are encoded in it, e.g. NG_PRI_SUM_DCU_NUS_M (U.S., monthly), ng_pri_sum_dcu_STX_m (Texas, monthly), ng_pri_sum_dcu_STX_a (Texas, annual)"}],"exampleUrl":"https://clify-dev.netlify.app/eia/get-data-table"},{"command":"get-series-history-table","summary":"Read the full-history table of a dnav series, one row per decade (e.g. Texas natural gas wellhead price, annual).","params":[{"name":"program","type":"string","description":"dnav program directory","oneOf":["ng","pet"],"default":"ng"},{"name":"series","type":"string","required":true,"description":"History page id from get-data-table historyUrl (without ./hist/ and .htm), e.g. na1140_stx_3a, n3010tx3m"}],"exampleUrl":"https://clify-dev.netlify.app/eia/get-series-history-table"},{"command":"list-recent-articles","summary":"List the latest Today in Energy articles with type, date, title, link and tags.","params":[],"exampleUrl":"https://clify-dev.netlify.app/eia/list-recent-articles"},{"command":"get-article","summary":"Get the full text of a Today in Energy article by id.","params":[{"name":"id","type":"string","required":true,"description":"Article id (detail.php?id=...)"}],"exampleUrl":"https://clify-dev.netlify.app/eia/get-article?id=68305"},{"command":"list-articles-by-tag","summary":"List all Today in Energy articles that carry a tag (e.g. electricity, natural gas, solar).","params":[{"name":"tag","type":"string","required":true,"description":"Tag name as listed by list-article-tags, e.g. electricity, natural gas, liquid fuels"}],"exampleUrl":"https://clify-dev.netlify.app/eia/list-articles-by-tag?tag=electricity"},{"command":"list-article-tags","summary":"List every Today in Energy article tag.","params":[],"exampleUrl":"https://clify-dev.netlify.app/eia/list-article-tags"},{"command":"list-article-archive","summary":"List Today in Energy articles for one year from the archive, grouped by month in the page.","params":[{"name":"year","type":"string","description":"Year to list, e.g. 2025. Omit for the current year."}],"exampleUrl":"https://clify-dev.netlify.app/eia/list-article-archive?year=2025"},{"command":"get-daily-prices","summary":"Get Today in Energy daily prices: wholesale spot petroleum, natural gas and electricity, retail fuel, prompt-month futures and financial indicators.","params":[],"exampleUrl":"https://clify-dev.netlify.app/eia/get-daily-prices"},{"command":"get-gasoline-diesel-prices","summary":"Get the weekly U.S., regional and state retail prices for regular gasoline and on-highway diesel (Gasoline and Diesel Fuel Update).","params":[],"exampleUrl":"https://clify-dev.netlify.app/eia/get-gasoline-diesel-prices"},{"command":"list-glossary-terms","summary":"List EIA glossary terms and definitions for a fuel topic or a starting letter.","params":[{"name":"topic","type":"string","required":true,"description":"Fuel topic or a single letter A-Z","oneOf":["alternative fuels","coal","electricity","natural gas","nuclear","petroleum","renewable"]}],"exampleUrl":"https://clify-dev.netlify.app/eia/list-glossary-terms?topic=coal"},{"command":"get-faq","summary":"Get an EIA FAQ answer and the related FAQs on the same topic.","params":[{"name":"id","type":"string","required":true,"description":"FAQ id"},{"name":"t","type":"string","description":"FAQ topic id (from related FAQ links), e.g. 9 = Diesel"}],"exampleUrl":"https://clify-dev.netlify.app/eia/get-faq?id=2&t=9"}]}