Factor API：ソフトウェア向けの英国公式および各国の排出係数

仕組み

1. ログインしてアプリでFactor APIを開きます。キーを作成してコピーしてください（表示は1回のみです）。
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は報告年度であり、その年度までの最新のデータ年度の値を返します。

IDによる英国の係数

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": "..."
}

1つの国

recommendedは当社のレポートと同じ規則に従います：その国の公式の数値を使用し、Emberの数値が1年以上新しい場合のみ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、アカウントでFactor APIが有効でない場合は403（申込みへのリンク付き）、不明な係数・国・エンドポイントには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)：企業報告のための英国政府GHG換算係数。 Open Government Licence v3.0. クレジット：Open Government Licence v3.0に基づきライセンスされた公共部門の情報を含みます。出典：DESNZ「Greenhouse gas reporting: conversion factors」。
• Defra and the University of Leeds：支出ベースの排出乗数（英国のカーボンフットプリント）。 Open Government Licence v3.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. クレジット：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年次電力データ（国別の系統原単位）。 クリエイティブ・コモンズ 表示 4.0 国際. クレジット：CC BY 4.0に基づきライセンスされたEmberのデータを含みます（ember-energy.org）。
• US Environmental Protection Agency：EPA eGRIDおよびGHG Emission Factors Hub（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. クレジット：Open Government Licence – カナダに基づきライセンスされた情報を含みます（Environment and Climate Change カナダ、National Inventory Report）。
• Energy Market Authority, Singapore：シンガポールエネルギー市場庁の系統排出係数（data.gov.sg）。 Singapore Open Data Licence version 1.0. クレジット：2026年10月19日にdata.gov.sgから取得したElectricity Grid Emission Factors and Upstream Fugitive Methane Emission Factorの情報を含みます。この情報はシンガポール Open Data Licenceバージョン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年版）。 クリエイティブ・コモンズ 表示 4.0 国際. クレジット：DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, August。CC BY 4.0。（それ以前の版も、それぞれの年で同様にクレジットを表示しています。）
• Cornerstone Sustainability Data Initiative：Emission Factors Hub 2026（eGRID2024の電力、AR6のGWP）。 クリエイティブ・コモンズ 表示 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. クレジット：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あたりのgからkgに換算しています。
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China：生態環境部および国家統計局：全国電力CO2排出係数（2021年～2023年）。 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号（全国平均電力CO2排出係数）。
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport)：環境省（ニュージーランド）：Measuring emissions、2026年排出係数v2（ロング形式CSV）、購入電力。 クリエイティブ・コモンズ 表示 4.0 国際. クレジット：Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (version 2)。Crown copyright、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のデータを含みます © Crown copyright and database right。Royal Mailのデータを含みます © Royal Mail copyright and database right。National Statisticsのデータを含みます © Crown copyright and database right。NRSのデータを含みます © Crown copyright and database right。郵便番号検索はpostcodes.ioによります。
• Environment Agency：環境庁のリアルタイム洪水監視API（洪水警報・注意報区域、現在の警報）。 Open Government Licence v3.0. クレジット：環境庁のリアルタイムデータAPI（ベータ版）の洪水・河川水位データを使用しています。
• Environment Agency：環境庁の河川・海および地表水による洪水リスク（NaFRA2）、現在および気候変動考慮、Defra WMS経由。 Open Government Licence v3.0. クレジット：© Environment Agency copyright and/or database right 2025. All rights reserved. Open Government Licence v3.0に基づきライセンスされた公共部門の情報を含みます。
• Scottish Environment Protection Agency (SEPA)：SEPA Flood Maps（河川、沿岸、地表水・小水路、現在および将来）、オープン地図サービス。 Open Government Licence v3.0. クレジット：©SEPA 2025。このSEPA製品はOpen Government Licenceバージョン3.0に基づきライセンスされています。
• Natural Resources Wales：Natural Resources WalesのFlood Risk Assessment Wales（河川、海、地表水、小水路）および洪水警報区域、DataMapWales経由。 Open Government Licence v3.0. クレジット：Natural Resources Walesの情報を含みます © Natural Resources Body for Wales and database right. All rights reserved. 洪水流量推計はFEHの手法とデータに基づきます © and database right UKCEH 2015。Ordnance Surveyのデータを含みます、Crown copyright and database right。Open Government Licence v3.0に基づきライセンスされています。
• Met Office：Met Office Climate Data Portal：地球温暖化レベル別のUKCP18地方自治体予測（夏日、熱帯夜、夏の最高気温、夏・冬の降水量）。 Open Government Licence v3.0. クレジット：Open Government Licence v3.0に基づきライセンスされたMet Officeのデータを含みます。OSおよびONSのデータを含みます © Crown copyright and database right。出典：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）
• 2021年版以前の係数セットに含まれるDESNZの海外電力係数（IEA独自のライセンスに基づくIEAデータから作成）

これらは利用規約でデータの再販売・再配布が禁止されているため、APIには含めていません。全一覧はデータソースのページをご覧ください。