Climate TRACE

App · 15 actions

Look up independent estimates of greenhouse gas emissions from Climate TRACE, which tracks them with satellites and AI: totals for any country, state, county or city by year, month and sector, countries ranked, and the biggest emitting power plants, oil and gas fields, mines and other facilities, with who owns them. No account or API key required.

Actions

ActionWhat it does
Find top-emitting sourcesList the biggest emitters for a year, such as power plants, oil and gas fields, mines, steel mills or a county's road traffic, worldwide or in a country, state, city, continent or group, for a sector, subsector or owner.
Get country emissionsGet a country's emissions for a year: the total, its rank among all countries, its share of the world, emissions per person and the change on the year before, split by month, sector and subsector.
Get country emissions by yearGet a country's emissions year by year, with its world rank and emissions per person each year, the change from the first complete year to the last and its peak year.
Get emission sourceGet one source, such as a power plant or a mine: what it is, where, who owns it, its rank in its subsector worldwide, how confident Climate TRACE is, and its emissions, activity and capacity year by year or month by month.
Get emissions for a region, state or cityGet the emissions of a state, province, county, city, continent, group of countries or the whole world for a year, split by month, sector and subsector.
Get owner emissionsGet what the facilities a company (or other owner) owns emitted in a year, split by month, sector and subsector, worldwide or in one country.
Get subsectorGet what a subsector is part of, whether it is estimated source by source or only country by country, and which organisations produce its estimates.
List countriesList the countries and territories Climate TRACE covers, with their 3-letter codes, continent and the groups they belong to: all of them, or one continent's or group's.
List groups of countriesList the groups of countries rankings and totals can be narrowed to, such as the EU, the G20, OPEC and the least developed countries, with their members.
List sectors and subsectorsList the sectors Climate TRACE splits emissions into, such as Power and Agriculture, each with its subsectors and their ids.
List states, provinces or countiesList the states or provinces of a country, or the counties and districts of a state, with their ids.
Rank countries by emissionsRank countries by their emissions over a year or several years added up, worldwide, on one continent or in a group such as the EU or the G20, with each country's share, emissions per person and change on the period before.
Search citiesFind cities by name, in a country, or both, with the ids the emissions and source steps take.
Search ownersFind companies and other owners of emission sources by name, with the ids 'Get owner emissions' and 'Find top-emitting sources' take.
Search states, provinces and countiesFind states, provinces, counties, districts and countries by name, with the ids the emissions and source steps take.

Find top-emitting sources

List the biggest emitters for a year, such as power plants, oil and gas fields, mines, steel mills or a county's road traffic, worldwide or in a country, state, city, continent or group, for a sector, subsector or owner. Each has its emissions, location and, where published, its activity and capacity.

Inputs

Whereplace_typetext
Where to look.One of: world (Anywhere), country (A country), area (A state, province or county), city (A city), continent (A continent), country_group (A group of countries). Default: world.
Countrycountrytext
The country to look in.Only when Where is A country.
State, province or county idarea_idtext
The area's Climate TRACE id, from 'Search states, provinces and counties' or 'List states, provinces or counties'.Only when Where is A state, province or county.
City idcity_idtext
The city's Climate TRACE id, from 'Search cities'.Only when Where is A city.
Continentcontinenttext
The continent.Only when Where is A continent.
Group of countriescountry_grouptext
The group, such as the European Union, the G20 or OPEC.Only when Where is A group of countries.
Owner idowner_idtext
Only sources this owner owns, by its id from 'Search owners'. Leave empty for every owner.
Yearyearnumber
The year, 2021 or later (source-level data starts in 2021). Leave empty for last year, the latest complete one.From 2021 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.
Include forestry and land useinclude_forestrytrue/false
Also count forests, grassland and wetlands, which absorb and release carbon and can swing a total by billions of tonnes. Off matches the totals on climatetrace.org. Only used when no sector is picked.Default: false.
Number of sourceslimitnumber
How many sources to list, biggest first, at most 500.From 1 to 500. Default: 20.
Skipoffsetnumber
How many results to skip, for the next page: use next_offset from the previous answer. Leave empty for the first page.At least 0. Default: 0.

Outputs

countnumber
How many sources are listed.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
includes_forestrytrue/false
Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
next_offsetnumber
The Skip value for the next page, or null when this is the last.
offsetnumber
How many sources were skipped.
owner_idslist
The owner ids the search was limited to.
place_idtext
The id of the place searched, or null for the whole world.
place_nametext
The place searched, or null for the whole world.
place_typetext
world, country, area, city, continent or country_group.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
sourceslist
The sources, biggest emitter first.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
yearnumber
The year ranked.
Example output
{
  "count": 2,
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "includes_forestry": false,
  "next_offset": 2,
  "offset": 0,
  "owner_ids": [],
  "place_id": "USA",
  "place_name": "United States of America",
  "place_type": "country",
  "sector": "power",
  "sector_name": "Power",
  "sources": [
    {
      "activity": 19490000,
      "activity_units": "MWh",
      "asset_type": "coal",
      "capacity": 2822,
      "capacity_units": "MW",
      "country": "USA",
      "emissions_factor": 0.9473,
      "emissions_factor_units": "t of CO2e_100yr per MWh",
      "latitude": 33.6319,
      "longitude": -87.0597,
      "name": "James H Miller Jr",
      "rank": 1,
      "sector": "power",
      "source_id": 25448871,
      "source_type": "point-source",
      "subsector": "electricity-generation",
      "subsector_name": "Electricity generation",
      "tonnes": 18463000,
      "url": "https://climatetrace.org/explore/#admin=&gas=co2e&year=2024&timeframe=100&sector=&asset=25448871",
      "year": 2024
    },
    {
      "activity": 15042500,
      "activity_units": "MWh",
      "asset_type": "coal",
      "capacity": 2389.4,
      "capacity_units": "MW",
      "country": "USA",
      "emissions_factor": 0.9544,
      "emissions_factor_units": "t of CO2e_100yr per MWh",
      "latitude": 38.5622,
      "longitude": -90.8377,
      "name": "Labadie",
      "rank": 2,
      "sector": "power",
      "source_id": 25449255,
      "source_type": "point-source",
      "subsector": "electricity-generation",
      "subsector_name": "Electricity generation",
      "tonnes": 14357000,
      "url": "https://climatetrace.org/explore/#admin=&gas=co2e&year=2024&timeframe=100&sector=&asset=25449255",
      "year": 2024
    }
  ],
  "subsector": null,
  "subsector_name": null,
  "year": 2024
}

