Factor API: fattori di emissione ufficiali del Regno Unito e dei paesi per il suo software

Come funziona

1. Acceda e apra Factor API nell'app. Crei una chiave e la copi (viene mostrata una sola volta).
2. La invii con ogni richiesta come Authorization: Bearer crf_….
3. Legga data e mostri il testo attribution ovunque compaiano i dati.

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

Le chiavi restano sul suo server, non in una pagina web. L'API è di sola lettura (GET), risponde in JSON, consente richieste cross-origin ed è versionata: tutto ciò che potrebbe compromettere il suo codice va in una nuova versione, non nella v1.

Riferimento degli endpoint

Indirizzo di base https://carbonrecycling.co.uk/api/v1. GET /api/v1 elenca gli endpoint e le fonti senza chiave. Per i fattori del Regno Unito, year è il set DESNZ (dal 2002 al 2026, predefinito il più recente). Per l'energia elettrica per paese e per regione USA, year è il suo anno di rendicontazione e la risposta è l'anno di dati più recente fino a quello.

Un fattore del Regno Unito per 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 }
}

Energia elettrica del Regno Unito, con il mix residuo

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 paese

recommended segue la stessa regola dei nostri report: il dato ufficiale del paese, a meno che quello di Ember non sia più recente di oltre un anno.

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

Errori e limiti

Gli errori vengono restituiti come {"error": {"status", "code", "message"}}. 400 per un parametro non valido, 401 per una chiave mancante o revocata, 403 quando Factor API non è attivo sull'account (con un link per abbonarsi), 404 per un fattore, un paese o un endpoint sconosciuto e 429 quando le chiamate del mese sono esaurite.

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

Licenze e attribuzione

Forniamo solo dati la cui licenza ne consente la trasmissione in un prodotto a pagamento e conserviamo una copia datata dei termini di ciascun editore. Ogni risposta elenca le fonti su cui si basa, con la relativa licenza e i crediti da mostrare. I dati sono forniti così come pubblicati, senza garanzia, e nessuno degli editori sostiene Carbon Recycling o il suo prodotto.

