EIA Open Data API · 能源数据与元数据检索

EIA APIv2 按层级路由发现能源数据集，通过 GET 的字段、频率、日期和 facets 参数检索。需要免费注册的个人 API key；仅文档整理，未注册 key 或请求数据。

Source statements below remain in their published language. Collection, contributor reports and a provider's identity are separate; this page does not certify quality, current availability or permission to execute.

Stable ID: cap-1ee248c60aa8075974759548
Card version: 2
Updated: 2026-10-24T17:42:12.8384312+00:00
Ownership state: unclaimed
Processing: unknown
Evidence level: unknown
Business execution: unknown

Keep this fixed version · Original public source · Complete machine record

Published description

入口采用 https://api.eia.gov/v2/。请求父级路由可发现子数据集与元数据，具体数据路由以 /data 查询，可指定 data 列、frequency、时间范围、facets、排序及 offset/length。JSON 单次响应最多 5000 行，超出时文档说明会附 warning，不能把一页视作全量。文档称 APIv2 数据值统一为字符串以保留前导零，解析时应结合字段与单位元数据。APIv2 路径和页面发布修订不是本站已安装或实测版本。

Inputs

个人 API key，放在 URL 的 api_key 参数
数据集路由和所需 data 字段
适用 frequency、日期和 facets 条件
需要时的排序、offset 和 length

Outputs

JSON 数据、元数据、可用频率及 facets 信息
符合请求的时间序列或表格数据与单位说明
warning、error 和文档所述的请求/API 版本元数据

Invocation and authentication

Provider's original entry

{
  "authentication": {
    "kind": "api_key",
    "notes": "\u5B98\u65B9\u660E\u786E\u8981\u6C42\u4E2A\u4EBA API key\uFF0C\u53EF\u514D\u8D39\u6CE8\u518C\u5E76\u7531\u90AE\u4EF6\u53D1\u9001\uFF1Bapi_key \u5FC5\u987B\u7F6E\u4E8E URL\uFF0C\u4E0D\u80FD\u4EC5\u653E\u5728 HTTP header\u3002"
  },
  "command": null,
  "entry_url": "https://api.eia.gov/v2/",
  "kind": "http_api",
  "method": "GET",
  "requirements": [
    "\u6309\u5B98\u65B9\u6B65\u9AA4\u6CE8\u518C\u6709\u6548\u4E2A\u4EBA API key",
    "\u5148\u53D1\u73B0\u5177\u4F53\u8DEF\u7531\u3001\u5B57\u6BB5\u3001\u5355\u4F4D\u3001\u9891\u7387\u548C facets",
    "\u6309 JSON \u9875\u6570\u3001\u6392\u5E8F\u548C\u65F6\u95F4\u6761\u4EF6\u5904\u7406\u5B8C\u6574\u7ED3\u679C"
  ]
}

Commands and request examples are documentation only; this page does not execute them. Confirm external installation, disclosure and fees separately.

Third-party pricing and data handling

{
  "model": "unknown",
  "notes": "\u6587\u6863\u660E\u786E key \u514D\u8D39\u6CE8\u518C\uFF0C\u4F46\u672C\u6B21\u672A\u6838\u5B8C\u6574\u670D\u52A1\u8D39\u7528\u3001\u8D26\u6237\u989D\u5EA6\u548C\u6570\u5B57\u901F\u7387\u653F\u7B56\uFF1B\u4E0D\u5C06\u514D\u8D39 key \u7B49\u540C\u65E0\u9650\u8C03\u7528\u3002",
  "source_url": null
}

{
  "location": "provider_server",
  "notes": "\u67E5\u8BE2\u53C2\u6570\u4E0E API key \u53D1\u9001\u81F3 EIA\uFF1B\u771F\u5B9E key \u51FA\u73B0\u5728 URL\uFF0C\u9700\u907F\u514D\u5BF9\u5916\u516C\u5F00\u3002\u5B8C\u6574\u65E5\u5FD7\u4FDD\u7559\u4E0E\u518D\u4F7F\u7528\u6761\u6B3E\u672A\u7531\u672C\u6280\u672F\u6587\u6863\u5168\u90E8\u786E\u8BA4\u3002"
}

Unknown is not a claim that a service is free, anonymous, private or unavailable.

Limitations

未注册或读取 API key、调用数据集、运行下载或验证数值。
JSON 单页最多 5000 行，需缩小条件或分页，不能将截断响应当完整数据。
各数据集的字段、时间粒度、地理范围和 facets 不同，必须按元数据选择。
API key 要在 URL 中；不能公开包含真实 key 的链接或日志。
旧 v1 文档中的历史支持期限不代表当前所有旧接口仍可用。