Get country emissions

Get a country's emissions for a year: the total, its rank among all countries, its share of the world, emissions per person and the change on the year before, split by month, sector and subsector. Narrow it to one gas, sector or subsector.

Inputs

CountrycountrytextRequired
The country, from Climate TRACE's list. A 3-letter code such as USA, or a country name from an earlier step, works too.
Yearyearnumber
The year, 2015 or later. Leave empty for last year, the latest complete one. This year works too, with the months published so far.From 2015 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.
Include forestry and land useinclude_forestrytrue/false
Also count forests, grassland and wetlands, which absorb and release carbon and can swing a total by billions of tonnes. Off matches the totals on climatetrace.org. Only used when no sector is picked.Default: false.

Outputs

change_percentnumber
Percent change from the year before, as Climate TRACE works it out, or null while the year is still being published.
complete_yeartrue/false
Whether all 12 months are published.
continenttext
The continent it is on.
countrytext
The country's 3-letter code.
country_nametext
The country's name.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
includes_forestrytrue/false
Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
monthlylist
Emissions month by month, oldest first.
months_reportednumber
How many months of the year are published (12 for a complete year).
per_capita_tonnesnumber
Emissions per person in tonnes.
ranked_countriesnumber
How many countries were ranked.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
sectorslist
The total split by sector, biggest first.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
subsectorslist
The total split by subsector, biggest first.
total_tonnesnumber
Total emissions for the year in tonnes, or null when no month is published yet.
urltext
The figures on the climatetrace.org map.
world_ranknumber
The country's rank among all countries (1 emits most).
world_share_percentnumber
The country's share of the world total, in percent.
yearnumber
The year the figures are for.
Example output
{
  "change_percent": -3.81,
  "complete_year": true,
  "continent": "North America",
  "country": "USA",
  "country_name": "United States of America",
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "includes_forestry": false,
  "monthly": [
    {
      "month": "2024-01",
      "tonnes": 603815028.59
    },
    {
      "month": "2024-02",
      "tonnes": 528697423.93
    },
    {
      "month": "2024-03",
      "tonnes": 536744453.67
    }
  ],
  "months_reported": 12,
  "per_capita_tonnes": 19.95,
  "ranked_countries": 252,
  "sector": null,
  "sector_name": null,
  "sectors": [
    {
      "name": "Transportation",
      "sector": "transportation",
      "share_percent": 29.85,
      "tonnes": 1974399523.55
    },
    {
      "name": "Power",
      "sector": "power",
      "share_percent": 23.66,
      "tonnes": 1564413046.52
    },
    {
      "name": "Fossil fuel operations",
      "sector": "fossil-fuel-operations",
      "share_percent": 15.32,
      "tonnes": 1013392405.73
    }
  ],
  "subsector": null,
  "subsector_name": null,
  "subsectors": [
    {
      "name": "Road transportation",
      "sector": "transportation",
      "share_percent": 23.78,
      "subsector": "road-transportation",
      "tonnes": 1572404952.7
    },
    {
      "name": "Electricity generation",
      "sector": "power",
      "share_percent": 23.55,
      "subsector": "electricity-generation",
      "tonnes": 1557406600
    },
    {
      "name": "Oil and gas production",
      "sector": "fossil-fuel-operations",
      "share_percent": 7.9,
      "subsector": "oil-and-gas-production",
      "tonnes": 522380032.97
    }
  ],
  "total_tonnes": 6613431205.68,
  "url": "https://climatetrace.org/explore/#admin=United%20States%20of%20America:country:USA&gas=co2e&year=2024&timeframe=100&sector=&asset=",
  "world_rank": 2,
  "world_share_percent": 11.49,
  "year": 2024
}

Get country emissions by year

Get a country's emissions year by year, with its world rank and emissions per person each year, the change from the first complete year to the last and its peak year. Covers the last 10 years unless you pick others.

Inputs

CountrycountrytextRequired
The country, from Climate TRACE's list. A 3-letter code such as USA, or a country name from an earlier step, works too.
From yearfrom_yearnumber
The first year, 2015 or later. Leave empty for the 10 years up to To year.From 2015 to 2026.
To yearto_yearnumber
The last year. Leave empty for the same year as From year (or last year when both are empty).From 2015 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.
Include forestry and land useinclude_forestrytrue/false
Also count forests, grassland and wetlands, which absorb and release carbon and can swing a total by billions of tonnes. Off matches the totals on climatetrace.org. Only used when no sector is picked.Default: false.

