Carbon Recycling
Empiece la prueba gratuita

Complementos

Factor API: factores de emisión oficiales del Reino Unido y de otros países para su software

Obtenga en JSON los factores de conversión oficiales del Gobierno británico, el mix residual del Reino Unido, los factores de electricidad de la red de 194 países y regiones eléctricas de EE. UU., y los multiplicadores de gasto del Reino Unido. Cada respuesta indica de dónde procede la cifra y cómo citarla.

Para quién es

  • Empresas de software que añaden cifras de carbono a productos de contabilidad, ERP, flotas, viajes o inmuebles
  • Consultoras y auditores que quieren los factores oficiales en sus propios modelos y hojas de cálculo
  • Plataformas de compras y de proveedores que estiman emisiones a partir del gasto o del consumo de energía
  • Equipos internos de datos y sostenibilidad que alimentan un almacén de datos o un panel de BI

Qué hace

  • Todos los factores de conversión del Gobierno británico (DESNZ) de 2002 a 2026: busque por palabras, categoría y alcance, u obtenga uno por su ID de DESNZ
  • Electricidad del Reino Unido en una sola llamada: basada en la ubicación, transmisión y distribución, well-to-tank y el mix residual de combustibles del Reino Unido para el alcance 2 basado en el mercado
  • Factores de electricidad de la red para 194 países por año, con la cifra oficial del propio país cuando su licencia lo permite (Australia, Canadá, China, Francia, Alemania, Nueva Zelanda, Singapur) y la de Ember en los demás
  • Electricidad de EE. UU. para las 27 subregiones eGRID y la media nacional
  • Multiplicadores basados en el gasto del Reino Unido (kg CO2e por £) por código SIC, de 1997 a 2023
  • Texto de licencia y atribución en cada respuesta, para que pueda mostrar la cita correcta dondequiera que aparezcan las cifras

Cómo funciona

  1. Inicie sesión y abra Factor API en la aplicación. Cree una clave y cópiela (solo se muestra una vez).
  2. Envíela con cada solicitud como Authorization: Bearer crf_….
  3. Lea data y muestre el texto de attribution dondequiera que aparezcan las cifras.
curl -H "Authorization: Bearer $FACTOR_API_KEY" \
  "https://carbonrecycling.co.uk/api/v1/uk/factors?year=2026&q=diesel&category=fuels&scope=1"

Las claves se guardan en su servidor, no en una página web. La API es de solo lectura (GET), responde en JSON, admite solicitudes de origen cruzado y está versionada: cualquier cambio que pudiera romper su código va a una nueva versión, no a la v1.

Referencia de endpoints

Dirección base https://carbonrecycling.co.uk/api/v1. GET /api/v1 enumera los endpoints y las fuentes sin clave. Para los factores del Reino Unido, year es el conjunto de DESNZ (2002 a 2026; por defecto, el más reciente). Para la electricidad por país y por región de EE. UU., year es su año del informe y la respuesta es el año de datos más reciente hasta ese año.

GETQué devuelve
/uk/yearsLos conjuntos de DESNZ que tenemos, con el número de factores de cada uno.
/uk/categories?year=Categorías principales del conjunto de un año (combustibles, vehículos de pasajeros, eliminación de residuos...), con recuentos.
/uk/factors?year=&q=&category=&scope=&limit=&offset=Busque los factores de un año. q coincide con cada palabra; category es exacta (sin distinguir mayúsculas); scope es 1, 2 o 3; limit hasta 200 (por defecto 50).
/uk/factors/{id}?year=Un factor por su ID de DESNZ. Los ID se mantienen entre años, así que el mismo ID devuelve la cifra de cada año.
/uk/electricity?year=Electricidad de la red del Reino Unido, T&D y well-to-tank, además del mix residual de combustibles del Reino Unido para el alcance 2 basado en el mercado.
/uk/spend?year=&q=&limit=&offset=Multiplicadores de gasto de Defra por código SIC, kg CO2e por £ sin IVA.
/uk/spend/{sic}?year=El multiplicador de un código SIC, con todos los años.
/electricity/countries?year=El factor de red recomendado de cada país para un año del informe (por defecto, este año).
/electricity/countries/{iso3}?year=Un país por su código ISO 3166 alfa-3 o por su nombre (slug): la cifra recomendada, la serie de Ember y la serie oficial nacional.
/electricity/us/regions?year=Todas las subregiones eGRID y la media de EE. UU. para un año del informe.
/electricity/us/regions/{code}?year=Una subregión eGRID (como RFCE o CAMX) con todas las ediciones de que disponemos.

Un factor del 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 }
}

Electricidad del Reino Unido, con el 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": "..."
}

Un país

recommended sigue la misma regla que nuestros propios informes: la cifra oficial del país, salvo que la de Ember sea más de un año más reciente.

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

Errores y límites

