Factor API: 귀사 소프트웨어를 위한 영국 및 국가별 공식 배출계수

이용 방법

1. 로그인한 뒤 앱에서 Factor API를 여십시오. 키를 생성하고 복사하십시오(키는 한 번만 표시됩니다).
2. 각 요청에 Authorization: Bearer crf_… 형식으로 함께 보내십시오.
3. data를 읽고, 수치가 표시되는 곳마다 attribution 문구를 표시하십시오.

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

키는 웹 페이지가 아닌 귀사 서버에 보관합니다. API는 읽기 전용(GET)이며 JSON으로 응답하고, 교차 출처 요청을 허용하며, 버전이 관리됩니다. 코드를 손상시킬 수 있는 변경은 v1이 아닌 새 버전에 적용됩니다.

엔드포인트 참조

기본 주소는 https://carbonrecycling.co.uk/api/v1입니다. GET /api/v1은 키 없이 엔드포인트와 출처 목록을 제공합니다. 영국 계수의 경우 year는 DESNZ 세트입니다(2002~2026, 기본값은 최신). 국가별 및 미국 지역별 전력의 경우 year는 보고 연도이며, 그 연도까지의 최신 데이터 연도로 응답합니다.

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

영국 전력(잔여 전원 믹스 포함)

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

국가

recommended는 당사 보고서와 같은 규칙을 따릅니다. Ember 수치가 1년 이상 더 최신이 아닌 한 해당 국가의 공식 수치를 사용합니다.

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

오류 및 한도

오류는 {"error": {"status", "code", "message"}} 형식으로 반환됩니다. 잘못된 매개변수는 400, 키가 없거나 폐기된 경우 401, 계정에 Factor API가 없는 경우 403(구독 링크 포함), 알 수 없는 계수·국가·엔드포인트는 404, 해당 월의 호출을 모두 사용한 경우 429입니다.

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

라이선스 및 출처 표시

유료 제품에서 재제공이 허용되는 라이선스의 데이터만 제공하며, 각 발행 기관의 약관 사본을 날짜와 함께 보관합니다. 모든 응답에는 근거 출처와 라이선스, 표시해야 할 출처 문구가 포함됩니다. 수치는 발표된 그대로 제공되며 보증하지 않습니다. 어떤 발행 기관도 Carbon Recycling이나 귀사 제품을 보증하지 않습니다.