Outputs

change_from_yearnumber
The first year that change is measured from.
change_percentnumber
Percent change from the first complete year listed to the last, or null with fewer than two complete years.
change_to_yearnumber
The last year that change is measured to.
countrytext
The country's 3-letter code.
country_nametext
The country's name.
data_throughtext
The last month published (YYYY-MM) when the last year is not complete yet, otherwise null.
from_yearnumber
The first year.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
includes_forestrytrue/false
Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
peak_tonnesnumber
That year's emissions in tonnes.
peak_yearnumber
The complete year with the highest emissions.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
to_yearnumber
The last year.
urltext
The figures on the climatetrace.org map.
year_countnumber
How many years are listed.
yearslist
Each year's figures, oldest first.
Example output
{
  "change_from_year": 2020,
  "change_percent": -8.56,
  "change_to_year": 2025,
  "country": "DEU",
  "country_name": "Germany",
  "data_through": "2026-07",
  "from_year": 2020,
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "includes_forestry": false,
  "peak_tonnes": 840830166.71,
  "peak_year": 2021,
  "sector": null,
  "sector_name": null,
  "subsector": null,
  "subsector_name": null,
  "to_year": 2026,
  "url": "https://climatetrace.org/explore/#admin=Germany:country:DEU&gas=co2e&year=2026&timeframe=100&sector=&asset=",
  "year_count": 7,
  "years": [
    {
      "change_percent": -0.15,
      "partial_year": false,
      "per_capita_tonnes": 9.623,
      "tonnes": 800295698.18,
      "world_rank": 11,
      "world_share_percent": 1.51,
      "year": 2020
    },
    {
      "change_percent": -0.65,
      "partial_year": false,
      "per_capita_tonnes": 10.11,
      "tonnes": 840830166.71,
      "world_rank": 10,
      "world_share_percent": 1.51,
      "year": 2021
    },
    {
      "change_percent": -1.37,
      "partial_year": false,
      "per_capita_tonnes": 9.914,
      "tonnes": 824416734.16,
      "world_rank": 11,
      "world_share_percent": 1.47,
      "year": 2022
    },
    {
      "change_percent": -4.65,
      "partial_year": false,
      "per_capita_tonnes": 8.948,
      "tonnes": 744107930.93,
      "world_rank": 13,
      "world_share_percent": 1.3,
      "year": 2023
    },
    {
      "change_percent": -1.6,
      "partial_year": false,
      "per_capita_tonnes": 8.871,
      "tonnes": 737723076.58,
      "world_rank": 13,
      "world_share_percent": 1.28,
      "year": 2024
    },
    {
      "change_percent": -4.3,
      "partial_year": false,
      "per_capita_tonnes": 8.8,
      "tonnes": 731827766.53,
      "world_rank": 13,
      "world_share_percent": 1.27,
      "year": 2025
    },
    {
      "change_percent": null,
      "partial_year": true,
      "per_capita_tonnes": 5.162,
      "tonnes": 429308874.01,
      "world_rank": 13,
      "world_share_percent": 1.27,
      "year": 2026
    }
  ]
}

Get emission source

Get one source, such as a power plant or a mine: what it is, where, who owns it, its rank in its subsector worldwide, how confident Climate TRACE is, and its emissions, activity and capacity year by year or month by month.

Inputs

Source idsource_idtextRequired
The source's Climate TRACE id, from 'Find top-emitting sources'.
From yearfrom_yearnumber
The first year, 2021 or later. Leave empty for 2021.From 2021 to 2026.
To yearto_yearnumber
The last year. Leave empty for this year, with the months published so far.From 2021 to 2026.
Figures forgranularitytext
One row per year, or per month.One of: year (Each year), month (Each month). Default: year.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.

Outputs

asset_typetext
What kind of source it is.
confidenceobject
How confident Climate TRACE is in the latest year's figures: very low, low, medium, high or very high.
countrytext
The 3-letter code of the country it is in.
emissionslist
Figures for each year or month, oldest first.
foundtrue/false
Whether Climate TRACE has a source with this id.
from_yearnumber
The first year covered.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
granularitytext
year or month.
latitudenumber
Latitude of the source.
longitudenumber
Longitude of the source.
nametext
The source's name.
ownerslist
Who owns it.
sectortext
The sector's id.
source_idnumber
The source's Climate TRACE id.
source_typetext
point-source for a facility; otherwise an area's total.
subsectortext
The subsector's id.
subsector_nametext
The subsector in words.
subsector_rankslist
Its rank among every source in its subsector worldwide, by year.
to_yearnumber
The last year covered.
total_tonnesnumber
Emissions over the whole period in tonnes.
urltext
The figures on the climatetrace.org map.
Example output
{
  "asset_type": "coal",
  "confidence": {
    "activity": "high",
    "capacity": "high",
    "ch4": "very low",
    "co2": "high",
    "emissions": "high",
    "n2o": "very low",
    "year": 2026
  },
  "country": "USA",
  "emissions": [
    {
      "activity": 21395000,
      "activity_units": "MWh",
      "capacity": 2822,
      "capacity_units": "MW",
      "emissions_factor": 0.9473,
      "emissions_factor_units": "t of CO2e_100yr per MWh",
      "month": null,
      "period": "2021",
      "tonnes": 20267000,
      "year": 2021
    },
    {
      "activity": 21917000,
      "activity_units": "MWh",
      "capacity": 2822,
      "capacity_units": "MW",
      "emissions_factor": 0.9473,
      "emissions_factor_units": "t of CO2e_100yr per MWh",
      "month": null,
      "period": "2022",
      "tonnes": 20763000,
      "year": 2022
    },
    {
      "activity": 16758000,
      "activity_units": "MWh",
      "capacity": 2822,
      "capacity_units": "MW",
      "emissions_factor": 0.9473,
      "emissions_factor_units": "t of CO2e_100yr per MWh",
      "month": null,
      "period": "2023",
      "tonnes": 15875000,
      "year": 2023
    }
  ],
  "found": true,
  "from_year": 2021,
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "granularity": "year",
  "latitude": 33.6319,
  "longitude": -87.0597,
  "name": "James H Miller Jr",
  "owners": [
    {
      "name": "Alabama Power Co",
      "owner_id": "E100000002418"
    }
  ],
  "sector": "power",
  "source_id": 25448871,
  "source_type": "point-source",
  "subsector": "electricity-generation",
  "subsector_name": "Electricity generation",
  "subsector_ranks": [
    {
      "rank": 30,
      "year": 2021
    },
    {
      "rank": 24,
      "year": 2022
    },
    {
      "rank": 77,
      "year": 2023
    }
  ],
  "to_year": 2026,
  "total_tonnes": 104386000,
  "url": "https://climatetrace.org/explore/#admin=&gas=co2e&year=2026&timeframe=100&sector=&asset=25448871"
}

