Factor API：為您的軟體提供英國及各國官方排放係數

運作方式

1. 登入後在應用程式中開啟 Factor API。建立金鑰並複製（金鑰只會顯示一次）。
2. 每次請求時以 Authorization: Bearer crf_… 的形式傳送。
3. 讀取 data，並在數字出現的任何地方顯示 attribution 文字。

curl -H "Authorization: Bearer $FACTOR_API_KEY" \
  "https://carbonrecycling.co.uk/api/v1/uk/factors?year=2026&q=diesel&category=fuels&scope=1"

金鑰應保存在您的伺服器上，而非網頁中。此 API 為唯讀（GET），以 JSON 回應，允許跨來源請求，並有版本控管：任何會破壞您程式的變更都會放在新版本中，而不會改動 v1。

端點參考

基礎網址為 https://carbonrecycling.co.uk/api/v1。GET /api/v1 無需金鑰即可列出各端點與資料來源。英國係數的 year 指 DESNZ 係數集（2002 至 2026，預設為最新）。各國及美國區域電力係數的 year 為您的報告年度，回傳的是截至該年度的最新資料年度。

依編號查詢英國係數

GET https://carbonrecycling.co.uk/api/v1/uk/factors/7_400_4000_5_1?year=2026

{
  "data": {
    "id": "7_400_4000_5_1",
    "year": 2026,
    "scope": "Scope 2",
    "category": "UK electricity",
    "path": ["UK electricity", "Electricity generated", "Electricity: UK", "kWh", null],
    "description": "UK electricity › Electricity generated › Electricity: UK › kWh",
    "unit": "kWh",
    "kgCo2ePerUnit": 0.13096
  },
  "attribution": [
    {
      "source": "desnz-factors",
      "name": "UK Government GHG Conversion Factors for Company Reporting",
      "publisher": "Department for Energy Security and Net Zero (DESNZ)",
      "licence": "Open Government Licence v3.0",
      "licenceUrl": "https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
      "attribution": "Contains public sector information licensed under the Open Government Licence v3.0. Source: DESNZ, Greenhouse gas reporting: conversion factors."
    }
  ],
  "notice": "Figures as published by each source, supplied without warranty. Carbon Recycling is not endorsed by any of the publishers named in attribution.",
  "meta": { "year": 2026 }
}

英國電力，含殘餘電力組合

GET https://carbonrecycling.co.uk/api/v1/uk/electricity?year=2026

{
  "data": {
    "year": 2026,
    "locationBased": { "id": "7_400_4000_5_1", "kgCo2ePerKwh": 0.13096, "scope": "Scope 2", "description": "UK electricity › ..." },
    "transmissionAndDistribution": { "id": "13_402_4000_5_1", "kgCo2ePerKwh": 0.01299, "scope": "Scope 3", "description": "..." },
    "wellToTank": {
      "generation": { "id": "15_917_4000_5_1", "kgCo2ePerKwh": 0.03682, "scope": "Scope 3", "description": "..." },
      "transmissionAndDistribution": { "id": "15_918_4000_5_1", "kgCo2ePerKwh": 0.00359, "scope": "Scope 3", "description": "..." }
    },
    "residualMix": { "kgCo2PerKwh": 0.396, "dataYear": 2025, "period": "1 April 2025 to 31 March 2026", "basis": "UK residual fuel mix, CO2 only, ..." }
  },
  "attribution": [ { "source": "desnz-factors", ... }, { "source": "desnz-fuel-mix", ... } ],
  "notice": "..."
}

單一國家

recommended 採用與我們自家報告相同的規則：採用該國官方數據，除非 Ember 的數據新一年以上。

GET https://carbonrecycling.co.uk/api/v1/electricity/countries/FRA?year=2025

{
  "data": {
    "iso3": "FRA",
    "name": "France",
    "reportingYear": 2025,
    "recommended": {
      "year": 2024,
      "kgCo2ePerKwh": 0.035,
      "source": "fr-ademe-base-carbone",
      "dataset": "Base Carbone V23.6, electricity average mix (combustion at the power station)",
      "basis": "..."
    },
    "ember": { "dataset": "Ember, Yearly Electricity Data", "generationTwh": 570.1, "mixPercent": { "Nuclear": 68.8, ... },
               "years": [ ..., { "year": 2025, "kgCo2ePerKwh": 0.04145 } ] },
    "official": { "publisher": "ADEME", "years": [ ..., { "year": 2024, "kgCo2ePerKwh": 0.035 } ], ... }
  },
  "attribution": [ { "source": "ember", ... }, { "source": "fr-ademe-base-carbone", ... } ],
  "notice": "..."
}