• Department for Energy Security and Net Zero (DESNZ): 영국 정부 기업 보고용 온실가스 환산계수. Open Government Licence v3.0. 출처 표시: Open Government Licence v3.0에 따라 라이선스된 공공 부문 정보를 포함합니다. 출처: DESNZ, Greenhouse gas reporting: conversion factors.
• Defra and the University of Leeds: 지출 기반 배출 승수(영국의 탄소발자국). Open Government Licence v3.0. 출처 표시: Open Government Licence v3.0에 따라 라이선스된 공공 부문 정보를 포함합니다. 출처: Defra, UK's carbon footprint.
• HM Revenue & Customs (HMRC) and HM Treasury: 영국 CBAM 기본값 및 CBAM 세율. Open Government Licence v3.0. 출처 표시: Open Government Licence v3.0에 따라 라이선스된 공공 부문 정보를 포함합니다. 출처: HMRC, Check the default values for the Carbon Border Adjustment Mechanism (CBAM); HM Treasury 및 HMRC, Illustrative CBAM rates and worked example.
• Ember Energy Research CIC: Ember 연간 전력 데이터(국가별 전력망 집약도). 크리에이티브 커먼즈 저작자표시 4.0 국제. 출처 표시: CC BY 4.0에 따라 라이선스된 Ember 데이터를 포함합니다(ember-energy.org).
• US Environmental Protection Agency: EPA eGRID 및 GHG Emission Factors Hub(2025년판까지). US government work, public domain under 17 U.S.C. § 105. 출처 표시: 출처: US EPA, eGRID 및 GHG Emission Factors Hub. 법적 의무는 아니지만 출처를 표시합니다.
• 캐나다 환경·기후변화부: 캐나다 국가 인벤토리 보고서(National Inventory Report), 부속서 7 전력 집약도 표. Open Government Licence - Canada 2.0. 출처 표시: Open Government Licence – 캐나다에 따라 라이선스된 정보를 포함합니다(Environment and Climate Change 캐나다, National Inventory Report).
• Energy Market Authority, Singapore: 싱가포르 에너지시장청(Energy Market Authority) 전력망 배출계수(data.gov.sg). Singapore Open Data Licence version 1.0. 출처 표시: 2026년 10월 19일 data.gov.sg에서 접속한 Electricity Grid Emission Factors and Upstream Fugitive Methane Emission Factor의 정보를 포함하며, 이 정보는 싱가포르 Open Data Licence 버전 1.0(https://data.gov.sg/open-data-licence)의 조건에 따라 제공됩니다.
• ADEME (Agence de la transition écologique), France: ADEME Base Carbone(data.ademe.fr 공개본), 전력. Licence Ouverte / Open Licence 2.0 (Etalab). 출처 표시: Source: ADEME, Base Carbone® V23.6 (data.ademe.fr, 최종 업데이트 2025년 7월 3일), Licence Ouverte 2.0.
• Department of Climate Change, Energy, the Environment and Water (DCCEEW), Australia: 호주 국가 온실가스 계정 계수(National Greenhouse Accounts Factors, 2022~2026년판). 크리에이티브 커먼즈 저작자표시 4.0 국제. 출처 표시: DCCEEW 2026, Australian National Greenhouse Accounts Factors, Department of Climate Change, Energy, the Environment and Water, Canberra, August. CC BY 4.0. (이전 판도 각 연도를 붙여 같은 방식으로 표시합니다.)
• Cornerstone Sustainability Data Initiative: Emission Factors Hub 2026(eGRID2024 전력, AR6 GWP). 크리에이티브 커먼즈 저작자표시 4.0 국제. 출처 표시: 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): 연료 구성 공시 데이터 표(영국 잔여 연료 믹스). Open Government Licence v3.0. 출처 표시: Open Government Licence v3.0에 따라 라이선스된 공공 부문 정보를 포함합니다. 출처: DESNZ, Fuel mix disclosure data table.
• Umweltbundesamt (UBA), Germany: 독일 연방환경청(Umweltbundesamt): 독일 전력 믹스의 온실가스 배출 원단위 1990~2025년(Climate Change 16/2026). Umweltbundesamt data terms: data use permitted under § 12a EGovG, with UBA named as the source. 출처 표시: Quelle: Umweltbundesamt, Climate Change 16/2026, Entwicklung der spezifischen Treibhausgas-Emissionen des deutschen Strommix in den Jahren 1990 - 2025 (Tabelle 2). 수치는 Carbon Recycling이 kWh당 g에서 kg으로 환산했습니다.
• Ministry of Ecology and Environment (MEE) and National Bureau of Statistics, China: 생태환경부 및 국가통계국: 국가 전력 CO2 배출계수 2021~2023년. Official government notice, outside copyright under Article 5 of the Copyright Law of the People's Republic of China. 출처 표시: 출처: 중국 생태환경부 및 국가통계국, 공고 2024 No. 12, 2024 No. 33, 2025 No. 47(전국 평균 전력 CO2 배출계수).
• Ministry for the Environment, New Zealand (now part of the Ministry for Cities, Environment, Regions and Transport): 환경부(Ministry for the Environment, 뉴질랜드): Measuring emissions, 2026년 배출계수 v2(긴 형식 CSV), 구매 전력. 크리에이티브 커먼즈 저작자표시 4.0 국제. 출처 표시: Ministry for the Environment. 2026. Measuring emissions: A guide for organisations: 2026 emission factors (version 2). Crown copyright, CC BY 4.0에 따라 라이선스됨.
• Ideal Postcodes (service), serving ONS Postcode Directory, Ordnance Survey and National Records of Scotland data: Postcodes.io(우편번호 위치 조회, 그레이트브리튼 우편번호만 해당). Open Government Licence v3.0. 출처 표시: Ordnance Survey 데이터 © Crown copyright and database right를 포함합니다. Royal Mail 데이터 © Royal Mail copyright and database right를 포함합니다. National Statistics 데이터 © Crown copyright and database right를 포함합니다. NRS 데이터 © Crown copyright and database right를 포함합니다. 우편번호 조회: postcodes.io.
• Environment Agency: 환경청(Environment Agency) 실시간 홍수 모니터링 API(홍수 경보 및 주의 지역, 현재 경보). Open Government Licence v3.0. 출처 표시: Environment Agency의 실시간 데이터 API(Beta)에서 제공하는 홍수 및 하천 수위 데이터를 사용합니다.
• Environment Agency: 환경청(Environment Agency) 하천·해안 및 지표수 홍수 위험(NaFRA2), 현재 및 기후변화 시나리오, Defra WMS 경유. Open Government Licence v3.0. 출처 표시: © Environment Agency copyright and/or database right 2025. All rights reserved. Open Government Licence v3.0에 따라 라이선스된 공공 부문 정보를 포함합니다.
• Scottish Environment Protection Agency (SEPA): SEPA 홍수 지도(하천, 해안, 지표수 및 소하천, 현재 및 미래), 공개 지도 서비스. Open Government Licence v3.0. 출처 표시: ©SEPA 2025; 이 SEPA 제품은 Open Government Licence 버전 3.0에 따라 라이선스됩니다.
• Natural Resources Wales: Natural Resources Wales 웨일스 홍수 위험 평가(하천, 해안, 지표수 및 소하천)와 홍수 경보 지역, DataMapWales 경유. Open Government Licence v3.0. 출처 표시: Natural Resources Wales 정보 © Natural Resources Body for Wales and database right를 포함합니다. All rights reserved. 홍수 유량 추정치는 FEH 방법론 및 데이터에 기반합니다. © and database right UKCEH 2015. Ordnance Survey 데이터, Crown copyright and database right를 포함합니다. Open Government Licence v3.0에 따라 라이선스됩니다.
• Met Office: Met Office 기후 데이터 포털: 지구 온난화 수준별 UKCP18 지방자치단체 전망치(여름 고온일, 열대야, 여름 최고 기온, 여름 및 겨울 강수량). Open Government Licence v3.0. 출처 표시: Open Government Licence v3.0에 따라 라이선스된 Met Office 데이터를 포함합니다. OS 및 ONS 데이터 © Crown copyright and database right를 포함합니다. 출처: Met Office Climate Data Portal, UKCP18 지방자치단체 전망.

Not included

• Carbon Intensity API (GB electricity, live and forecast)
• Xero 회계 API(고객사 자체 원장)
• EXIOBASE 3 다지역 투입산출(모든 국가의 지출 계수)
• IEA 배출계수
• ecoinvent
• SEAI 환산 및 배출계수(아일랜드), GHG_elec 시트(전력 2001~2025)
• IEA 자체 라이선스에 따라 IEA 데이터로 작성된 DESNZ 2021년 및 그 이전 세트의 해외 전력 계수

해당 약관은 데이터의 재판매나 재배포를 금지하므로 API에서 제외됩니다. 전체 목록은 데이터 출처 페이지를 참고하십시오.