Los errores se devuelven como {"error": {"status", "code", "message"}}. 400 para un parámetro incorrecto, 401 para una clave ausente o revocada, 403 cuando la cuenta no tiene Factor API (con un enlace para suscribirse), 404 para un factor, país o endpoint desconocido y 429 cuando se han agotado las llamadas del mes.

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

Licencias y atribución

Solo ofrecemos datos cuya licencia permite redistribuirlos en un producto de pago, y guardamos una copia fechada de las condiciones de cada editor. Cada respuesta indica las fuentes en que se basa, con su licencia y el crédito que debe mostrarse. Las cifras se ofrecen tal como se publicaron, sin garantía, y ninguno de los editores respalda a Carbon Recycling ni a su producto.

  • Department for Energy Security and Net Zero (DESNZ): factores de conversión de GEI del Gobierno británico para la información empresarial. Open Government Licence v3.0. Créditos: contiene información del sector público con licencia Open Government Licence v3.0. Fuente: DESNZ, Greenhouse gas reporting: conversion factors.
  • Defra and the University of Leeds: multiplicadores de emisiones basados en el gasto (huella de carbono del Reino Unido). Open Government Licence v3.0. Créditos: contiene información del sector público con licencia Open Government Licence v3.0. Fuente: Defra, UK's carbon footprint.
  • HM Revenue & Customs (HMRC) and HM Treasury: valores por defecto y tarifas del UK CBAM. Open Government Licence v3.0. Créditos: contiene información del sector público con licencia Open Government Licence v3.0. Fuente: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury y HMRC, Illustrative CBAM rates and worked example.
  • Ember Energy Research CIC: Ember Yearly Electricity Data (intensidad de la red por país). Creative Commons Atribución 4,0 Internacional. Créditos: contiene datos de Ember, con licencia CC BY 4,0 (ember-energy.org).
  • US Environmental Protection Agency: EPA eGRID y GHG Emission Factors Hub (hasta la edición de 2025). US government work, public domain under 17 U.S.C. § 105. Créditos: fuente: US EPA, eGRID y GHG Emission Factors Hub. No es obligatorio por ley, pero lo citamos.
  • Medio Ambiente y Cambio Climático Canadá: National Inventory Report de Canadá, tablas de intensidad eléctrica del anexo 7. Open Government Licence - Canada 2.0. Créditos: contiene información con licencia Open Government Licence – Canadá (Environment and Climate Change Canadá, National Inventory Report).
  • Energy Market Authority, Singapore: factores de emisión de la red de la Energy Market Authority de Singapur (data.gov.sg). Singapore Open Data Licence version 1.0. Créditos: contiene información de Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor consultada el 19 de octubre de 2026 en data.gov.sg, que se pone a disposición conforme a la Open Data Licence de Singapur versión 1,0 (https://data.gov.sg/open-data-licence).
  • ADEME (Agence de la transition écologique), France: ADEME Base Carbone (copia abierta de data.ademe.fr), electricidad. Licence Ouverte / Open Licence 2.0 (Etalab). Créditos: fuente: ADEME, Base Carbone® V23.6 (data.ademe.fr, última actualización el 3 de julio de 2025), Licence Ouverte 2,0.
  • Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: Australian National Greenhouse Accounts Factors (ediciones de 2022 a 2026). Creative Commons Atribución 4,0 Internacional. Créditos: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, agosto. CC BY 4,0. (Las ediciones anteriores se citan del mismo modo con su propio año).
  • Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026 (electricidad eGRID2024, PCG del AR6). Creative Commons Atribución 4,0 Internacional. Créditos: 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): tabla de datos de declaración del mix de combustibles (mix residual de combustibles del Reino Unido). Open Government Licence v3.0. Créditos: contiene información del sector público con licencia Open Government Licence v3.0. Fuente: DESNZ, Fuel mix disclosure data table.
  • Umweltbundesamt (UBA), Germany: Umweltbundesamt: emisiones específicas de gases de efecto invernadero del mix eléctrico alemán de 1990 a 2025 (Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. Créditos: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). Cifras convertidas de g a kg por kWh por Carbon Recycling.
  • Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: Ministerio de Ecología y Medio Ambiente y Oficina Nacional de Estadística: factores nacionales de emisión de CO2 de la electricidad de 2021 a 2023. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. Créditos: fuente: Ministerio de Ecología y Medio Ambiente y Oficina Nacional de Estadística de China, anuncios 2024 n.º 12, 2024 n.º 33 y 2025 n.º 47 (factor medio nacional de emisión de CO2 de la electricidad).
  • Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): Ministry for the Environment (Nueva Zelanda): Measuring emissions, factores de emisión 2026 v2 (CSV en formato largo), electricidad comprada. Creative Commons Atribución 4,0 Internacional. Créditos: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (versión 2). Crown copyright, con licencia CC BY 4,0.
  • Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io (localización a partir del código postal, solo códigos postales de Gran Bretaña). Open Government Licence v3.0. Créditos: contiene datos de Ordnance Survey © Crown copyright and database right. Contiene datos de Royal Mail © Royal Mail copyright and database right. Contiene datos de National Statistics © Crown copyright and database right. Contiene datos de NRS © Crown copyright and database right. Búsqueda de códigos postales mediante postcodes.io.
  • Environment Agency: API de seguimiento de inundaciones en tiempo real de la Environment Agency (zonas de aviso y alerta por inundación, avisos vigentes). Open Government Licence v3.0. Créditos: se utilizan datos de inundaciones y niveles fluviales de la Environment Agency procedentes de la API de datos en tiempo real (Beta).
  • Environment Agency: Risk of Flooding from Rivers and Sea, and from Surface Water (NaFRA2) de la Environment Agency, situación actual y con cambio climático, a través del WMS de Defra. Open Government Licence v3.0. Créditos: © Environment Agency copyright and/or database right 2025. Todos los derechos reservados. Contiene información del sector público con licencia Open Government Licence v3.0.
  • Scottish Environment Protection Agency (SEPA): SEPA Flood Maps (ríos, costa, aguas superficiales y pequeños cursos de agua; situación actual y futura), servicio de mapas abierto. Open Government Licence v3.0. Créditos: ©SEPA 2025; este producto de SEPA se distribuye con la Open Government Licence versión 3,0.
  • Natural Resources Wales: Flood Risk Assessment Wales de Natural Resources Wales (ríos, mar, aguas superficiales y pequeños cursos de agua) y zonas de aviso por inundación, a través de DataMapWales. Open Government Licence v3.0. Créditos: contiene información de Natural Resources Wales © Natural Resources Body for Wales and database right. Todos los derechos reservados. Las estimaciones de caudal de inundación se basan en la metodología y los datos FEH, © and database right UKCEH 2015. Contiene datos de Ordnance Survey, Crown copyright and database right. Con licencia Open Government Licence v3.0.
  • Met Office: Met Office Climate Data Portal: proyecciones UKCP18 por autoridad local según niveles de calentamiento global (días calurosos de verano, noches tropicales, temperatura máxima estival, precipitaciones de verano e invierno). Open Government Licence v3.0. Créditos: contiene datos de la Met Office con licencia Open Government Licence v3.0. Contiene datos de OS y ONS © Crown copyright and database right. Fuente: Met Office Climate Data Portal, proyecciones UKCP18 por autoridad local.

