{
  "schema": "qz.energy.data-lab/v1",
  "product_id": "qz-energy",
  "release_id": "qz-energy-science-5ce3d74e-20260829T082900Z",
  "generated_at": "2026-08-29T08:28:46Z",
  "policy": {
    "read_only": true,
    "static_release": true,
    "max_query_limit": 1000,
    "notes": {
      "ru": "Запросы выполняются только на чтение. JSON-stat 2.0 доступен для energy-indicators; Parquet остаётся полным versioned snapshot, а не динамическим форматом query endpoint.",
      "kk": "Сұраулар тек оқуға арналған. JSON-stat 2.0 energy-indicators үшін қолжетімді; толық өзгермейтін Parquet snapshot бар, ал query endpoint динамикалық формат ретінде қолданылмайды.",
      "en": "Requests are read-only. JSON-stat 2.0 is available for energy-indicators; Parquet remains a full versioned snapshot, not a dynamic query format."
    }
  },
  "summary": {
    "datasets": 38,
    "formats": [
      "json",
      "csv",
      "json-stat",
      "parquet"
    ],
    "filter_fields": [
      "period",
      "region",
      "object_type",
      "source_id",
      "status",
      "domain",
      "unit"
    ]
  },
  "datasets": [
    {
      "dataset_id": "energy-indicators",
      "path": "energy-indicators.json",
      "format": "json",
      "records": 173,
      "domain": "generation",
      "period_coverage": "2022-2026",
      "hash": "sha256:7f067fd37f9a688bcb4afe54bcde16858831150215c87ba8b2ab828a3887da69",
      "source": "Министерство энергетики РК, БНС, Samruk-Energy, KEGOC, KOREM и QazaqGaz"
    },
    {
      "dataset_id": "electricity-generation-series",
      "path": "electricity-generation-series.json",
      "format": "json",
      "records": 6,
      "domain": "electricity",
      "period_coverage": "2020-2025",
      "hash": "sha256:63a0f6a164aa7f73b51692eac556aa50ceb9bbb48b34f8375314613ad0a112d7",
      "source": "KEGOC, годовой отчёт 2024 – баланс электроэнергии; официальный выпуск об итогах 2025 года"
    },
    {
      "dataset_id": "kegoc-balancing-series",
      "path": "kegoc-balancing-series.json",
      "format": "json",
      "records": 5,
      "domain": "electricity",
      "period_coverage": "2020-2024",
      "hash": "sha256:ac12a8d946b36b6279e58263d187ea6df1a4320f6d52beadd57cb383ad987970",
      "source": "KEGOC, годовой отчёт 2024 – Production activities, с. 28"
    },
    {
      "dataset_id": "kegoc-technical-dispatching-series",
      "path": "kegoc-technical-dispatching-series.json",
      "format": "json",
      "records": 5,
      "domain": "electricity",
      "period_coverage": "2020-2024",
      "hash": "sha256:881dc8720f47c018c0942eb049e7af678dbd9f1fcd2d4525185dd88f77012a82",
      "source": "KEGOC, годовой отчёт 2024 – Production activities, с. 27"
    },
    {
      "dataset_id": "public-energy-map",
      "path": "public-energy-map.geojson",
      "format": "geojson",
      "records": null,
      "domain": "infrastructure",
      "period_coverage": "текущий публичный выпуск",
      "hash": "sha256:f1244624e91a5636fba47b7c2a280eac882766b74490fa353b04972ecf0cdbb0",
      "source": "KEGOC, KazTransOil, Министерство энергетики РК, Samruk-Energy и QazaqGaz"
    },
    {
      "dataset_id": "energy-map-view",
      "path": "energy-map-view.json",
      "format": "json",
      "records": null,
      "domain": "cartography",
      "period_coverage": "текущий публичный выпуск",
      "hash": "sha256:5ef61abfdc3693ab04c5c811dd59bdd9d5a23a7e26c01372284671b6aa5678ee",
      "source": "проверенные публичные записи qz.energy"
    },
    {
      "dataset_id": "source-allowlist",
      "path": "source-allowlist.json",
      "format": "json",
      "records": null,
      "domain": "provenance",
      "period_coverage": "текущие правила источников",
      "hash": "sha256:6111021b072627c0f3228f864a917773cd750449cdcbfa0736e2ea052b88be1b",
      "source": "редакция qz.energy"
    },
    {
      "dataset_id": "freshness-register",
      "path": "freshness-register.json",
      "format": "json",
      "records": null,
      "domain": "provenance",
      "period_coverage": "текущий публичный выпуск",
      "hash": "sha256:5974f65d993634b2da383fc445736bb224c9e0eeb25fea99aae2c11d8714ae78",
      "source": "контроль выпуска qz.energy"
    },
    {
      "dataset_id": "map-layer-completeness",
      "path": "map-layer-completeness.json",
      "format": "json",
      "records": null,
      "domain": "cartography",
      "period_coverage": "текущий публичный выпуск",
      "hash": "sha256:30a50379111f121c1e1340bf9e19dfa9df8de5900debfb91e3484543b7ef4a46",
      "source": "проверенные публичные записи qz.energy"
    },
    {
      "dataset_id": "object-passports",
      "path": "object-passports.json",
      "format": "json",
      "records": null,
      "domain": "infrastructure",
      "period_coverage": "текущий публичный выпуск",
      "hash": "sha256:1d1c271e53ed02798d989ffe64ce5bd4852d059403d5c403a8df23b6732ab315",
      "source": "KEGOC, KazTransOil, Министерство энергетики РК, Samruk-Energy и QazaqGaz"
    },
    {
      "dataset_id": "public-snapshot",
      "path": "qz-energy-public-snapshot.json",
      "format": "json",
      "records": null,
      "domain": "release",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:b894b381a61c7b0bdf24044ac82aa4753e3cb30ebd06ec7a4dece27396614942",
      "source": "закрытые проверенные публичные записи"
    },
    {
      "dataset_id": "qaz-events-energy-calendar",
      "path": "qaz-events-energy-calendar.json",
      "format": "json",
      "records": 11,
      "domain": "calendar",
      "period_coverage": "2026",
      "hash": "sha256:85d8bcd96911c11c067973eac46af826f48b2855709c023f1bb07a2111099196",
      "source": "Qaz.Events и первоисточник каждой записи"
    },
    {
      "dataset_id": "global-benchmark",
      "path": "global-benchmark.json",
      "format": "json",
      "records": null,
      "domain": "план развития",
      "period_coverage": "2026-07-28",
      "hash": "sha256:e71750d6364b18557d2b41d43053072affda3cbf54c0a40a114757cc213168c5",
      "source": "Global Energy Monitor, IEA, Ember, Electricity Maps, ENTSO-E, EIA, Open Infrastructure Map, Grid Status"
    },
    {
      "dataset_id": "infrastructure-contract",
      "path": "infrastructure-contract.json",
      "format": "json",
      "records": null,
      "domain": "release",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:a904d7a0f45754f377f784773d073a7e7bfcfab6e7ec81d06f1fafce477b1ac1",
      "source": "контроль выпуска qz.energy"
    },
    {
      "dataset_id": "domain-taxonomy",
      "path": "domain-taxonomy.json",
      "format": "json",
      "records": null,
      "domain": "release",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:ae3546021b81b1d5aa9eb74f97ff2dcd681d4a8cbf9508b3c065b790ccf24d4a",
      "source": "контроль выпуска qz.energy"
    },
    {
      "dataset_id": "entities",
      "path": "entities.json",
      "format": "json",
      "records": null,
      "domain": "knowledge-graph",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:62f83d9f80cb006e91dbdc14574cd91353e3df8cdf62816d79ce241013eb96aa",
      "source": "публичная сводка qz.energy"
    },
    {
      "dataset_id": "entity-graph",
      "path": "entity-graph.json",
      "format": "json",
      "records": null,
      "domain": "knowledge-graph",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:074d9b4d4ace25c6ffbb15b97abdf892ba9113baa8b498aac3e292353647dd29",
      "source": "публичная сводка qz.energy"
    },
    {
      "dataset_id": "facts",
      "path": "facts.ndjson",
      "format": "ndjson",
      "records": 228,
      "domain": "knowledge-graph",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:f673328fb9ab308b5d1d6df5b2893b094afa2b8c6db26a551b337346b428063f",
      "source": "публичная сводка qz.energy"
    },
    {
      "dataset_id": "claims",
      "path": "claims.ndjson",
      "format": "ndjson",
      "records": 9,
      "domain": "knowledge-graph",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:46f6cd9c0b756aa713d64a297d07e7ce28361348009ca7e842a3093c62d385cf",
      "source": "публикации qz.energy и первичные документы"
    },
    {
      "dataset_id": "series-catalog",
      "path": "series-catalog.json",
      "format": "json",
      "records": null,
      "domain": "provenance",
      "period_coverage": "1991–2026",
      "hash": "sha256:f84a43fa25bbb03c169aa0010a03546fa29117dc16a41e77ca6d30691a27eb03",
      "source": "проверенные публичные показатели, годовые ряды KEGOC, а также табличные, динамические и инфраструктурные ряды БНС"
    },
    {
      "dataset_id": "energy-balance-series",
      "path": "energy-balance-series.json",
      "format": "json",
      "records": null,
      "domain": "demand",
      "period_coverage": "2021–2024",
      "hash": "sha256:395a5182168645bd1bfb5e69c237da7fe590ce02cc089607663d35e4785148f9",
      "source": "Бюро национальной статистики РК, XLSX топливно-энергетического баланса"
    },
    {
      "dataset_id": "bns-dynamic-series",
      "path": "bns-dynamic-series.json",
      "format": "json",
      "records": null,
      "domain": "demand",
      "period_coverage": "1991–2024",
      "hash": "sha256:b5bc9f9b82f52c74bbc2cbf7702f120e09ab186eb7c239f8fdb19d8bb67ac4a7",
      "source": "Бюро национальной статистики РК, динамические таблицы топливно-энергетического баланса"
    },
    {
      "dataset_id": "bns-sector-infrastructure-series",
      "path": "bns-sector-infrastructure-series.json",
      "format": "json",
      "records": null,
      "domain": "infrastructure",
      "period_coverage": "2014–2025",
      "hash": "sha256:48d6d0c6a4cf164942535b165266593bd5e51eed28fba7c6937bf48ed3b5ec91",
      "source": "Бюро национальной статистики РК, формы 1-ГАЗ и 6-ТП"
    },
    {
      "dataset_id": "observations",
      "path": "observations.ndjson",
      "format": "ndjson",
      "records": 481,
      "domain": "provenance",
      "period_coverage": "1991–2026",
      "hash": "sha256:283945537baaaed6b8783bc37b49109a96f3124b734b020f080cd1b74989dc88",
      "source": "проверенные публичные показатели, годовые ряды KEGOC, а также табличные, динамические и инфраструктурные ряды БНС"
    },
    {
      "dataset_id": "ui-contract",
      "path": "ui-contract.json",
      "format": "json",
      "records": null,
      "domain": "release",
      "period_coverage": "публичный выпуск v0.6.15-avds4-final4-20260806T072948Z",
      "hash": "sha256:7bf52d8398fd23fc96fd57417db29b680ca699e7adeb9d1f837ece02e6bd5cb8",
      "source": "контроль выпуска qz.energy"
    },
    {
      "dataset_id": "intelligence-requirements",
      "path": "intelligence-requirements.json",
      "format": "json",
      "records": null,
      "domain": "product-coverage",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:10fdc9b00334e76cb0dfcfd0a682dbc939384a1aa123a224d66f37035a3a9181",
      "source": "профессиональный gap-аудит qz.energy"
    },
    {
      "dataset_id": "source-expansion-register",
      "path": "source-expansion-register.json",
      "format": "json",
      "records": null,
      "domain": "provenance",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:f19599a6b62f464c6b9abfd9554d4bdae5742cab7d8c1e722bfa49812555e9d9",
      "source": "официальные публичные источники и профессиональный gap-аудит qz.energy"
    },
    {
      "dataset_id": "system-monitor",
      "path": "system-monitor.json",
      "format": "json",
      "records": 28,
      "domain": "electricity",
      "period_coverage": "2024–2025 годы, по периоду каждого показателя",
      "hash": "sha256:3a1ccf000f446f4ec3368a8465307ab017d7bae31c99e0ed77b9f901a325702a",
      "source": "KEGOC"
    },
    {
      "dataset_id": "regional-profiles",
      "path": "regional-profiles.json",
      "format": "json",
      "records": 20,
      "domain": "regional-energy",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:3f0af1b10dc20f69305a0d9e3d216a23e70a14b7ae755ed9b23c2b0675c2a6ef",
      "source": "БНС, KEGOC, KOREM, Samruk-Energy, QazaqGaz и первичные источники объектов"
    },
    {
      "dataset_id": "project-tracker",
      "path": "project-tracker.json",
      "format": "json",
      "records": 18,
      "domain": "infrastructure",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:895832ff641291d1c30e19631fa5ecd122f980bb096ea14552869bac72f1e56f",
      "source": "первичные источники паспортов объектов qz.energy"
    },
    {
      "dataset_id": "market-tariff-centre",
      "path": "market-tariff-centre.json",
      "format": "json",
      "records": 36,
      "domain": "prices",
      "period_coverage": "2024–2025",
      "hash": "sha256:3971cc4e2201e442494bf20c941186c09c38330b2124944671b19fad1302e1d5",
      "source": "KOREM"
    },
    {
      "dataset_id": "investment-terminal",
      "path": "investment-terminal.json",
      "format": "json",
      "records": 6,
      "domain": "investment",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:419213939dc6a4caf1d5b8f7b742d0b8d0d55f6df79487bac2b00335be576ccd",
      "source": "первичные источники паспортов проектов и KOREM"
    },
    {
      "dataset_id": "geopolitical-dependencies",
      "path": "geopolitical-dependencies.json",
      "format": "json",
      "records": 4,
      "domain": "geopolitics",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:5c53b534a8c4d1e2b38d5ce5e93ab704c6653cf29d3e5732a878c899795aa45f",
      "source": "первичные источники паспортов объектов qz.energy"
    },
    {
      "dataset_id": "climate-water-carbon",
      "path": "climate-water-carbon.json",
      "format": "json",
      "records": 10,
      "domain": "emissions",
      "period_coverage": "2024–2025",
      "hash": "sha256:0b5d0394ffaeb76bf9dde3e522cdc7520e2f73f2a08aeace77cb0c24e9343197",
      "source": "Министерство энергетики РК и Samruk-Energy"
    },
    {
      "dataset_id": "ownership-finance",
      "path": "ownership-finance.json",
      "format": "json",
      "records": 17,
      "domain": "investment",
      "period_coverage": "2024–2026",
      "hash": "sha256:75fe07509bf8fb376ced4a77a14ea1d1640e918103b09fd9ca023be1333c7bb4",
      "source": "Samruk-Energy и KazTransOil"
    },
    {
      "dataset_id": "scenario-lab",
      "path": "scenario-lab.json",
      "format": "json",
      "records": 9,
      "domain": "scenarios",
      "period_coverage": "2025–2050",
      "hash": "sha256:67ad07a3aedc21e68ae5b1ed60c57bf2af9220beead899e900bcb2bb8603d961",
      "source": "Министерство энергетики РК и KEGOC для базы 2025 года"
    },
    {
      "dataset_id": "watch-centre",
      "path": "watch-centre.json",
      "format": "json",
      "records": 11,
      "domain": "workflow",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:1f976617a1cbe1821a5d4a709e6677684075a7c8f1359bc1078c22883a482523",
      "source": "реестр проектов, рынков, источников и история выпусков qz.energy"
    },
    {
      "dataset_id": "editorial-intelligence",
      "path": "editorial-intelligence.json",
      "format": "json",
      "records": 9,
      "domain": "editorial",
      "period_coverage": "публичный выпуск qz-energy-science-5ce3d74e-20260829T082900Z",
      "hash": "sha256:86b19d656d676dbfe60aea9d974643a88e336839e95277e1e05d247bac703e73",
      "source": "редакционный журнал qz.energy и проверенный тематический срез Qaz.Events"
    }
  ],
  "examples": [
    {
      "id": "json-filtered-page",
      "title": "JSON: фильтр и первая страница",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0",
      "curl": "curl -fsS 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0'",
      "python": "import requests\nresponse = requests.get('https://qz.energy/api/v1/query', params={'dataset_id': 'energy-indicators', 'domain': 'electricity', 'period': '2025', 'limit': 20, 'offset': 0})\nresponse.raise_for_status()\ndata = response.json()",
      "javascript": "const response = await fetch('https://qz.energy/api/v1/query?dataset_id=energy-indicators&domain=electricity&period=2025&limit=20&offset=0');\nconst data = await response.json();"
    },
    {
      "id": "csv-export",
      "title": "CSV: выгрузка набора",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=csv&limit=1000",
      "curl": "curl -fL 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=csv&limit=1000' -o energy-indicators.csv"
    },
    {
      "id": "json-stat-indicators",
      "title": "JSON-stat 2.0: показатели",
      "request": "https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=json-stat&domain=electricity&limit=1000",
      "curl": "curl -fsS 'https://qz.energy/api/v1/query?dataset_id=energy-indicators&format=json-stat&domain=electricity&limit=1000' -o energy-indicators.json-stat.json"
    },
    {
      "id": "parquet-snapshot",
      "title": "Parquet: полный versioned snapshot",
      "request": "https://qz.energy/api/v1/datasets/energy-indicators/data.parquet",
      "curl": "curl -fL 'https://qz.energy/api/v1/datasets/energy-indicators/data.parquet' -o energy-indicators.parquet"
    }
  ],
  "bulk_download_url": "https://qz.energy/data/datapackage.json",
  "revision_history_url": "https://qz.energy/data/release-history.json",
  "release_permalink": "https://qz.energy/api/v1/releases.json?release_id=qz-energy-science-5ce3d74e-20260829T082900Z"
}