Get emissions for a region, state or city

Get the emissions of a state, province, county, city, continent, group of countries or the whole world for a year, split by month, sector and subsector. States, counties and cities start in 2021.

Inputs

Whereplace_typetextRequired
The kind of place.One of: area (A state, province or county), city (A city), continent (A continent), country_group (A group of countries), world (The whole world).
State, province or county idarea_idtext
The area's Climate TRACE id, from 'Search states, provinces and counties' or 'List states, provinces or counties'.Only when Where is A state, province or county.
City idcity_idtext
The city's Climate TRACE id, from 'Search cities'.Only when Where is A city.
Continentcontinenttext
The continent.Only when Where is A continent.
Group of countriescountry_grouptext
The group, such as the European Union, the G20 or OPEC.Only when Where is A group of countries.
Yearyearnumber
The year: 2015 or later, or 2021 or later for a state, county or city. Leave empty for last year, the latest complete one. This year works too, with the months published so far.From 2015 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.
Include forestry and land useinclude_forestrytrue/false
Also count forests, grassland and wetlands, which absorb and release carbon and can swing a total by billions of tonnes. Off matches the totals on climatetrace.org. Only used when no sector is picked.Default: false.

Outputs

complete_yeartrue/false
Whether all 12 months are published.
countrytext
The 3-letter code of the country a state or city is in.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
includes_forestrytrue/false
Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
monthlylist
Emissions month by month, oldest first.
months_reportednumber
How many months of the year are published (12 for a complete year).
place_idtext
The place's id: an area id, a city id, a continent or a group.
place_nametext
The place's name.
place_typetext
area, city, continent, country_group or world.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
sectorslist
The total split by sector, biggest first.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
subsectorslist
The total split by subsector, biggest first.
total_tonnesnumber
Total emissions for the year in tonnes, or null when no month is published yet.
urltext
The figures on the climatetrace.org map.
yearnumber
The year the figures are for.
Example output
{
  "complete_year": true,
  "country": "USA",
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "includes_forestry": false,
  "monthly": [
    {
      "month": "2024-01",
      "tonnes": 40963533.8
    },
    {
      "month": "2024-02",
      "tonnes": 37974996.49
    },
    {
      "month": "2024-03",
      "tonnes": 38891264.2
    }
  ],
  "months_reported": 12,
  "place_id": "USA.5_1",
  "place_name": "California State",
  "place_type": "area",
  "sector": null,
  "sector_name": null,
  "sectors": [
    {
      "name": "Transportation",
      "sector": "transportation",
      "share_percent": 46.79,
      "tonnes": 216118361.93
    },
    {
      "name": "Buildings",
      "sector": "buildings",
      "share_percent": 12.63,
      "tonnes": 58350537.8
    },
    {
      "name": "Power",
      "sector": "power",
      "share_percent": 9.69,
      "tonnes": 44742977.07
    }
  ],
  "subsector": null,
  "subsector_name": null,
  "subsectors": [
    {
      "name": "Road transportation",
      "sector": "transportation",
      "share_percent": 34.46,
      "subsector": "road-transportation",
      "tonnes": 159173230.44
    },
    {
      "name": "Electricity generation",
      "sector": "power",
      "share_percent": 9.58,
      "subsector": "electricity-generation",
      "tonnes": 44248142.69
    },
    {
      "name": "Residential onsite fuel use",
      "sector": "buildings",
      "share_percent": 7.45,
      "subsector": "residential-onsite-fuel-usage",
      "tonnes": 34399215.61
    }
  ],
  "total_tonnes": 461937423.48,
  "url": "https://climatetrace.org/explore/#admin=California%20State:state:USA.5_1&gas=co2e&year=2024&timeframe=100&sector=&asset=",
  "year": 2024
}

Get owner emissions

Get what the facilities a company (or other owner) owns emitted in a year, split by month, sector and subsector, worldwide or in one country. Find owner ids with 'Search owners'.

Inputs

