API des facteurs : facteurs d'émission officiels britanniques et par pays pour vos logiciels

Fonctionnement

1. Connectez-vous et ouvrez l'API des facteurs dans l'application. Créez une clé et copiez-la (elle n'est affichée qu'une seule fois).
2. Envoyez-la avec chaque requête sous la forme Authorization: Bearer crf_….
3. Lisez data et affichez le texte attribution partout où les chiffres apparaissent.

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

Les clés sont conservées sur votre serveur, pas dans une page web. L'API est en lecture seule (GET), répond en JSON, autorise les requêtes cross-origin et est versionnée : tout ce qui casserait votre code va dans une nouvelle version, pas dans la v1.

Référence des points d'accès

Adresse de base https://carbonrecycling.co.uk/api/v1. GET /api/v1 liste les points d'accès et les sources sans clé. Pour les facteurs britanniques, year est le jeu DESNZ (2002 à 2026, le plus récent par défaut). Pour l'électricité par pays et par région américaine, year est votre année de reporting et la réponse correspond à la dernière année de données disponible jusqu'à celle-ci.

Un facteur britannique par identifiant

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

L'électricité britannique, avec le mix résiduel

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

Un pays

recommended suit la même règle que nos propres rapports : le chiffre officiel du pays, sauf si celui d'Ember est plus récent de plus d'un an.

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

Erreurs et limites