錯誤與限制

錯誤會以 {"error": {"status", "code", "message"}} 格式回傳。400 代表參數錯誤，401 代表金鑰遺失或已撤銷，403 代表帳戶未開通 Factor API（附訂閱連結），404 代表未知的係數、國家或端點，429 則代表當月呼叫次數已用完。

HTTP/1.1 429 Too Many Requests
X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1793491200
Retry-After: 1080000

{
  "error": {
    "status": 429,
    "code": "monthly_limit_reached",
    "message": "This account has used its 10,000 calls for this month. The count starts again on 2026-11-01, or move to a bigger tier.",
    "limit": 10000,
    "resetsAt": "2026-11-01T00:00:00.000Z",
    "upgrade": "https://carbonrecycling.co.uk/products/factor-api"
  }
}

授權與出處標示

我們只提供授權允許在付費產品中轉載的資料，並保留每家發布機構條款的註明日期副本。每個回應都會列出其背後的來源、授權及應標示的出處。數字依原始發布內容提供，不附任何保證，且任何發布機構均未為 Carbon Recycling 或您的產品背書。

• Department for Energy Security and Net Zero (DESNZ)：英國政府企業報告用溫室氣體換算係數。 Open Government Licence v3.0. 出處：包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的公部門資訊。來源：DESNZ，Greenhouse gas reporting: conversion factors。
• Defra and the University of Leeds：支出法排放乘數（英國碳足跡）。 Open Government Licence v3.0. 出處：包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的公部門資訊。來源：Defra，UK's carbon footprint。
• HM Revenue & Customs (HMRC) and HM Treasury：英國 CBAM 預設值與 CBAM 費率。 Open Government Licence v3.0. 出處：包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的公部門資訊。來源：HMRC，Check the default values for the Carbon Border Adjustment Mechanism (CBAM)；HM Treasury 與 HMRC，Illustrative CBAM rates and worked example。
• Ember Energy Research CIC：Ember 年度電力資料（各國電網排放強度）。 創用 CC 姓名標示 4.0 國際版. 出處：包含來自 Ember 的資料，依 CC BY 4.0 授權（ember-energy.org）。
• US Environmental Protection Agency：EPA eGRID 與溫室氣體排放係數中心（至 2025 年版）。 US government work, public domain under 17 U.S.C. § 105. 出處：來源：US EPA，eGRID 與 GHG Emission Factors Hub。法律並未要求，但我們仍予以標示。
• 加拿大環境與氣候變遷：加拿大 國家清冊報告附錄 7 電力排放強度表。 Open Government Licence - Canada 2.0. 出處：包含依開放政府授權條款 – 加拿大 授權的資訊（Environment and Climate Change 加拿大，National Inventory Report）。
• Energy Market Authority, Singapore：新加坡 能源市場管理局電網排放係數（data.gov.sg）。 Singapore Open Data Licence version 1.0. 出處：包含 Electricity Grid Emission Factors 與 Upstream Fugitive Methane Emission Factor 的資訊，於 2026 年 10 月 19 日取自 data.gov.sg，依 新加坡 開放資料授權條款第 1.0 版提供（https://data.gov.sg/open-data-licence）。
• ADEME (Agence de la transition écologique), France：ADEME Base Carbone（data.ademe.fr 開放版本），電力。 Licence Ouverte / Open Licence 2.0 (Etalab). 出處：來源：ADEME，Base Carbone® V23.6（data.ademe.fr，最後更新於 2025 年 7 月 3 日），Licence Ouverte 2.0。
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia：澳洲國家溫室氣體核算係數（2022 至 2026 年版）。 創用 CC 姓名標示 4.0 國際版. 出處：DCCEEW 2026，Australian National Greenhouse Accounts Factors，Department of Climate Change, Energy, the Environment and Water，坎培拉，8 月。CC BY 4.0。（較早版本以相同方式標示，並註明各自年份。）
• Cornerstone Sustainability Data Initiative：排放係數中心 2026（eGRID2024 電力，AR6 GWP）。 創用 CC 姓名標示 4.0 國際版. 出處：Emission Factors Hub 2026，Cornerstone Sustainability Data Initiative，CC BY 4.0（doi:10.5281/zenodo.20403776）。
• Department for Energy Security and Net Zero (DESNZ)：燃料組合揭露資料表（英國殘餘燃料組合）。 Open Government Licence v3.0. 出處：包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的公部門資訊。來源：DESNZ，Fuel mix disclosure data table。
• Umweltbundesamt (UBA), Germany：德國聯邦環境署（Umweltbundesamt）：1990 至 2025 年德國電力組合的特定溫室氣體排放（Climate Change 16/2026）。 Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. 出處：Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2)。數值由 Carbon Recycling 從每 kWh 克換算為每 kWh 公斤。
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China：生態環境部與國家統計局：2021 至 2023 年全國電力 CO2 排放係數。 Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. 出處：來源：中國生態環境部與國家統計局，2024 年第 12 號、2024 年第 33 號及 2025 年第 47 號公告（全國平均電力二氧化碳排放係數）。
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport)：環境部（紐西蘭）：《排放量測》，2026 年排放係數 v2（長格式 CSV），購買的電力。 創用 CC 姓名標示 4.0 國際版. 出處：Ministry for the Environment。2026。Measuring emissions: A guide for organisations: 2026 emission factors（第 2 版）。紐西蘭王室著作權，依 CC BY 4.0 授權。
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data：Postcodes.io（郵遞區號轉位置查詢，僅限大不列顛郵遞區號）。 Open Government Licence v3.0. 出處：包含 Ordnance Survey 資料 © 英國王室著作權及資料庫權利。包含 Royal Mail 資料 © Royal Mail 著作權及資料庫權利。包含 National Statistics 資料 © 英國王室著作權及資料庫權利。包含 NRS 資料 © 英國王室著作權及資料庫權利。郵遞區號查詢由 postcodes.io 提供。
• Environment Agency：英格蘭環境署即時淹水監測 API（淹水警報與警示區域、目前警報）。 Open Government Licence v3.0. 出處：本服務使用來自即時資料 API（Beta）的 Environment Agency 淹水與河川水位資料。
• Environment Agency：英格蘭環境署河川與海洋淹水風險及地表逕流淹水風險（NaFRA2），現況與氣候變遷情境，透過 Defra WMS 取得。 Open Government Licence v3.0. 出處：© Environment Agency 著作權及／或資料庫權利 2025。保留一切權利。包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的公部門資訊。
• Scottish Environment Protection Agency (SEPA)：SEPA 淹水地圖（河川、海岸、地表逕流與小型水道；現況與未來），開放地圖服務。 Open Government Licence v3.0. 出處：©SEPA 2025；此 SEPA 產品依《開放政府授權條款》第 3.0 版授權。
• Natural Resources Wales：威爾斯自然資源局威爾斯淹水風險評估（河川、海洋、地表逕流與小型水道）及淹水警報區，透過 DataMapWales 取得。 Open Government Licence v3.0. 出處：包含 Natural Resources Wales 資訊 © Natural Resources Body for Wales 及資料庫權利。保留一切權利。洪峰流量估算以 FEH 方法與資料為基礎，© 及資料庫權利 UKCEH 2015。包含 Ordnance Survey 資料，英國王室著作權及資料庫權利。依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權。
• Met Office：英國氣象局氣候資料入口網站：各全球暖化程度下的 UKCP18 地方政府推估（夏季炎熱日數、熱夜、夏季最高氣溫、夏季與冬季降雨量）。 Open Government Licence v3.0. 出處：包含依《開放政府授權條款》第 3.0 版（Open Government Licence v3.0）授權的 Met Office 資料。包含 OS 與 ONS 資料 © 英國王室著作權及資料庫權利。來源：Met Office Climate Data Portal，UKCP18 地方政府氣候推估。

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xero 會計 API（客戶自己的帳簿）
• EXIOBASE 3 多區域投入產出模型（涵蓋所有國家的支出係數）
• IEA 排放係數
• ecoinvent
• SEAI 換算與排放係數（愛爾蘭），GHG_elec 工作表（2001 至 2025 年電力）
• DESNZ 在 2021 年及更早係數集中的海外電力係數，這些係數以 IEA 資料建立，受 IEA 本身的授權條款約束

這些來源的條款禁止轉售或再散布資料，因此不納入 API。完整清單請參閱我們的資料來源頁面。