Owner idowner_idtextRequired
The owner's Climate TRACE id, from 'Search owners'. Several ids separated by commas are added together.
Yearyearnumber
The year, 2021 or later (source-level data starts in 2021). Leave empty for last year, the latest complete one.From 2021 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Countrycountrytext
Only results in this country. Leave empty for every country.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.

Outputs

complete_yeartrue/false
Whether all 12 months are published.
countrytext
The 3-letter code of the country the figures are limited to.
country_nametext
That country's name.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
monthlylist
Emissions month by month, oldest first.
months_reportednumber
How many months of the year are published (12 for a complete year).
ownerslist
The owners whose sources are added up.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
sectorslist
The total split by sector, biggest first.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
subsectorslist
The total split by subsector, biggest first.
total_tonnesnumber
Total emissions for the year in tonnes, or null when no month is published yet.
urltext
The owner on the climatetrace.org map, when there is one owner.
yearnumber
The year the figures are for.
Example output
{
  "complete_year": true,
  "country": null,
  "country_name": null,
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "monthly": [
    {
      "month": "2024-01",
      "tonnes": 5942790.34
    },
    {
      "month": "2024-02",
      "tonnes": 5909443.83
    },
    {
      "month": "2024-03",
      "tonnes": 5812497.13
    }
  ],
  "months_reported": 12,
  "owners": [
    {
      "name": "Shell PLC",
      "owner_id": "E100000000746"
    }
  ],
  "sector": null,
  "sector_name": null,
  "sectors": [
    {
      "name": "Fossil fuel operations",
      "sector": "fossil-fuel-operations",
      "share_percent": 83.64,
      "tonnes": 59802497.89
    },
    {
      "name": "Manufacturing",
      "sector": "manufacturing",
      "share_percent": 14.79,
      "tonnes": 10572575.72
    },
    {
      "name": "Power",
      "sector": "power",
      "share_percent": 1.57,
      "tonnes": 1122198
    }
  ],
  "subsector": null,
  "subsector_name": null,
  "subsectors": [
    {
      "name": "Oil and gas production",
      "sector": "fossil-fuel-operations",
      "share_percent": 44,
      "subsector": "oil-and-gas-production",
      "tonnes": 31455379.13
    },
    {
      "name": "Oil and gas refining",
      "sector": "fossil-fuel-operations",
      "share_percent": 25.93,
      "subsector": "oil-and-gas-refining",
      "tonnes": 18540148.26
    },
    {
      "name": "Petrochemical steam cracking",
      "sector": "manufacturing",
      "share_percent": 14.79,
      "subsector": "petrochemical-steam-cracking",
      "tonnes": 10572575.72
    }
  ],
  "total_tonnes": 71497271.61,
  "url": "https://climatetrace.org/explore/#admin=Shell%20PLC:owner:E100000000746&gas=co2e&year=2024&timeframe=100&sector=&asset=",
  "year": 2024
}

Get subsector

Get what a subsector is part of, whether it is estimated source by source or only country by country, and which organisations produce its estimates.

Inputs

SubsectorsubsectortextRequired
The subsector.

Outputs

data_providerslist
The organisations whose models or data produce its estimates.
foundtrue/false
Whether Climate TRACE has a subsector with this id.
has_country_datatrue/false
Whether it is estimated country by country.
has_source_datatrue/false
Whether it is estimated source by source (facilities or local areas).
nametext
The subsector in words.
sectortext
The sector it belongs to.
sector_nametext
That sector in words.
subsectortext
The subsector's id.
Example output
{
  "data_providers": [
    {
      "name": "WattTime",
      "url": "https://www.watttime.org/"
    },
    {
      "name": "TransitionZero",
      "url": "https://www.transitionzero.org/"
    },
    {
      "name": "Global Energy Monitor",
      "url": "https://globalenergymonitor.org/"
    }
  ],
  "found": true,
  "has_country_data": true,
  "has_source_data": true,
  "name": "Electricity generation",
  "sector": "power",
  "sector_name": "Power",
  "subsector": "electricity-generation"
}

List countries

List the countries and territories Climate TRACE covers, with their 3-letter codes, continent and the groups they belong to: all of them, or one continent's or group's.

Inputs

Continentcontinenttext
Only countries on this continent.
Group of countriescountry_grouptext
Only countries in this group, such as the G7.

Outputs

