Faktor-API: amtliche Emissionsfaktoren für das Vereinigte Königreich und weitere Länder für Ihre Software

So funktioniert es

1. Melden Sie sich an und öffnen Sie Factor API in der App. Erstellen Sie einen Schlüssel und kopieren Sie ihn (er wird nur einmal angezeigt).
2. Senden Sie ihn bei jeder Anfrage als Authorization: Bearer crf_….
3. Lesen Sie data und zeigen Sie den Text aus attribution überall dort an, wo die Zahlen erscheinen.

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

Schlüssel werden auf Ihrem Server aufbewahrt, nicht in einer Webseite. Die API ist schreibgeschützt (GET), antwortet in JSON, erlaubt Cross-Origin-Anfragen und ist versioniert: Alles, was Ihren Code beeinträchtigen würde, kommt in eine neue Version, nicht in v1.

Endpunkt-Referenz

Basisadresse https://carbonrecycling.co.uk/api/v1. GET /api/v1 listet die Endpunkte und Quellen ohne Schlüssel auf. Für britische Faktoren ist year der DESNZ-Satz (2002 bis 2026, standardmäßig der neueste). Für Strom nach Land und US-Region ist year Ihr Berichtsjahr, und die Antwort ist das neueste Datenjahr bis dahin.

Ein britischer Faktor nach 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 }
}

Britischer Strom mit Residualmix

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

Ein Land

recommended folgt derselben Regel wie unsere eigenen Berichte: der amtliche Wert des Landes, es sei denn, der Wert von Ember ist mehr als ein Jahr aktueller.

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

Fehler und Limits

Fehler werden als {"error": {"status", "code", "message"}} zurückgegeben. 400 bei einem ungültigen Parameter, 401 bei einem fehlenden oder widerrufenen Schlüssel, 403, wenn die Faktor-API nicht im Konto enthalten ist (mit einem Link zum Abonnieren), 404 bei einem unbekannten Faktor, Land oder Endpunkt und 429, sobald die Aufrufe des Monats verbraucht sind.

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

Lizenzen und Quellenangaben

Wir liefern nur Daten, deren Lizenz die Weitergabe in einem kostenpflichtigen Produkt erlaubt, und bewahren eine datierte Kopie der Bedingungen jedes Herausgebers auf. Jede Antwort nennt die zugrunde liegenden Quellen mit ihrer Lizenz und dem anzuzeigenden Quellenvermerk. Die Werte werden wie veröffentlicht und ohne Gewähr bereitgestellt, und keiner der Herausgeber empfiehlt Carbon Recycling oder Ihr Produkt.

