Factor API: fatores de emissão oficiais do Reino Unido e de outros países para o seu software

Como funciona

1. Inicie sessão e abra a Factor API na aplicação. Crie uma chave e copie-a (só é mostrada uma vez).
2. Envie-a em cada pedido como Authorization: Bearer crf_….
3. Leia data e mostre o texto de attribution onde quer que os valores apareçam.

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

As chaves ficam no seu servidor, não numa página web. A API é só de leitura (GET), responde em JSON, permite pedidos de outras origens e tem versões: tudo o que possa quebrar o seu código vai para uma nova versão, não para a v1.

Referência dos endpoints

Endereço base https://carbonrecycling.co.uk/api/v1. GET /api/v1 lista os endpoints e as fontes sem necessidade de chave. Para fatores do Reino Unido, o ano é o conjunto DESNZ (2002 a 2026, por defeito o mais recente). Para a eletricidade por país e por região dos EUA, o ano é o seu ano de relato e a resposta é o ano de dados mais recente até esse ano.

Um fator do Reino Unido por 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 }
}

Eletricidade do Reino Unido, com o mix residual

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

Um país

recommended segue a mesma regra dos nossos próprios relatórios: o valor oficial do país, a menos que o da Ember seja mais de um ano mais recente.

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

Erros e limites

Os erros são devolvidos como {"error": {"status", "code", "message"}}. 400 para um parâmetro inválido, 401 para uma chave em falta ou revogada, 403 quando a Factor API não está na conta (com uma ligação para a subscrever), 404 para um fator, país ou endpoint desconhecido e 429 quando as chamadas do mês se esgotam.

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

Licenças e atribuição

Só disponibilizamos dados cuja licença permita a sua transmissão num produto pago, e guardamos uma cópia datada dos termos de cada editor. Cada resposta lista as fontes em que se baseia, com a respetiva licença e o crédito a mostrar. Os valores são os publicados, sem garantia, e nenhum dos editores apoia a Carbon Recycling ou o seu produto.

• Department for Energy Security and Net Zero (DESNZ): UK Government GHG Conversion Factors for Company Reporting. Open Government Licence v3.0. Crédito: Contains public sector information licensed under the Open Government Licence v3.0. Fonte: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: multiplicadores de emissões baseados na despesa (pegada de carbono do Reino Unido). Open Government Licence v3.0. Crédito: Contains public sector information licensed under the Open Government Licence v3.0. Fonte: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: valores por defeito e taxas do UK CBAM. Open Government Licence v3.0. Crédito: Contains public sector information licensed under the 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 (intensidade da rede por país). Creative Commons Atribuição 4,0 Internacional. Crédito: Contains data from Ember, licensed under CC BY 4,0 (ember-energy.org).
• US Environmental Protection Agency: EPA eGRID e GHG Emission Factors Hub (até à edição de 2025). US government work, public domain under 17 U.S.C. § 105. Crédito: Fonte: US EPA, eGRID e GHG Emission Factors Hub. Não é exigido por lei, mas creditamos a fonte.
• Ambiente e Alterações Climáticas Canadá: National Inventory Report de Canadá, tabelas de intensidade elétrica do Anexo 7. Open Government Licence - Canada 2.0. Crédito: Contains information licensed under the Open Government Licence – Canadá (Environment and Climate Change Canadá, National Inventory Report).
• Energy Market Authority, Singapore: fatores de emissão da rede da Energy Market Authority de Singapura (data.gov.sg). Singapore Open Data Licence version 1.0. Crédito: 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 Singapura Open Data Licence version 1,0 (https://data.gov.sg/open-data-licence).
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone (cópia aberta em data.ademe.fr), eletricidade. Licence Ouverte / Open Licence 2.0 (Etalab). Crédito: Source: ADEME, Base Carbone® V23.6 (data.ademe.fr, última atualização a 3 de julho de 2025), Licence Ouverte 2,0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (edições de 2022 a 2026). Creative Commons Atribuição 4,0 Internacional. Crédito: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, agosto. CC BY 4,0. (As edições anteriores são creditadas da mesma forma, com o respetivo ano.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (eletricidade eGRID2024, PAG do AR6). Creative Commons Atribuição 4,0 Internacional. Crédito: 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): tabela de dados da divulgação do mix de combustíveis (mix residual de combustíveis do Reino Unido). Open Government Licence v3.0. Crédito: Contains public sector information licensed under the Open Government Licence v3.0. Fonte: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: Umweltbundesamt: emissões específicas de gases com efeito de estufa do mix elétrico alemão de 1990 a 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Crédito: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Valores convertidos de g para kg por kWh pela Carbon Recycling.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministério da Ecologia e Ambiente e Gabinete Nacional de Estatística: fatores nacionais de emissão de CO2 da eletricidade de 2021 a 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Crédito: Fonte: Ministério da Ecologia e Ambiente e Gabinete Nacional de Estatística de China, anúncios 2024 n.º 12, 2024 n.º 33 e 2025 n.º 47 (fator de emissão médio nacional de CO2 da eletricidade).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Nova Zelândia): Measuring emissions, fatores de emissão de 2026 v2 (CSV em formato longo), eletricidade adquirida. Creative Commons Atribuição 4,0 Internacional. Crédito: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (versão 2). Crown copyright, licenciado ao abrigo da CC BY 4,0.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (correspondência entre código postal e localização, apenas códigos postais da Grã-Bretanha). Open Government Licence v3.0. Crédito: 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. Pesquisa de códigos postais por postcodes.io.
• Environment Agency: API de monitorização de inundações em tempo real da Environment Agency (áreas de alerta de inundação e alertas em vigor). Open Government Licence v3.0. Crédito: This uses Environment Agency flood and river level data from the real-time data API (Beta).
• Environment Agency: Environment Agency Risk of Flooding from Rivers and Sea, and from Surface Water (NaFRA2), situação atual e com alterações climáticas, através do WMS da Defra. Open Government Licence v3.0. Crédito: © Environment Agency copyright and/or database right 2025. All rights reserved. Contains public sector information licensed under the Open Government Licence v3.0.
• Scottish Environment Protection Agency (SEPA): SEPA Flood Maps (fluviais, costeiras e águas superficiais e pequenos cursos de água; atuais e futuras), serviço de mapas aberto. Open Government Licence v3.0. Crédito: ©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 (rios, mar, águas superficiais e pequenos cursos de água) e áreas de alerta de inundação, através do DataMapWales. Open Government Licence v3.0. Crédito: 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: projeções UKCP18 por autoridade local para níveis de aquecimento global (dias quentes de verão, noites tropicais, temperatura máxima de verão, precipitação de verão e de inverno). Open Government Licence v3.0. Crédito: 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, UKCP18 local authority projections.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• API de contabilidade Xero (a contabilidade do próprio cliente)
• EXIOBASE 3, modelo input-output multirregional (fatores de despesa para todos os países)
• Fatores de emissão da IEA
• ecoinvent
• Fatores de conversão e de emissão da SEAI (Irlanda), folha GHG_elec (eletricidade de 2001 a 2025)
• Os fatores de eletricidade de outros países do DESNZ nos seus conjuntos de 2021 e anteriores, construídos a partir de dados da IEA ao abrigo da licença da própria IEA

Os seus termos proíbem a revenda ou redistribuição dos dados, pelo que ficam fora da API. Consulte a nossa página de fontes de dados para o registo completo.