{
  "meta": {
    "generated_at": "2026-06-16T21:33:14.152Z"
  },
  "profile": {
    "schema_version": "2026-06-01",
    "source_identity": {
      "slug": "us-energy-information-administration",
      "name": "US Energy Information Administration",
      "homepage": "https://www.eia.gov/opendata/",
      "root_domains": [
        "www.eia.gov",
        "api.eia.gov"
      ],
      "provider_type": "Governmental",
      "tags": [
        "economics",
        "energy"
      ],
      "geo_region": "north_america"
    },
    "access_profile": {
      "access_level": "limited",
      "access_type": "open",
      "cost": "free",
      "auth_required": true,
      "auth_type": "api_key_query_param",
      "data_access_report": {
        "active_tracking": true,
        "exportable_data": "free_key_api",
        "free_api": true,
        "collection_method": "rest-api-key",
        "estimated_size": "large",
        "docker_fit": "docker_ok",
        "download_location": "https://www.eia.gov/opendata/",
        "reason": "Official API key is free; active data probes need a configured key."
      },
      "terms_caveat": "Verify provider terms before production reuse."
    },
    "collection_profile": {
      "collection_level": "L1",
      "methods": [
        "api",
        "bulk-export",
        "csv",
        "direct-link",
        "liveness-only",
        "portal",
        "rest-api-key",
        "xlsx"
      ],
      "active_tracking": true,
      "exportable_data": "free_key_api",
      "docker_fit": "docker_ok",
      "estimated_size": "large",
      "download_location": "https://www.eia.gov/opendata/",
      "page_type": "portal+rest-api",
      "public_dataset_examples": [],
      "known_datasets": [
        "Annual Energy Outlook",
        "Petroleum Supply Monthly",
        "Natural Gas Monthly",
        "Electric Power Monthly"
      ],
      "recommended_next_action": "Use the official access path with a user-provided key or account; do not run unauthenticated data probes."
    },
    "tracking_profile": {
      "plan_status": "liveness-only",
      "liveness_url": "https://www.eia.gov/opendata/",
      "content_probes": [
        "https://www.eia.gov/opendata/"
      ],
      "freshness_probe": {
        "url": "https://api.eia.gov/v2/electricity/retail-sales/data?api_key={key}&frequency=annual&data[0]=sales&sort[0][column]=period&sort[0][direction]=desc&length=1",
        "confirmed": false,
        "parse": "json.response.data[0].period",
        "format": "YYYY",
        "stale_threshold_days": 60
      },
      "cadence": {
        "liveness": "5 minutes",
        "content": "6 hours",
        "freshness": "not enabled"
      }
    },
    "health_snapshot": {
      "current_liveness": "degraded",
      "combined": "green",
      "data_status": "ok",
      "last_checked_at": "2026-06-16T18:00:23.241Z",
      "recent_failure_reason": null,
      "recent_probe": {
        "method": "GET",
        "target_label": "content probe",
        "http_status": 200,
        "freshness_value": null
      },
      "recent_events": [
        {
          "source_slug": "us-energy-information-administration",
          "event_type": "source_restored",
          "details": "{\"http\":503}",
          "detected_at": "2026-06-11T21:40:29.565Z"
        },
        {
          "source_slug": "us-energy-information-administration",
          "event_type": "source_impacted",
          "details": "{\"reason\":\"timeout\",\"http\":0}",
          "detected_at": "2026-06-11T21:35:29.565Z"
        },
        {
          "source_slug": "us-energy-information-administration",
          "event_type": "source_restored",
          "details": "{\"http\":503}",
          "detected_at": "2026-06-01T21:10:39.369Z"
        },
        {
          "source_slug": "us-energy-information-administration",
          "event_type": "source_impacted",
          "details": "{\"reason\":\"timeout\",\"http\":0}",
          "detected_at": "2026-06-01T21:05:39.371Z"
        },
        {
          "source_slug": "us-energy-information-administration",
          "event_type": "source_restored",
          "details": "{\"http\":503}",
          "detected_at": "2026-05-30T18:00:54.025Z"
        }
      ]
    },
    "llm_guidance": {
      "best_use": "Good candidate for automated data access.",
      "warnings": [
        "API key required (free registration at eia.gov/opendata). v2 API launched 2022. Covers electricity, natural gas, petroleum, coal, renewables. Until we store a key, liveness-only.",
        "EIA API v2 requires free API key. Key is free to register. Without key: eia.gov/opendata/ for liveness only.",
        "Expected content: Energy Information Administration"
      ],
      "suggested_prompt": "Assess US Energy Information Administration for a low-cost economic data pipeline. Explain access, collection level, current health, and caveats."
    },
    "attestation": {
      "confidence": "medium",
      "verified_at": null,
      "data_quality": "rough",
      "evidence": {
        "source_page": "/source/us-energy-information-administration",
        "status_page": "/uptime",
        "plan_status": "liveness-only"
      },
      "known_gaps": [
        "Freshness is not confirmed."
      ]
    }
  }
}