continenttext
The continent the list was limited to, or null.
countnumber
How many countries are listed.
countrieslist
The countries and territories, by name.
country_grouptext
The group the list was limited to, or null.
country_group_nametext
That group in words, or null.
Example output
{
  "continent": null,
  "count": 3,
  "countries": [
    {
      "continent": "North America",
      "country": "CAN",
      "groups": [
        "g20",
        "g7",
        "oecd",
        "oif",
        "umbrella_group",
        "unfccc_annex1"
      ],
      "name": "Canada",
      "url": "https://climatetrace.org/explore/#admin=Canada:country:CAN&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "continent": "Europe",
      "country": "FRA",
      "groups": [
        "eu",
        "g20",
        "g7",
        "oecd",
        "oif",
        "unfccc_annex1"
      ],
      "name": "France",
      "url": "https://climatetrace.org/explore/#admin=France:country:FRA&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "continent": "Europe",
      "country": "DEU",
      "groups": [
        "eu",
        "g20",
        "g7",
        "oecd",
        "unfccc_annex1"
      ],
      "name": "Germany",
      "url": "https://climatetrace.org/explore/#admin=Germany:country:DEU&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ],
  "country_group": "g7",
  "country_group_name": "G7"
}

List groups of countries

List the groups of countries rankings and totals can be narrowed to, such as the EU, the G20, OPEC and the least developed countries, with their members.

Inputs

None.

Outputs

countnumber
How many groups there are.
groupslist
Every group, by name.
Example output
{
  "count": 2,
  "groups": [
    {
      "countries": [
        "CHL",
        "COL",
        "CRI",
        "GTM",
        "HND",
        "PAN",
        "PER",
        "PRY"
      ],
      "country_count": 8,
      "country_names": [
        "Chile",
        "Colombia",
        "Costa Rica",
        "Guatemala",
        "Honduras",
        "Panama",
        "Paraguay",
        "Peru"
      ],
      "group": "ailac",
      "name": "AILAC (Latin America and the Caribbean)"
    },
    {
      "countries": [
        "ATG",
        "BHS",
        "BLZ",
        "BRB",
        "COK",
        "COM",
        "CPV",
        "CUB",
        "DMA",
        "DOM",
        "FJI",
        "FSM",
        "GNB",
        "GRD",
        "GUY",
        "HTI",
        "JAM",
        "KIR",
        "KNA",
        "LCA",
        "MDV",
        "MHL",
        "MUS",
        "NIU",
        "NRU",
        "PLW",
        "PNG",
        "SGP",
        "SLB",
        "STP",
        "SUR",
        "SYC",
        "TLS",
        "TON",
        "TTO",
        "TUV",
        "VCT",
        "VUT",
        "WSM"
      ],
      "country_count": 39,
      "country_names": [
        "Antigua and Barbuda",
        "Bahamas",
        "Barbados",
        "Belize",
        "Cabo Verde",
        "Comoros",
        "Cook Islands",
        "Cuba",
        "Dominica",
        "Dominican Republic",
        "Fiji",
        "Grenada",
        "Guinea-Bissau",
        "Guyana",
        "Haiti",
        "Jamaica",
        "Kiribati",
        "Maldives",
        "Marshall Islands",
        "Mauritius",
        "Micronesia (Federated States of)",
        "Nauru",
        "Niue",
        "Palau",
        "Papua New Guinea",
        "Saint Kitts and Nevis",
        "Saint Lucia",
        "Saint Vincent and the Grenadines",
        "Samoa",
        "Sao Tome and Principe",
        "Seychelles",
        "Singapore",
        "Solomon Islands",
        "Suriname",
        "Timor-Leste",
        "Tonga",
        "Trinidad and Tobago",
        "Tuvalu",
        "Vanuatu"
      ],
      "group": "aosis",
      "name": "AOSIS (Alliance of Small Island States)"
    }
  ]
}

List sectors and subsectors

List the sectors Climate TRACE splits emissions into, such as Power and Agriculture, each with its subsectors and their ids.

Inputs

None.

Outputs

sector_countnumber
How many sectors there are.
sectorslist
Every sector.
subsector_countnumber
How many subsectors there are.
Example output
{
  "sector_count": 2,
  "sectors": [
    {
      "name": "Agriculture",
      "sector": "agriculture",
      "subsector_count": 12,
      "subsectors": [
        {
          "name": "Crop residues",
          "subsector": "crop-residues"
        },
        {
          "name": "Cropland fires",
          "subsector": "cropland-fires"
        },
        {
          "name": "Enteric fermentation (cattle feedlots)",
          "subsector": "enteric-fermentation-cattle-operation"
        },
        {
          "name": "Enteric fermentation (cattle pasture)",
          "subsector": "enteric-fermentation-cattle-pasture"
        },
        {
          "name": "Enteric fermentation (other)",
          "subsector": "enteric-fermentation-other"
        },
        {
          "name": "Manure applied to soils",
          "subsector": "manure-applied-to-soils"
        },
        {
          "name": "Manure left on pasture (cattle)",
          "subsector": "manure-left-on-pasture-cattle"
        },
        {
          "name": "Manure management (cattle feedlots)",
          "subsector": "manure-management-cattle-operation"
        },
        {
          "name": "Manure management (other)",
          "subsector": "manure-management-other"
        },
        {
          "name": "Other agricultural soil emissions",
          "subsector": "other-agricultural-soil-emissions"
        },
        {
          "name": "Rice cultivation",
          "subsector": "rice-cultivation"
        },
        {
          "name": "Synthetic fertilizer application",
          "subsector": "synthetic-fertilizer-application"
        }
      ]
    },
    {
      "name": "Buildings",
      "sector": "buildings",
      "subsector_count": 3,
      "subsectors": [
        {
          "name": "Non-residential onsite fuel use",
          "subsector": "non-residential-onsite-fuel-usage"
        },
        {
          "name": "Other onsite fuel use",
          "subsector": "other-onsite-fuel-usage"
        },
        {
          "name": "Residential onsite fuel use",
          "subsector": "residential-onsite-fuel-usage"
        }
      ]
    }
  ],
  "subsector_count": 15
}

List states, provinces or counties

List the states or provinces of a country, or the counties and districts of a state, with their ids.

Inputs

Country or statearea_idtextRequired
Pick a country for its states or provinces, or type a state's id (such as USA.5_1 for California) for its counties.

Outputs

area_idtext
The id of the area split up.
area_nametext
Its name.
countnumber
How many subdivisions are listed.
foundtrue/false
Whether Climate TRACE has an area with this id.
levelnumber
Its level: 0 for a country, 1 for a state or province.
subdivisionslist
The areas one level down, by name.
Example output
{
  "area_id": "USA.5_1",
  "area_name": "California State, USA",
  "count": 3,
  "found": true,
  "level": 1,
  "subdivisions": [
    {
      "area_id": "USA.5.1_1",
      "country": "USA",
      "full_name": "Alameda County, California State, USA",
      "level": 2,
      "level_name": "county or district",
      "name": "Alameda County",
      "state_id": "USA.5_1",
      "url": "https://climatetrace.org/explore/#admin=Alameda%20County:county:USA.5.1_1&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "area_id": "USA.5.2_1",
      "country": "USA",
      "full_name": "Alpine County, California State, USA",
      "level": 2,
      "level_name": "county or district",
      "name": "Alpine County",
      "state_id": "USA.5_1",
      "url": "https://climatetrace.org/explore/#admin=Alpine%20County:county:USA.5.2_1&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "area_id": "USA.5.3_1",
      "country": "USA",
      "full_name": "Amador County, California State, USA",
      "level": 2,
      "level_name": "county or district",
      "name": "Amador County",
      "state_id": "USA.5_1",
      "url": "https://climatetrace.org/explore/#admin=Amador%20County:county:USA.5.3_1&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ]
}

Rank countries by emissions

Rank countries by their emissions over a year or several years added up, worldwide, on one continent or in a group such as the EU or the G20, with each country's share, emissions per person and change on the period before. Narrow it to a gas, sector or subsector, or to the countries you want to compare.

Inputs

Countries to rankregiontext
Rank every country, or the countries of one continent or group.One of: world (Every country), continent (Countries in a continent), country_group (Countries in a group). Default: world.
Continentcontinenttext
The continent whose countries to rank.Only when Countries to rank is Countries in a continent.
Group of countriescountry_grouptext
The group whose countries to rank, such as the European Union or the G20.Only when Countries to rank is Countries in a group.
From yearfrom_yearnumber
The first year to add up, 2015 or later. Leave empty for the same year as To year.From 2015 to 2026.
To yearto_yearnumber
The last year. Leave empty for the same year as From year (or last year when both are empty).From 2015 to 2026.
Gasgastext
What to measure. CO2e adds all greenhouse gases up by how much they warm the planet over 100 (or 20) years; the air pollutants are in tonnes of that pollutant. Leave empty for CO2e (100-year).One of: co2e_100yr (All greenhouse gases as CO2e (100-year)), co2e_20yr (All greenhouse gases as CO2e (20-year)), co2 (Carbon dioxide (CO2)), ch4 (Methane (CH4)), n2o (Nitrous oxide (N2O)), pm2_5 (Fine particulate matter (PM2.5)), so2 (Sulfur dioxide (SO2)), nox (Nitrogen oxides (NOx)), co (Carbon monoxide (CO)), nh3 (Ammonia (NH3)), and 3 more. Default: co2e_100yr.
Sectorsectortext
Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
Subsectorsubsectortext
Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.
Include forestry and land useinclude_forestrytrue/false
Also count forests, grassland and wetlands, which absorb and release carbon and can swing a total by billions of tonnes. Off matches the totals on climatetrace.org. Only used when no sector is picked.Default: false.
Only these countriescountriestext
To compare a few countries, their 3-letter codes or names separated by commas. They keep their rank among all the countries ranked. Leave empty for every country.
Number of countrieslimitnumber
How many countries to list, biggest emitter first, at most 300.From 1 to 300. Default: 20.

Outputs

countrieslist
The countries, biggest emitter first.
country_countnumber
How many countries the region has.
data_throughtext
The last month published (YYYY-MM) when the period runs past it, otherwise null.
from_yearnumber
The first year added up.
gastext
The gas the figures are for, as Climate TRACE names it: co2e_100yr, co2e_20yr, co2, ch4, n2o or an air pollutant such as pm2_5.
gas_nametext
The gas in words.
includes_forestrytrue/false
Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
period_endtext
The last day of the period, YYYY-MM-DD.
period_starttext
The first day of the period, YYYY-MM-DD.
regiontext
world, continent or country_group.
region_nametext
The region ranked, in words.
returned_countnumber
How many countries are listed.
sectortext
The sector the figures are narrowed to, or null for all.
sector_nametext
That sector in words, or null.
subsectortext
The subsector the figures are narrowed to, or null.
subsector_nametext
That subsector in words, or null.
to_yearnumber
The last year added up.
total_tonnesnumber
The region's total over the period in tonnes.
Example output
{
  "countries": [
    {
      "change_percent": -2.14,
      "country": "CHN",
      "country_name": "China",
      "per_capita_tonnes": 12.18,
      "rank": 1,
      "share_percent": 29.74,
      "tonnes": 17185385076.71,
      "url": "https://climatetrace.org/explore/#admin=China:country:CHN&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "change_percent": -4.19,
      "country": "USA",
      "country_name": "United States of America",
      "per_capita_tonnes": 20.09,
      "rank": 2,
      "share_percent": 11.52,
      "tonnes": 6660445874.13,
      "url": "https://climatetrace.org/explore/#admin=United%20States%20of%20America:country:USA&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "change_percent": -0.58,
      "country": "IND",
      "country_name": "India",
      "per_capita_tonnes": 3.031,
      "rank": 3,
      "share_percent": 7.24,
      "tonnes": 4182325248.9,
      "url": "https://climatetrace.org/explore/#admin=India:country:IND&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ],
  "country_count": 252,
  "data_through": null,
  "from_year": 2025,
  "gas": "co2e_100yr",
  "gas_name": "All greenhouse gases as CO2e (100-year)",
  "includes_forestry": false,
  "period_end": "2025-12-31",
  "period_start": "2025-01-01",
  "region": "world",
  "region_name": "The world",
  "returned_count": 3,
  "sector": null,
  "sector_name": null,
  "subsector": null,
  "subsector_name": null,
  "to_year": 2025,
  "total_tonnes": 57793624726.54
}

Search cities

Find cities by name, in a country, or both, with the ids the emissions and source steps take. A city is its whole urban area, towns around it included.

Inputs

Namenametext
All or part of the city's name, in English. Leave empty to list a country's cities.
Countrycountrytext
Only results in this country. Leave empty for every country.
Number of resultslimitnumber
How many results to return, at most 100.From 1 to 100. Default: 20.
Skipoffsetnumber
How many results to skip, for the next page: use next_offset from the previous answer. Leave empty for the first page.At least 0. Default: 0.

Outputs

citieslist
The matching cities.
countnumber
How many cities are listed.
countrytext
The country searched in, or null.
nametext
The name searched for, or null.
next_offsetnumber
The Skip value for the next page, or null when this is the last.
offsetnumber
How many cities were skipped.
Example output
{
  "cities": [
    {
      "city_id": "ghs-fua_2220",
      "country": "CAN",
      "name": "London Urban Area",
      "other_names": [
        "London"
      ],
      "url": "https://climatetrace.org/explore/#admin=London%20Urban%20Area:city:ghs-fua_2220&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "city_id": "ghs-fua_5288",
      "country": "GBR",
      "name": "London Urban Area",
      "other_names": [
        "Chatham",
        "Strood",
        "Rochester",
        "Gillingham",
        "Walderslade",
        "London",
        "Westminster",
        "City of London",
        "Slough",
        "Windsor",
        "Eton",
        "Redhill",
        "Reigate",
        "Hemel Hempstead",
        "Kings Langley",
        "Crawley",
        "Horley",
        "Harlow",
        "Sawbridgeworth",
        "Maidstone",
        "St Albans",
        "High Wycombe",
        "Maidenhead",
        "Guildford"
      ],
      "url": "https://climatetrace.org/explore/#admin=London%20Urban%20Area:city:ghs-fua_5288&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ],
  "count": 2,
  "country": null,
  "name": "London",
  "next_offset": null,
  "offset": 0
}

Search owners

Find companies and other owners of emission sources by name, with the ids 'Get owner emissions' and 'Find top-emitting sources' take.

Inputs

NamenametextRequired
All or part of the owner's name.
Number of resultslimitnumber
How many results to return, at most 100.From 1 to 100. Default: 20.
Skipoffsetnumber
How many results to skip, for the next page: use next_offset from the previous answer. Leave empty for the first page.At least 0. Default: 0.

Outputs

countnumber
How many owners are listed.
nametext
The name searched for.
next_offsetnumber
The Skip value for the next page, or null when this is the last.
offsetnumber
How many owners were skipped.
ownerslist
The matching owners.
Example output
{
  "count": 3,
  "name": "Shell",
  "next_offset": 5,
  "offset": 0,
  "owners": [
    {
      "name": "Shell PLC",
      "owner_id": "E100000000746",
      "url": "https://climatetrace.org/explore/#admin=Shell%20PLC:owner:E100000000746&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "name": "Shell Chemical",
      "owner_id": "E100002009014",
      "url": "https://climatetrace.org/explore/#admin=Shell%20Chemical:owner:E100002009014&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "name": "Shell Deutschland GmbH",
      "owner_id": "E100000004022",
      "url": "https://climatetrace.org/explore/#admin=Shell%20Deutschland%20GmbH:owner:E100000004022&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ]
}

Search states, provinces and counties

Find states, provinces, counties, districts and countries by name, with the ids the emissions and source steps take. Names are the local ones, such as Bayern for Bavaria.

Inputs

NamenametextRequired
All or the start of the area's name.
Levelleveltext
Only areas of this kind.One of: any, 0 (Countries), 1 (States and provinces), 2 (Counties and districts). Default: any.
Countrycountrytext
Only results in this country. Leave empty for every country.
Number of resultslimitnumber
How many results to return, at most 100.From 1 to 100. Default: 20.

Outputs

areaslist
The matching areas.
countnumber
How many areas are listed.
countrytext
The country the results were limited to, or null.
leveltext
The level searched: any, 0, 1 or 2.
nametext
The name searched for.
Example output
{
  "areas": [
    {
      "area_id": "USA.5_1",
      "country": "USA",
      "full_name": "California State, USA",
      "level": 1,
      "level_name": "state or province",
      "name": "California State",
      "state_id": null,
      "url": "https://climatetrace.org/explore/#admin=California%20State:state:USA.5_1&gas=co2e&year=2025&timeframe=100&sector=&asset="
    },
    {
      "area_id": "COL.28.11_2",
      "country": "COL",
      "full_name": "California Municipality, Santander Department, COL",
      "level": 2,
      "level_name": "county or district",
      "name": "California Municipality",
      "state_id": "COL.28_2",
      "url": "https://climatetrace.org/explore/#admin=California%20Municipality:county:COL.28.11_2&gas=co2e&year=2025&timeframe=100&sector=&asset="
    }
  ],
  "count": 2,
  "country": null,
  "level": "any",
  "name": "California"
}

On this page