• Department for Energy Security and Net Zero (DESNZ): THG-Umrechnungsfaktoren der britischen Regierung für die Unternehmensberichterstattung. Open Government Licence v3.0. Quellenangabe: Enthält Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0. Quelle: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: Ausgabenbasierte Emissionsmultiplikatoren (UK's carbon footprint). Open Government Licence v3.0. Quellenangabe: Enthält Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0. Quelle: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: Standardwerte und CBAM-Sätze des UK CBAM. Open Government Licence v3.0. Quellenangabe: Enthält Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0. Quelle: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury und HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC: Ember Yearly Electricity Data (Netzintensität nach Land). Creative Commons Namensnennung 4,0 International. Quellenangabe: Enthält Daten von Ember, lizenziert unter CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency: EPA eGRID und GHG Emission Factors Hub (bis zur Ausgabe 2025). US government work, public domain under 17 U.S.C. § 105. Quellenangabe: Quelle: US EPA, eGRID und GHG Emission Factors Hub. Gesetzlich nicht vorgeschrieben, aber wir nennen die Quelle.
• Environment and Climate Change Kanada: National Inventory Report von Kanada, Anhang 7, Tabellen zur Stromintensität. Open Government Licence - Canada 2.0. Quellenangabe: Enthält Informationen, lizenziert unter der Open Government Licence – Kanada (Environment and Climate Change Kanada, National Inventory Report).
• Energy Market Authority, Singapore: Netz-Emissionsfaktoren der Energy Market Authority von Singapur (data.gov.sg). Singapore Open Data Licence version 1.0. Quellenangabe: Enthält Informationen aus Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor, abgerufen am 19. Oktober 2026 von data.gov.sg, bereitgestellt gemäß den Bedingungen der Open Data Licence von Singapur, Version 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone (offene Kopie auf data.ademe.fr), Strom. Licence Ouverte / Open Licence 2.0 (Etalab). Quellenangabe: Quelle: ADEME, Base Carbone® V23.6 (data.ademe.fr, zuletzt aktualisiert am 3. Juli 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (Ausgaben 2022 bis 2026). Creative Commons Namensnennung 4,0 International. Quellenangabe: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, August. CC BY 4,0. (Frühere Ausgaben werden auf dieselbe Weise mit ihrem jeweiligen Jahr genannt.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (Strom nach eGRID2024, GWP-Werte nach AR6). Creative Commons Namensnennung 4,0 International. Quellenangabe: 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): Datentabelle zur Stromkennzeichnung (britischer Residualmix). Open Government Licence v3.0. Quellenangabe: Enthält Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0. Quelle: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: Umweltbundesamt: spezifische Treibhausgas-Emissionen des deutschen Strommix 1990 bis 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Quellenangabe: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Werte von Carbon Recycling von g in kg pro kWh umgerechnet.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministerium für Ökologie und Umwelt und Nationales Statistikamt: nationale CO2-Emissionsfaktoren für Strom 2021 bis 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Quellenangabe: Quelle: Ministerium für Ökologie und Umwelt und Nationales Statistikamt von China, Bekanntmachungen 2024 Nr. 12, 2024 Nr. 33 und 2025 Nr. 47 (nationaler durchschnittlicher CO2-Emissionsfaktor für Strom).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Neuseeland): Measuring emissions, Emissionsfaktoren 2026 v2 (CSV im Langformat), eingekaufter Strom. Creative Commons Namensnennung 4,0 International. Quellenangabe: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (Version 2). Crown copyright, lizenziert unter CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (Zuordnung von Postleitzahl zu Standort, nur Postleitzahlen in Großbritannien). Open Government Licence v3.0. Quellenangabe: Enthält Daten von Ordnance Survey © Crown copyright and database right. Enthält Daten von Royal Mail © Royal Mail copyright and database right. Enthält Daten von National Statistics © Crown copyright and database right. Enthält Daten von NRS © Crown copyright and database right. Postleitzahlenabfragen über postcodes.io.
• Environment Agency: Echtzeit-API der Environment Agency zur Hochwasserüberwachung (Hochwasserwarn- und -alarmgebiete, aktuelle Warnungen). Open Government Licence v3.0. Quellenangabe: Verwendet Hochwasser- und Pegeldaten der Environment Agency aus der Echtzeit-Daten-API (Beta).
• Environment Agency: Environment Agency Risk of Flooding from Rivers and Sea sowie from Surface Water (NaFRA2), heute und mit Klimawandel, über den Defra-WMS. Open Government Licence v3.0. Quellenangabe: © Environment Agency copyright and/or database right 2025. Alle Rechte vorbehalten. Enthält Informationen des öffentlichen Sektors, lizenziert unter der Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA): SEPA Flood Maps (Flüsse, Küsten sowie Oberflächenwasser und kleine Wasserläufe; heute und künftig), offener Kartendienst. Open Government Licence v3.0. Quellenangabe: ©SEPA 2025; dieses SEPA-Produkt ist unter der Open Government Licence Version 3,0 lizenziert.
• Natural Resources Wales: Natural Resources Wales Flood Risk Assessment Wales (Flüsse, Meer, Oberflächenwasser und kleine Wasserläufe) und Hochwasserwarngebiete, über DataMapWales. Open Government Licence v3.0. Quellenangabe: Enthält Informationen von Natural Resources Wales © Natural Resources Body for Wales and database right. Alle Rechte vorbehalten. Schätzungen des Hochwasserabflusses beruhen auf der FEH-Methodik und -Daten, © and database right UKCEH 2015. Enthält Daten von Ordnance Survey, Crown copyright and database right. Lizenziert unter der Open Government Licence v3.0.
• Met Office: Met Office Climate Data Portal: UKCP18-Projektionen auf Ebene der Verwaltungsbezirke bei globalen Erwärmungsniveaus (heiße Sommertage, Tropennächte, sommerliche Höchsttemperatur, Sommer- und Winterniederschlag). Open Government Licence v3.0. Quellenangabe: Enthält Daten des Met Office, lizenziert unter der Open Government Licence v3.0. Enthält Daten von OS und ONS © Crown copyright and database right. Quelle: Met Office Climate Data Portal, UKCP18 local authority projections.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xero-Buchhaltungs-API (das eigene Hauptbuch des Kunden)
• EXIOBASE 3, multiregionales Input-Output-Modell (Ausgabenfaktoren für jedes Land)
• IEA-Emissionsfaktoren
• ecoinvent
• SEAI-Umrechnungs- und Emissionsfaktoren (Irland), Tabellenblatt GHG_elec (Strom 2001 bis 2025)
• Die Stromfaktoren für das Ausland in den DESNZ-Sätzen 2021 und früher, die aus IEA-Daten unter der eigenen Lizenz der IEA erstellt wurden

Deren Bedingungen schließen den Weiterverkauf oder die Weitergabe der Daten aus, daher sind sie nicht in der API enthalten. Das vollständige Verzeichnis finden Sie auf unserer Seite zu den Datenquellen.