• Department for Energy Security and Net Zero (DESNZ): Fattori di conversione GHG del governo del Regno Unito per la rendicontazione aziendale. Open Government Licence v3.0. Crediti: contiene informazioni del settore pubblico concesse in licenza ai sensi della Open Government Licence v3.0. Fonte: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: Moltiplicatori di emissione basati sulla spesa (UK's carbon footprint). Open Government Licence v3.0. Crediti: contiene informazioni del settore pubblico concesse in licenza ai sensi della Open Government Licence v3.0. Fonte: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: Valori predefiniti e aliquote UK CBAM. Open Government Licence v3.0. Crediti: contiene informazioni del settore pubblico concesse in licenza ai sensi della Open Government Licence v3.0. Fonte: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury e HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC: Ember Yearly Electricity Data (intensità della rete per paese). Creative Commons Attribuzione 4,0 Internazionale. Crediti: contiene dati di Ember, concessi in licenza CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency: EPA eGRID e GHG Emission Factors Hub (fino all'edizione 2025). US government work, public domain under 17 U.S.C. § 105. Crediti: Fonte: US EPA, eGRID e GHG Emission Factors Hub. Non richiesto per legge, ma lo citiamo.
• Environment and Climate Change Canada: Canada National Inventory Report, tabelle sull'intensità dell'energia elettrica dell'allegato 7. Open Government Licence - Canada 2.0. Crediti: Contains information licensed under the Open Government Licence – Canada (Environment and Climate Change Canada, National Inventory Report).
• Energy Market Authority, Singapore: Singapore Energy Market Authority, fattori di emissione della rete (data.gov.sg). Singapore Open Data Licence version 1.0. Crediti: Contains information from Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor accessed on 19 October 2026 from data.gov.sg, which is made available under the terms of Singapore Open Data Licence version 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone (copia aperta su data.ademe.fr), energia elettrica. Licence Ouverte / Open Licence 2.0 (Etalab). Crediti: Fonte: ADEME, Base Carbone® V23.6 (data.ademe.fr, ultimo aggiornamento 3 luglio 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (edizioni dal 2022 al 2026). Creative Commons Attribuzione 4,0 Internazionale. Crediti: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, agosto. CC BY 4,0. (Le edizioni precedenti sono citate allo stesso modo con il rispettivo anno.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (energia elettrica eGRID2024, GWP AR6). Creative Commons Attribuzione 4,0 Internazionale. Crediti: 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): Fuel mix disclosure data table (mix residuo di combustibili del Regno Unito). Open Government Licence v3.0. Crediti: contiene informazioni del settore pubblico concesse in licenza ai sensi della Open Government Licence v3.0. Fonte: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: Umweltbundesamt: emissioni specifiche di gas serra del mix elettrico tedesco dal 1990 al 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Crediti: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Valori convertiti da g a kg per kWh da Carbon Recycling.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministero dell'Ecologia e dell'Ambiente e Ufficio nazionale di statistica: fattori nazionali di emissione di CO2 dell'energia elettrica dal 2021 al 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Crediti: Fonte: Ministero dell'Ecologia e dell'Ambiente e Ufficio nazionale di statistica della Cina, comunicati 2024 n. 12, 2024 n. 33 e 2025 n. 47 (fattore medio nazionale di emissione di CO2 dell'energia elettrica).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Nuova Zelanda): Measuring emissions, fattori di emissione 2026 v2 (CSV in formato lungo), energia elettrica acquistata. Creative Commons Attribuzione 4,0 Internazionale. Crediti: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (version 2). Crown copyright, concesso in licenza CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (corrispondenza tra codice postale e località, solo codici postali della Gran Bretagna). Open Government Licence v3.0. Crediti: Contains Ordnance Survey data © Crown copyright and database right. Contains Royal Mail data © Royal Mail copyright and database right. Contains National Statistics data © Crown copyright and database right. Contains NRS data © Crown copyright and database right. Ricerca dei codici postali tramite postcodes.io.
• Environment Agency: Environment Agency, API di monitoraggio delle alluvioni in tempo reale (aree di allerta alluvione e allerte in corso). Open Government Licence v3.0. Crediti: utilizza i dati sulle alluvioni e sui livelli dei fiumi di Environment Agency forniti dalla real-time data API (Beta).
• Environment Agency: Environment Agency, Risk of Flooding from Rivers and Sea e from Surface Water (NaFRA2), situazione attuale e con il cambiamento climatico, tramite il servizio WMS di Defra. Open Government Licence v3.0. Crediti: © Environment Agency copyright and/or database right 2025. All rights reserved. Contiene informazioni del settore pubblico concesse in licenza ai sensi della Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA): SEPA Flood Maps (fiumi, coste, acque superficiali e piccoli corsi d'acqua; situazione attuale e futura), servizio cartografico aperto. Open Government Licence v3.0. Crediti: ©SEPA 2025; this SEPA product is licensed under the Open Government Licence version 3,0.
• Natural Resources Wales: Natural Resources Wales, Flood Risk Assessment Wales (fiumi, mare, acque superficiali e piccoli corsi d'acqua) e aree di allerta alluvione, tramite DataMapWales. Open Government Licence v3.0. Crediti: Contains Natural Resources Wales information © Natural Resources Body for Wales and database right. All rights reserved. Flood flow estimates are based upon FEH methodology and data, © and database right UKCEH 2015. Contains Ordnance Survey data, Crown copyright and database right. Licensed under the Open Government Licence v3.0.
• Met Office: Met Office Climate Data Portal: proiezioni UKCP18 per autorità locale ai diversi livelli di riscaldamento globale (giornate estive calde, notti tropicali, temperatura massima estiva, precipitazioni estive e invernali). Open Government Licence v3.0. Crediti: Contains Met Office data licensed under the Open Government Licence v3.0. Contains OS and ONS data © Crown copyright and database right. Fonte: Met Office Climate Data Portal, proiezioni UKCP18 per autorità locale.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• API contabile di Xero (la contabilità del cliente stesso)
• EXIOBASE 3 multiregionale input-output (fattori di spesa per ogni paese)
• Fattori di emissione IEA
• ecoinvent
• Fattori di conversione e di emissione SEAI (Irlanda), foglio GHG_elec (energia elettrica dal 2001 al 2025)
• I fattori dell'energia elettrica estera di DESNZ nel set 2021 e in quelli precedenti, costruiti con dati IEA soggetti alla licenza della IEA

I loro termini vietano la rivendita o la ridistribuzione dei dati, quindi restano fuori dall'API. Consulti la nostra pagina fonti dei dati per il registro completo.