Unknowns

当前账户频率限额、完整费用及使用许可待核对。
具体能源数据准确性、完整性、更新和当前服务可用性未实测。
数据值字符串的下游类型转换、单位和缺失值处理需按数据集核对。

Fixed profiles, conditions and evidence

Read state: not_checked; review state: unknown. Do not combine different profiles.

资料与来源声明不等于本站实测；未列出的条件仍未知。

结构化配方只按公开声明检查约束与接口，不执行任务或授予权限；缺失记录保持未知，接口兼容不证明实际成功。

Contributor-reported verification

{
  "checked_at": "2026-10-24T17:41:17.3517018\u002B00:00",
  "checks_performed": [
    "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
  ],
  "evidence_urls": [
    "https://www.eia.gov/opendata/documentation.php"
  ],
  "level": "documentation_only",
  "not_verified": [
    "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
  ],
  "outcome": "not_tested",
  "reported_by": "contributor",
  "software_version": null,
  "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
}

Connection, installation, execution, output checks and user acceptance are different stages. This is not a commercial call or income receipt.

Dynamic observations and corrections

null

null

Add a public correction or observation

Submit only facts you may disclose, without private tasks, customer data or credentials. Corrections are proposals; observations are conditional contributor reports, not automatically verified facts, commercial calls or income.

Propose a sourced summary correction

Report a conditional public observation

Complete fixed public record and original source fields

This is the existing public read projection, not a translated or rewritten snapshot. Dynamic observations, where present, remain labelled separately from evidence.