Les erreurs sont renvoyées sous la forme {"error": {"status", "code", "message"}}. 400 pour un paramètre invalide, 401 pour une clé manquante ou révoquée, 403 lorsque l'API des facteurs n'est pas activée sur le compte (avec un lien pour s'abonner), 404 pour un facteur, un pays ou un point d'accès inconnu, et 429 lorsque les appels du mois sont épuisés.

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

Licences et attribution

Nous ne fournissons que des données dont la licence autorise la diffusion dans un produit payant, et nous conservons une copie datée des conditions de chaque éditeur. Chaque réponse liste ses sources avec leur licence et la mention à afficher. Les chiffres sont fournis tels que publiés, sans garantie, et aucun des éditeurs ne cautionne Carbon Recycling ni votre produit.

• Department for Energy Security and Net Zero (DESNZ) : facteurs de conversion GES du gouvernement britannique pour le reporting des entreprises. Open Government Licence v3.0. Crédit : contient des informations du secteur public publiées sous licence Open Government Licence v3.0. Source : DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds : multiplicateurs d'émissions fondés sur les dépenses (UK's carbon footprint). Open Government Licence v3.0. Crédit : contient des informations du secteur public publiées sous licence Open Government Licence v3.0. Source : Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury : valeurs par défaut et taux du CBAM britannique. Open Government Licence v3.0. Crédit : contient des informations du secteur public publiées sous licence Open Government Licence v3.0. Source : HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM) ; HM Treasury et HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC : Ember Yearly Electricity Data (intensité du réseau par pays). Creative Commons Attribution 4,0 International. Crédit : contient des données d'Ember, publiées sous licence CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency : EPA eGRID et GHG Emission Factors Hub (jusqu'à l'édition 2025). US government work, public domain under 17 U.S.C. § 105. Crédit : Source : US EPA, eGRID et GHG Emission Factors Hub. Non exigé par la loi, mais nous le citons.
• Environnement et Changement climatique Canada : rapport d'inventaire national de Canada, tableaux d'intensité de l'électricité de l'annexe 7. Open Government Licence - Canada 2.0. Crédit : contient des informations publiées sous licence Open Government Licence – Canada (Environment and Climate Change Canada, National Inventory Report).
• Energy Market Authority, Singapore : facteurs d'émission du réseau de l'Energy Market Authority de Singapour (data.gov.sg). Singapore Open Data Licence version 1.0. Crédit : contient des informations issues de Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor, consultées le 19 octobre 2026 sur data.gov.sg, mises à disposition selon les conditions de la Singapour Open Data Licence version 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France : Base Carbone de l'ADEME (copie ouverte sur data.ademe.fr), électricité. Licence Ouverte / Open Licence 2.0 (Etalab). Crédit : Source : ADEME, Base Carbone® V23.6 (data.ademe.fr, dernière mise à jour le 3 juillet 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia : Australian National Greenhouse Accounts Factors (éditions 2022 à 2026). Creative Commons Attribution 4,0 International. Crédit : DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, août. CC BY 4,0. (Les éditions antérieures sont créditées de la même façon avec leur propre année.)
• Cornerstone Sustainability Data Initiative : Emission Factors Hub 2026 (électricité eGRID2024, PRG de l'AR6). Creative Commons Attribution 4,0 International. Crédit : 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) : tableau des données Fuel mix disclosure (mix résiduel britannique). Open Government Licence v3.0. Crédit : contient des informations du secteur public publiées sous licence Open Government Licence v3.0. Source : DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany : Umweltbundesamt : émissions spécifiques de gaz à effet de serre du mix électrique allemand de 1990 à 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Crédit : Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Chiffres convertis de g en kg par kWh par Carbon Recycling.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China : ministère de l'Écologie et de l'Environnement et Bureau national des statistiques : facteurs d'émission de CO2 de l'électricité nationale de 2021 à 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Crédit : Source : ministère de l'Écologie et de l'Environnement et Bureau national des statistiques de Chine, annonces 2024 n° 12, 2024 n° 33 et 2025 n° 47 (facteur d'émission de CO2 moyen de l'électricité nationale).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport) : Ministry for the Environment (Nouvelle-Zélande) : Measuring emissions, facteurs d'émission 2026 v2 (CSV au format long), électricité achetée. Creative Commons Attribution 4,0 International. Crédit : Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (version 2). Crown copyright, publié sous licence CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data : Postcodes.io (correspondance entre code postal et localisation, codes postaux de Grande-Bretagne uniquement). Open Government Licence v3.0. Crédit : contient des données Ordnance Survey © Crown copyright and database right. Contient des données Royal Mail © Royal Mail copyright and database right. Contient des données National Statistics © Crown copyright and database right. Contient des données NRS © Crown copyright and database right. Recherche de codes postaux par postcodes.io.
• Environment Agency : API de surveillance des inondations en temps réel de l'Environment Agency (zones d'alerte et de vigilance inondation, alertes en cours). Open Government Licence v3.0. Crédit : utilise les données sur les inondations et les niveaux des cours d'eau de l'Environment Agency issues de l'API de données en temps réel (bêta).
• Environment Agency : Risk of Flooding from Rivers and Sea, and from Surface Water (NaFRA2) de l'Environment Agency, situation actuelle et avec le changement climatique, via le WMS de Defra. Open Government Licence v3.0. Crédit : © Environment Agency copyright and/or database right 2025. All rights reserved. Contient des informations du secteur public publiées sous licence Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA) : SEPA Flood Maps (fluviales, côtières, eaux de surface et petits cours d'eau ; situation actuelle et future), service cartographique ouvert. Open Government Licence v3.0. Crédit : ©SEPA 2025 ; ce produit SEPA est publié sous licence Open Government Licence version 3,0.
• Natural Resources Wales : Flood Risk Assessment Wales de Natural Resources Wales (rivières, mer, eaux de surface et petits cours d'eau) et zones d'alerte inondation, via DataMapWales. Open Government Licence v3.0. Crédit : contient des informations de Natural Resources Wales © Natural Resources Body for Wales and database right. All rights reserved. Les estimations de débits de crue reposent sur la méthodologie et les données FEH, © and database right UKCEH 2015. Contient des données Ordnance Survey, Crown copyright and database right. Publié sous licence Open Government Licence v3.0.
• Met Office : Met Office Climate Data Portal : projections UKCP18 par collectivité locale selon les niveaux de réchauffement mondial (journées chaudes d'été, nuits tropicales, température maximale estivale, précipitations estivales et hivernales). Open Government Licence v3.0. Crédit : contient des données du Met Office publiées sous licence Open Government Licence v3.0. Contient des données OS et ONS © Crown copyright and database right. Source : Met Office Climate Data Portal, projections UKCP18 par collectivité locale.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• API comptable Xero (le grand livre du client)
• EXIOBASE 3, modèle entrées-sorties multirégional (facteurs de dépenses pour chaque pays)
• Facteurs d'émission de l'AIE
• ecoinvent
• Facteurs de conversion et d'émission du SEAI (Irlande), feuille GHG_elec (électricité de 2001 à 2025)
• Les facteurs d'électricité à l'étranger du DESNZ dans son jeu 2021 et les précédents, établis à partir de données de l'AIE sous la licence propre à l'AIE

Leurs conditions interdisent la revente ou la redistribution des données ; elles ne figurent donc pas dans l'API. Consultez notre page sources de données pour le registre complet.