Not included

  • Carbon Intensity API (GB electricity, live and forecast)
  • API de contabilidad de Xero (el propio libro contable del cliente)
  • EXIOBASE 3, modelo input-output multirregional (factores de gasto para todos los países)
  • Factores de emisión de la IEA
  • ecoinvent
  • Factores de conversión y de emisión de SEAI (Irlanda), hoja GHG_elec (electricidad de 2001 a 2025)
  • Los factores de electricidad de otros países de DESNZ en su conjunto de 2021 y anteriores, elaborados a partir de datos de la IEA bajo la licencia propia de la IEA

Sus condiciones prohíben revender o redistribuir los datos, por lo que quedan fuera de la API. Consulte nuestra página de fuentes de datos para ver el registro completo.

Preguntas

¿Puedo probarlo antes de pagar?
Sí. Empiece la prueba gratuita de 14 días, abra Factor API en la aplicación y cree una clave. Las cuentas de prueba pueden hacer hasta 100 llamadas al mes para hacer pruebas.
¿Qué cuenta como una llamada?
Cada solicitud correcta con su clave. Las solicitudes que devuelven un error, como un ID de factor desconocido o un año del que no disponemos, no se cuentan. El recuento es común a todas las claves de su organización y se reinicia el día 1 de cada mes (UTC).
¿Qué ocurre si agotamos todas nuestras llamadas?
Las llamadas adicionales de ese mes reciben una respuesta 429 que indica cuándo se reinicia el recuento. Cada respuesta incluye las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset para que su código pueda anticiparlo. Puede pasar de Basic a Pro en cualquier momento.
¿Podemos mostrar las cifras a nuestros propios clientes?
Sí. Todas las fuentes que ofrecemos permiten la reutilización comercial. Muestre el texto de atribución que acompaña a cada respuesta allí donde aparezcan las cifras y no dé a entender que los editores respaldan su producto.
¿Por qué faltan algunas fuentes conocidas?
Solo ofrecemos datos cuya licencia nos permite redistribuirlos en un producto de pago. El flujo en directo de la red de Gran Bretaña de NESO, los factores de SEAI de Irlanda, EXIOBASE, IEA y ecoinvent tienen condiciones que lo impiden, por lo que no están en la API.
¿Con qué rapidez aparecen los nuevos factores?
DESNZ publica un nuevo conjunto para el Reino Unido cada junio. Añadimos cada nuevo conjunto, y las nuevas cifras por país, cuando se publican; el parámetro year mantiene estables las respuestas anteriores.
¿Necesito también un plan de Carbon Recycling?
Sí. Factor API es una suscripción independiente que se añade a cualquier plan de pago, con la misma permanencia mínima de 12 meses. Se factura aparte del plan.

Fuentes