# Climate TRACE

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

App · 15 actions. Web page: https://docs.lodol.com/docs/integrations/climate-trace

## Actions

### 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**

- Where (`place_type`, text): 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`.
- Country (`country`, text): The country to look in. Only when Where is A country.
- State, province or county id (`area_id`, text): 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 id (`city_id`, text): The city's Climate TRACE id, from 'Search cities'. Only when Where is A city.
- Continent (`continent`, text): The continent. Only when Where is A continent.
- Group of countries (`country_group`, text): The group, such as the European Union, the G20 or OPEC. Only when Where is A group of countries.
- Owner id (`owner_id`, text): Only sources this owner owns, by its id from 'Search owners'. Leave empty for every owner.
- Year (`year`, number): The year, 2021 or later (source-level data starts in 2021). Leave empty for last year, the latest complete one. From 2021 to 2026.
- Gas (`gas`, text): 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`.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): 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 use (`include_forestry`, true/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 sources (`limit`, number): How many sources to list, biggest first, at most 500. From 1 to 500. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many sources are listed.
- `gas` (text): 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_name` (text): The gas in words.
- `includes_forestry` (true/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_offset` (number): The Skip value for the next page, or null when this is the last.
- `offset` (number): How many sources were skipped.
- `owner_ids` (list): The owner ids the search was limited to.
- `place_id` (text): The id of the place searched, or null for the whole world.
- `place_name` (text): The place searched, or null for the whole world.
- `place_type` (text): world, country, area, city, continent or country_group.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `sources` (list): The sources, biggest emitter first.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `year` (number): The year ranked.

**Example output**

```json
{
  "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**

- Country (`country`, text, required): The country, from Climate TRACE's list. A 3-letter code such as USA, or a country name from an earlier step, works too.
- Year (`year`, number): 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.
- Gas (`gas`, text): 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`.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): 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 use (`include_forestry`, true/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_percent` (number): Percent change from the year before, as Climate TRACE works it out, or null while the year is still being published.
- `complete_year` (true/false): Whether all 12 months are published.
- `continent` (text): The continent it is on.
- `country` (text): The country's 3-letter code.
- `country_name` (text): The country's name.
- `gas` (text): 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_name` (text): The gas in words.
- `includes_forestry` (true/false): Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
- `monthly` (list): Emissions month by month, oldest first.
- `months_reported` (number): How many months of the year are published (12 for a complete year).
- `per_capita_tonnes` (number): Emissions per person in tonnes.
- `ranked_countries` (number): How many countries were ranked.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `sectors` (list): The total split by sector, biggest first.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `subsectors` (list): The total split by subsector, biggest first.
- `total_tonnes` (number): Total emissions for the year in tonnes, or null when no month is published yet.
- `url` (text): The figures on the climatetrace.org map.
- `world_rank` (number): The country's rank among all countries (1 emits most).
- `world_share_percent` (number): The country's share of the world total, in percent.
- `year` (number): The year the figures are for.

**Example output**

```json
{
  "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**

- Country (`country`, text, required): 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 year (`from_year`, number): The first year, 2015 or later. Leave empty for the 10 years up to To year. From 2015 to 2026.
- To year (`to_year`, number): The last year. Leave empty for the same year as From year (or last year when both are empty). From 2015 to 2026.
- Gas (`gas`, text): 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`.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): 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 use (`include_forestry`, true/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_year` (number): The first year that change is measured from.
- `change_percent` (number): Percent change from the first complete year listed to the last, or null with fewer than two complete years.
- `change_to_year` (number): The last year that change is measured to.
- `country` (text): The country's 3-letter code.
- `country_name` (text): The country's name.
- `data_through` (text): The last month published (YYYY-MM) when the last year is not complete yet, otherwise null.
- `from_year` (number): The first year.
- `gas` (text): 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_name` (text): The gas in words.
- `includes_forestry` (true/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_tonnes` (number): That year's emissions in tonnes.
- `peak_year` (number): The complete year with the highest emissions.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `to_year` (number): The last year.
- `url` (text): The figures on the climatetrace.org map.
- `year_count` (number): How many years are listed.
- `years` (list): Each year's figures, oldest first.

**Example output**

```json
{
  "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 id (`source_id`, text, required): The source's Climate TRACE id, from 'Find top-emitting sources'.
- From year (`from_year`, number): The first year, 2021 or later. Leave empty for 2021. From 2021 to 2026.
- To year (`to_year`, number): The last year. Leave empty for this year, with the months published so far. From 2021 to 2026.
- Figures for (`granularity`, text): One row per year, or per month. One of: `year` (Each year), `month` (Each month). Default: `year`.
- Gas (`gas`, text): 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_type` (text): What kind of source it is.
- `confidence` (object): How confident Climate TRACE is in the latest year's figures: very low, low, medium, high or very high.
- `country` (text): The 3-letter code of the country it is in.
- `emissions` (list): Figures for each year or month, oldest first.
- `found` (true/false): Whether Climate TRACE has a source with this id.
- `from_year` (number): The first year covered.
- `gas` (text): 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_name` (text): The gas in words.
- `granularity` (text): year or month.
- `latitude` (number): Latitude of the source.
- `longitude` (number): Longitude of the source.
- `name` (text): The source's name.
- `owners` (list): Who owns it.
- `sector` (text): The sector's id.
- `source_id` (number): The source's Climate TRACE id.
- `source_type` (text): point-source for a facility; otherwise an area's total.
- `subsector` (text): The subsector's id.
- `subsector_name` (text): The subsector in words.
- `subsector_ranks` (list): Its rank among every source in its subsector worldwide, by year.
- `to_year` (number): The last year covered.
- `total_tonnes` (number): Emissions over the whole period in tonnes.
- `url` (text): The figures on the climatetrace.org map.

**Example output**

```json
{
  "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**

- Where (`place_type`, text, required): 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 id (`area_id`, text): 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 id (`city_id`, text): The city's Climate TRACE id, from 'Search cities'. Only when Where is A city.
- Continent (`continent`, text): The continent. Only when Where is A continent.
- Group of countries (`country_group`, text): The group, such as the European Union, the G20 or OPEC. Only when Where is A group of countries.
- Year (`year`, number): 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.
- Gas (`gas`, text): 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`.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): 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 use (`include_forestry`, true/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_year` (true/false): Whether all 12 months are published.
- `country` (text): The 3-letter code of the country a state or city is in.
- `gas` (text): 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_name` (text): The gas in words.
- `includes_forestry` (true/false): Whether forestry and land use is counted. It is left out unless asked for or picked as the sector, as on climatetrace.org.
- `monthly` (list): Emissions month by month, oldest first.
- `months_reported` (number): How many months of the year are published (12 for a complete year).
- `place_id` (text): The place's id: an area id, a city id, a continent or a group.
- `place_name` (text): The place's name.
- `place_type` (text): area, city, continent, country_group or world.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `sectors` (list): The total split by sector, biggest first.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `subsectors` (list): The total split by subsector, biggest first.
- `total_tonnes` (number): Total emissions for the year in tonnes, or null when no month is published yet.
- `url` (text): The figures on the climatetrace.org map.
- `year` (number): The year the figures are for.

**Example output**

```json
{
  "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 id (`owner_id`, text, required): The owner's Climate TRACE id, from 'Search owners'. Several ids separated by commas are added together.
- Year (`year`, number): The year, 2021 or later (source-level data starts in 2021). Leave empty for last year, the latest complete one. From 2021 to 2026.
- Gas (`gas`, text): 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`.
- Country (`country`, text): Only results in this country. Leave empty for every country.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): Only count this part of the sector, such as Electricity generation. Pick a sector first; leave empty for the whole sector.

**Outputs**

- `complete_year` (true/false): Whether all 12 months are published.
- `country` (text): The 3-letter code of the country the figures are limited to.
- `country_name` (text): That country's name.
- `gas` (text): 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_name` (text): The gas in words.
- `monthly` (list): Emissions month by month, oldest first.
- `months_reported` (number): How many months of the year are published (12 for a complete year).
- `owners` (list): The owners whose sources are added up.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `sectors` (list): The total split by sector, biggest first.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `subsectors` (list): The total split by subsector, biggest first.
- `total_tonnes` (number): Total emissions for the year in tonnes, or null when no month is published yet.
- `url` (text): The owner on the climatetrace.org map, when there is one owner.
- `year` (number): The year the figures are for.

**Example output**

```json
{
  "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**

- Subsector (`subsector`, text, required): The subsector.

**Outputs**

- `data_providers` (list): The organisations whose models or data produce its estimates.
- `found` (true/false): Whether Climate TRACE has a subsector with this id.
- `has_country_data` (true/false): Whether it is estimated country by country.
- `has_source_data` (true/false): Whether it is estimated source by source (facilities or local areas).
- `name` (text): The subsector in words.
- `sector` (text): The sector it belongs to.
- `sector_name` (text): That sector in words.
- `subsector` (text): The subsector's id.

**Example output**

```json
{
  "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**

- Continent (`continent`, text): Only countries on this continent.
- Group of countries (`country_group`, text): Only countries in this group, such as the G7.

**Outputs**

- `continent` (text): The continent the list was limited to, or null.
- `count` (number): How many countries are listed.
- `countries` (list): The countries and territories, by name.
- `country_group` (text): The group the list was limited to, or null.
- `country_group_name` (text): That group in words, or null.

**Example output**

```json
{
  "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**

- `count` (number): How many groups there are.
- `groups` (list): Every group, by name.

**Example output**

```json
{
  "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_count` (number): How many sectors there are.
- `sectors` (list): Every sector.
- `subsector_count` (number): How many subsectors there are.

**Example output**

```json
{
  "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 state (`area_id`, text, required): 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_id` (text): The id of the area split up.
- `area_name` (text): Its name.
- `count` (number): How many subdivisions are listed.
- `found` (true/false): Whether Climate TRACE has an area with this id.
- `level` (number): Its level: 0 for a country, 1 for a state or province.
- `subdivisions` (list): The areas one level down, by name.

**Example output**

```json
{
  "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 rank (`region`, text): 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`.
- Continent (`continent`, text): The continent whose countries to rank. Only when Countries to rank is Countries in a continent.
- Group of countries (`country_group`, text): 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 year (`from_year`, number): The first year to add up, 2015 or later. Leave empty for the same year as To year. From 2015 to 2026.
- To year (`to_year`, number): The last year. Leave empty for the same year as From year (or last year when both are empty). From 2015 to 2026.
- Gas (`gas`, text): 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`.
- Sector (`sector`, text): Only count this sector, such as Power or Agriculture. Leave empty for all sectors.
- Subsector (`subsector`, text): 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 use (`include_forestry`, true/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 countries (`countries`, text): 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 countries (`limit`, number): How many countries to list, biggest emitter first, at most 300. From 1 to 300. Default: `20`.

**Outputs**

- `countries` (list): The countries, biggest emitter first.
- `country_count` (number): How many countries the region has.
- `data_through` (text): The last month published (YYYY-MM) when the period runs past it, otherwise null.
- `from_year` (number): The first year added up.
- `gas` (text): 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_name` (text): The gas in words.
- `includes_forestry` (true/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_end` (text): The last day of the period, YYYY-MM-DD.
- `period_start` (text): The first day of the period, YYYY-MM-DD.
- `region` (text): world, continent or country_group.
- `region_name` (text): The region ranked, in words.
- `returned_count` (number): How many countries are listed.
- `sector` (text): The sector the figures are narrowed to, or null for all.
- `sector_name` (text): That sector in words, or null.
- `subsector` (text): The subsector the figures are narrowed to, or null.
- `subsector_name` (text): That subsector in words, or null.
- `to_year` (number): The last year added up.
- `total_tonnes` (number): The region's total over the period in tonnes.

**Example output**

```json
{
  "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**

- Name (`name`, text): All or part of the city's name, in English. Leave empty to list a country's cities.
- Country (`country`, text): Only results in this country. Leave empty for every country.
- Number of results (`limit`, number): How many results to return, at most 100. From 1 to 100. Default: `20`.
- Skip (`offset`, number): 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**

- `cities` (list): The matching cities.
- `count` (number): How many cities are listed.
- `country` (text): The country searched in, or null.
- `name` (text): The name searched for, or null.
- `next_offset` (number): The Skip value for the next page, or null when this is the last.
- `offset` (number): How many cities were skipped.

**Example output**

```json
{
  "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**

- Name (`name`, text, required): All or part of the owner's name.
- Number of results (`limit`, number): How many results to return, at most 100. From 1 to 100. Default: `20`.
- Skip (`offset`, number): 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**

- `count` (number): How many owners are listed.
- `name` (text): The name searched for.
- `next_offset` (number): The Skip value for the next page, or null when this is the last.
- `offset` (number): How many owners were skipped.
- `owners` (list): The matching owners.

**Example output**

```json
{
  "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**

- Name (`name`, text, required): All or the start of the area's name.
- Level (`level`, text): Only areas of this kind. One of: `any`, `0` (Countries), `1` (States and provinces), `2` (Counties and districts). Default: `any`.
- Country (`country`, text): Only results in this country. Leave empty for every country.
- Number of results (`limit`, number): How many results to return, at most 100. From 1 to 100. Default: `20`.

**Outputs**

- `areas` (list): The matching areas.
- `count` (number): How many areas are listed.
- `country` (text): The country the results were limited to, or null.
- `level` (text): The level searched: any, 0, 1 or 2.
- `name` (text): The name searched for.

**Example output**

```json
{
  "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"
}
```