{
  "author_name": null,
  "availability": "unknown",
  "callability": "documentation_only",
  "category": "development",
  "data_handling": {
    "location": "provider_server",
    "notes": "\u67E5\u8BE2\u53C2\u6570\u4E0E API key \u53D1\u9001\u81F3 EIA\uFF1B\u771F\u5B9E key \u51FA\u73B0\u5728 URL\uFF0C\u9700\u907F\u514D\u5BF9\u5916\u516C\u5F00\u3002\u5B8C\u6574\u65E5\u5FD7\u4FDD\u7559\u4E0E\u518D\u4F7F\u7528\u6761\u6B3E\u672A\u7531\u672C\u6280\u672F\u6587\u6863\u5168\u90E8\u786E\u8BA4\u3002"
  },
  "description": "\u5165\u53E3\u91C7\u7528 https://api.eia.gov/v2/\u3002\u8BF7\u6C42\u7236\u7EA7\u8DEF\u7531\u53EF\u53D1\u73B0\u5B50\u6570\u636E\u96C6\u4E0E\u5143\u6570\u636E\uFF0C\u5177\u4F53\u6570\u636E\u8DEF\u7531\u4EE5 /data \u67E5\u8BE2\uFF0C\u53EF\u6307\u5B9A data \u5217\u3001frequency\u3001\u65F6\u95F4\u8303\u56F4\u3001facets\u3001\u6392\u5E8F\u53CA offset/length\u3002JSON \u5355\u6B21\u54CD\u5E94\u6700\u591A 5000 \u884C\uFF0C\u8D85\u51FA\u65F6\u6587\u6863\u8BF4\u660E\u4F1A\u9644 warning\uFF0C\u4E0D\u80FD\u628A\u4E00\u9875\u89C6\u4F5C\u5168\u91CF\u3002\u6587\u6863\u79F0 APIv2 \u6570\u636E\u503C\u7EDF\u4E00\u4E3A\u5B57\u7B26\u4E32\u4EE5\u4FDD\u7559\u524D\u5BFC\u96F6\uFF0C\u89E3\u6790\u65F6\u5E94\u7ED3\u5408\u5B57\u6BB5\u4E0E\u5355\u4F4D\u5143\u6570\u636E\u3002APIv2 \u8DEF\u5F84\u548C\u9875\u9762\u53D1\u5E03\u4FEE\u8BA2\u4E0D\u662F\u672C\u7AD9\u5DF2\u5B89\u88C5\u6216\u5B9E\u6D4B\u7248\u672C\u3002",
  "inputs": [
    "\u4E2A\u4EBA API key\uFF0C\u653E\u5728 URL \u7684 api_key \u53C2\u6570",
    "\u6570\u636E\u96C6\u8DEF\u7531\u548C\u6240\u9700 data \u5B57\u6BB5",
    "\u9002\u7528 frequency\u3001\u65E5\u671F\u548C facets \u6761\u4EF6",
    "\u9700\u8981\u65F6\u7684\u6392\u5E8F\u3001offset \u548C length"
  ],
  "invocation": {
    "authentication": {
      "kind": "api_key",
      "notes": "\u5B98\u65B9\u660E\u786E\u8981\u6C42\u4E2A\u4EBA API key\uFF0C\u53EF\u514D\u8D39\u6CE8\u518C\u5E76\u7531\u90AE\u4EF6\u53D1\u9001\uFF1Bapi_key \u5FC5\u987B\u7F6E\u4E8E URL\uFF0C\u4E0D\u80FD\u4EC5\u653E\u5728 HTTP header\u3002"
    },
    "command": null,
    "entry_url": "https://api.eia.gov/v2/",
    "kind": "http_api",
    "method": "GET",
    "requirements": [
      "\u6309\u5B98\u65B9\u6B65\u9AA4\u6CE8\u518C\u6709\u6548\u4E2A\u4EBA API key",
      "\u5148\u53D1\u73B0\u5177\u4F53\u8DEF\u7531\u3001\u5B57\u6BB5\u3001\u5355\u4F4D\u3001\u9891\u7387\u548C facets",
      "\u6309 JSON \u9875\u6570\u3001\u6392\u5E8F\u548C\u65F6\u95F4\u6761\u4EF6\u5904\u7406\u5B8C\u6574\u7ED3\u679C"
    ]
  },
  "limitations": [
    "\u672A\u6CE8\u518C\u6216\u8BFB\u53D6 API key\u3001\u8C03\u7528\u6570\u636E\u96C6\u3001\u8FD0\u884C\u4E0B\u8F7D\u6216\u9A8C\u8BC1\u6570\u503C\u3002",
    "JSON \u5355\u9875\u6700\u591A 5000 \u884C\uFF0C\u9700\u7F29\u5C0F\u6761\u4EF6\u6216\u5206\u9875\uFF0C\u4E0D\u80FD\u5C06\u622A\u65AD\u54CD\u5E94\u5F53\u5B8C\u6574\u6570\u636E\u3002",
    "\u5404\u6570\u636E\u96C6\u7684\u5B57\u6BB5\u3001\u65F6\u95F4\u7C92\u5EA6\u3001\u5730\u7406\u8303\u56F4\u548C facets \u4E0D\u540C\uFF0C\u5FC5\u987B\u6309\u5143\u6570\u636E\u9009\u62E9\u3002",
    "API key \u8981\u5728 URL \u4E2D\uFF1B\u4E0D\u80FD\u516C\u5F00\u5305\u542B\u771F\u5B9E key \u7684\u94FE\u63A5\u6216\u65E5\u5FD7\u3002",
    "\u65E7 v1 \u6587\u6863\u4E2D\u7684\u5386\u53F2\u652F\u6301\u671F\u9650\u4E0D\u4EE3\u8868\u5F53\u524D\u6240\u6709\u65E7\u63A5\u53E3\u4ECD\u53EF\u7528\u3002"
  ],
  "outputs": [
    "JSON \u6570\u636E\u3001\u5143\u6570\u636E\u3001\u53EF\u7528\u9891\u7387\u53CA facets \u4FE1\u606F",
    "\u7B26\u5408\u8BF7\u6C42\u7684\u65F6\u95F4\u5E8F\u5217\u6216\u8868\u683C\u6570\u636E\u4E0E\u5355\u4F4D\u8BF4\u660E",
    "warning\u3001error \u548C\u6587\u6863\u6240\u8FF0\u7684\u8BF7\u6C42/API \u7248\u672C\u5143\u6570\u636E"
  ],
  "pricing": {
    "model": "unknown",
    "notes": "\u6587\u6863\u660E\u786E key \u514D\u8D39\u6CE8\u518C\uFF0C\u4F46\u672C\u6B21\u672A\u6838\u5B8C\u6574\u670D\u52A1\u8D39\u7528\u3001\u8D26\u6237\u989D\u5EA6\u548C\u6570\u5B57\u901F\u7387\u653F\u7B56\uFF1B\u4E0D\u5C06\u514D\u8D39 key \u7B49\u540C\u65E0\u9650\u8C03\u7528\u3002",
    "source_url": null
  },
  "provider_claimed": false,
  "record_kind": "public_source",
  "representative_queries": [],
  "sources": [
    {
      "basis": "public_record",
      "checked_at": "2026-10-24T17:41:17.3517018\u002B00:00",
      "title": "EIA\u0027s API Technical Documentation -\n\t\tU.S. Energy Information Administration (EIA)",
      "url": "https://www.eia.gov/opendata/documentation.php"
    }
  ],
  "summary": "EIA APIv2 \u6309\u5C42\u7EA7\u8DEF\u7531\u53D1\u73B0\u80FD\u6E90\u6570\u636E\u96C6\uFF0C\u901A\u8FC7 GET \u7684\u5B57\u6BB5\u3001\u9891\u7387\u3001\u65E5\u671F\u548C facets \u53C2\u6570\u68C0\u7D22\u3002\u9700\u8981\u514D\u8D39\u6CE8\u518C\u7684\u4E2A\u4EBA API key\uFF1B\u4EC5\u6587\u6863\u6574\u7406\uFF0C\u672A\u6CE8\u518C key \u6216\u8BF7\u6C42\u6570\u636E\u3002",
  "tags": [
    "EIA",
    "\u80FD\u6E90\u6570\u636E",
    "APIv2",
    "HTTP API",
    "\u5143\u6570\u636E"
  ],
  "terms_url": null,
  "title": "EIA Open Data API \u00B7 \u80FD\u6E90\u6570\u636E\u4E0E\u5143\u6570\u636E\u68C0\u7D22",
  "unknowns": [
    "\u5F53\u524D\u8D26\u6237\u9891\u7387\u9650\u989D\u3001\u5B8C\u6574\u8D39\u7528\u53CA\u4F7F\u7528\u8BB8\u53EF\u5F85\u6838\u5BF9\u3002",
    "\u5177\u4F53\u80FD\u6E90\u6570\u636E\u51C6\u786E\u6027\u3001\u5B8C\u6574\u6027\u3001\u66F4\u65B0\u548C\u5F53\u524D\u670D\u52A1\u53EF\u7528\u6027\u672A\u5B9E\u6D4B\u3002",
    "\u6570\u636E\u503C\u5B57\u7B26\u4E32\u7684\u4E0B\u6E38\u7C7B\u578B\u8F6C\u6362\u3001\u5355\u4F4D\u548C\u7F3A\u5931\u503C\u5904\u7406\u9700\u6309\u6570\u636E\u96C6\u6838\u5BF9\u3002"
  ],
  "verification": {
    "checked_at": "2026-10-24T17:41:17.3517018\u002B00:00",
    "checks_performed": [
      "\u6765\u6E90HTTPS\u54CD\u5E94\u53EF\u8BFB\u53D6"
    ],
    "evidence_urls": [
      "https://www.eia.gov/opendata/documentation.php"
    ],
    "level": "documentation_only",
    "not_verified": [
      "\u529F\u80FD\u3001\u9274\u6743\u3001\u5B89\u88C5\u3001\u8F93\u51FA\u8D28\u91CF\u3001\u957F\u671F\u53EF\u7528\u6027\u5747\u672A\u7531\u672C\u7AD9\u6D4B\u8BD5\u3002"
    ],
    "outcome": "not_tested",
    "reported_by": "contributor",
    "software_version": null,
    "test_summary": "\u4EC5\u8BFB\u53D6\u516C\u5F00\u6765\u6E90\uFF1B\u672A\u8C03\u7528\u6240\u8FF0\u5DE5\u5177\u3002"
  },
  "schema_version": "navonavo.capability.v1",
  "service_id": "cap-1ee248c60aa8075974759548",
  "version": 2,
  "source_url": "https://www.eia.gov/opendata/documentation.php",
  "ownership_state": "unclaimed",
  "submitted_by": {
    "kind": "importer",
    "name": "NAVONAVO public material importer"
  },
  "submitter_identity_verified": false,
  "source_check": {
    "url": "https://www.eia.gov/opendata/documentation.php",
    "final_url": "https://www.eia.gov/opendata/documentation.php",
    "status_code": 200,
    "title": "EIA\u0027s API Technical Documentation -\n\t\tU.S. Energy Information Administration (EIA)",
    "description": "Energy Information Administration - EIA - Official Energy Statistics from the U.S. Government",
    "checked_at": "2026-10-24T17:41:17.3517018\u002B00:00",
    "warnings": [
      "\u6765\u6E90\u53EF\u8BFB\u53D6\u53EA\u8BC1\u660E\u672C\u6B21\u8D44\u6599\u8BFB\u53D6\uFF0C\u4E0D\u662F\u529F\u80FD\u3001\u8EAB\u4EFD\u6216\u957F\u671F\u53EF\u7528\u6027\u8BA4\u8BC1\u3002"
    ]
  },
  "created_at": "2026-10-24T17:41:20.4833064\u002B00:00",
  "updated_at": "2026-10-24T17:42:12.8384312\u002B00:00",
  "read_url": "https://navonavo.com/api/v1/capabilities/cap-1ee248c60aa8075974759548?version=2",
  "page_url": "https://navonavo.com/capabilities/cap-1ee248c60aa8075974759548?version=2",
  "verification_scope": "verification\u4E3A\u6295\u7A3F\u8005\u4E0A\u62A5\uFF1Bsource_check\u4EC5\u4E3A\u672C\u7AD9\u6765\u6E90\u8BFB\u53D6\uFF0C\u4E0D\u5347\u7EA7\u4E3A\u529F\u80FD\u9A8C\u8BC1\u6216\u5B98\u65B9\u8BA4\u8BC1\u3002",
  "library_material": {
    "organization": "organized",
    "semantic_state": "classified",
    "semantic_category": "\u80FD\u6E90\u4E0E\u516C\u5171\u7EDF\u8BA1\uFF0FEIA \u6570\u636E\u96C6\u548C\u65F6\u95F4\u5E8F\u5217 API",
    "evidence_grade": "documentation_only",
    "attachments": [
      {
        "material_id": "material-f39534bdf916cd110105b6433ec78e7e",
        "source_url": "https://www.eia.gov/opendata/documentation.php",
        "content_sha256": "5d98033eb068f241f53736a5319dac835baace5acd8bf6ea7ff6849a392169ea",
        "decoded_bytes": 127340,
        "content_type": "text/html",
        "captured_at": "2026-10-24T17:41:17.3517018\u002B00:00",
        "text_representation": "decoded_text_utf8",
        "text_utf8_sha256": "5d98033eb068f241f53736a5319dac835baace5acd8bf6ea7ff6849a392169ea",
        "text_utf8_bytes": 127340,
        "capture_body_reconstructed": true,
        "read_path": "/api/v1/capabilities/cap-1ee248c60aa8075974759548/materials/material-f39534bdf916cd110105b6433ec78e7e?version=1"
      }
    ]
  },
  "last_correction": {
    "contribution_id": "contribution-c844b901768643fcbedc919ead2ff816",
    "reason": "\u4EC5\u4F9D\u636E\u672C\u6B21\u5DF2\u4FDD\u5B58\u5B98\u65B9\u516C\u5F00\u6B63\u6587\u6574\u7406\u7528\u9014\u3001\u5165\u53E3\u3001\u6761\u4EF6\u548C\u672A\u77E5\u9879\uFF1B\u4FDD\u7559\u539F\u6587\u8BC1\u636E\uFF0C\u4E0D\u5C06\u8BF4\u660E\u6587\u6863\u5192\u5145\u5B9E\u9645\u63A5\u901A\u3001\u529F\u80FD\u5B9E\u6D4B\u6216\u53EF\u7528\u6027\u4FDD\u8BC1\u3002",
    "source_urls": [
      "https://www.eia.gov/opendata/documentation.php"
    ],
    "reported_by": "contributor"
  },
  "version_read_basis": "archived_revision",
  "deep_read": {
    "schema_version": "navonavo.capability-read.v1",
    "card_id": "cap-1ee248c60aa8075974759548",
    "card_version": 2,
    "selected_profile_id": null,
    "state": "not_checked",
    "review_state": null,
    "read_url": "https://navonavo.com/api/v1/capabilities/cap-1ee248c60aa8075974759548?version=2",
    "page_url": "https://navonavo.com/capabilities/cap-1ee248c60aa8075974759548?version=2",
    "profiles": [],
    "warnings": [
      "\u8D44\u6599\u4E0E\u6765\u6E90\u58F0\u660E\u4E0D\u7B49\u4E8E\u672C\u7AD9\u5B9E\u6D4B\uFF1B\u672A\u5217\u51FA\u7684\u6761\u4EF6\u4ECD\u672A\u77E5\u3002",
      "\u7ED3\u6784\u5316\u914D\u65B9\u53EA\u6309\u516C\u5F00\u58F0\u660E\u68C0\u67E5\u7EA6\u675F\u4E0E\u63A5\u53E3\uFF0C\u4E0D\u6267\u884C\u4EFB\u52A1\u6216\u6388\u4E88\u6743\u9650\uFF1B\u7F3A\u5931\u8BB0\u5F55\u4FDD\u6301\u672A\u77E5\uFF0C\u63A5\u53E3\u517C\u5BB9\u4E0D\u8BC1\u660E\u5B9E\u9645\u6210\u529F\u3002"
    ]
  }
}

Submit another public source · Privacy and disclosure