# Greenhouse Gas Emissions API
> Independent greenhouse-gas emissions data as an API — powered by Climate TRACE, the coalition (backed by Al Gore) that monitors global emissions from satellites, sensors and AI rather than self-reported figures. Get any country's emissions for a given year — CO2, methane (CH4) and nitrous oxide (N2O) in tonnes, plus CO2-equivalent over 100- and 20-year horizons — together with the country's global emissions rank and its share of total world emissions; pass several countries at once to compare them side by side. List the full set of sectors, subsectors and gases that Climate TRACE tracks (power, transportation, manufacturing, agriculture, fossil-fuel operations, waste and more). From China and the United States to any nation on Earth, with data from 2015 onward, it is ideal for climate, ESG, sustainability, policy, journalism and research applications. An independent emissions-inventory data source — distinct from electricity-grid carbon intensity, activity footprint calculators and climate classification. Open data from Climate TRACE (CC BY 4.0).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/climatetrace-api/..."
```

## Pricing
- **Free** (Free) — 3,200 calls/Mo, 2 req/s
- **Starter** ($8/Mo) — 62,000 calls/Mo, 8 req/s
- **Pro** ($24/Mo) — 290,000 calls/Mo, 20 req/s
- **Mega** ($63/Mo) — 1,000,000 calls/Mo, 50 req/s

## Endpoints

### Emissions

#### `GET /v1/country` — A country's GHG emissions for a year

**Parameters:**
- `country` (query, optional, string) — ISO-3 code(s), comma-separated Example: `USA`
- `year` (query, optional, string) — Year 2015-2024 (default 2022) Example: `2022`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/climatetrace-api/v1/country?country=USA&year=2022"
```

**Response:**
```json
{
    "data": {
        "year": 2022,
        "count": 1,
        "countries": [
            {
                "rank": 2,
                "country": "USA",
                "continent": null,
                "emissions": {
                    "ch4_t": 37690016,
                    "co2_t": 5403442404,
                    "n2o_t": 677321,
                    "co2e_20yr_t": 9096074557,
                    "co2e_100yr_t": 6911308569
                },
                "asset_count": null,
                "previous_rank": 2,
                "world_share_co2e_percent": 11.8
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:00.197Z",
        "request_id": "7df7f2fb-7ab2-4ae4-addc-ebdcf3e2d9ea"
    },
    "status": "ok",
    "message": "Country emissions retrieved",
    "success": true
}
```

#### `GET /v1/sectors` — Sectors, subsectors & gases covered

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/climatetrace-api/v1/sectors"
```

**Response:**
```json
{
    "data": {
        "gases": [
            "bc",
            "c10f18",
            "c2f6",
            "c3f8",
            "c4f10",
            "c5f12",
            "c6f14",
            "c6h6",
            "c-c3f6",
            "c-c4f8",
            "cf4",
            "cfcs",
            "ch2o",
            "ch3oh",
            "ch4",
            "co",
            "co2",
            "co2e",
            "co2e_100yr",
            "co2e_20yr",
            "h2s",
            "hcfc-141b",
            "hcfc-142b",
            "hcs",
            "hfc-125",
            "hfc-134",
            "hfc-134a",
            "hfc-143",
            "hfc-143a",
            "hfc-152",
            "hfc-152a",
            "hfc-161",
            "hfc-227ea",
            "hfc-23",
            "hfc-236cb",
            "hfc-236ea",
            "hfc-236fa",
            "hfc-245ca",
            "hfc-245fa",
            "hfc-32",
            "hfc-365mfc",
            "hfc-41",
            "hfc-43-10-mee",
            "hfcs",
            "hg",
            "n2o",
            "nf3",
            "nh3",
            "nmvoc",
            "no2",
            "nox",
            "o3",
            "oc",
            "pahs",
            "pb",
            "pfcs",
            "pm10",
            "pm2_5",
            "sf6",
            "so2",
            "sox",
            "vocs"
        ],
        "sectors": [
            "manufacturing",
            "mineral-extraction",
            "waste",
            "fossil-fuel
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Endpoint catalogue & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/climatetrace-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Climate TRACE is an independent inventory of global greenhouse-gas emissions, built from satellites, sensors and AI rather than self-reported figures. /v1/country?country=USA = a country's emissions for a year (default 2022; set year=2015..2024) — CO2, CH4 and N2O in tonnes, plus CO2-equivalent over 100- and 20-year horizons, the country's global emissions rank and its share of world emissions; pass several countries (country=USA,CHN,DEU, up to 15) to compare. /v1/sectors = the sectors, subsectors and gases that Climate TRACE covers. Country codes are ISO-3166 alpha-3 (USA, CHN, DEU); emissions are in tonnes. Data from Climate TRACE (CC BY 4.0). An emissions-inventory data source — distinct from electricity-grid carbon intensity, activity footprint calculators and climate classification. Ideal for climate, ESG, sustainability, policy and research applications.",
        "years": "2015-2024",
        "source": "Climate TRACE — independent GHG emissions inventory (climatetrace.org)",
        "endpoints": [
            "/v1/country",
            "/v1/sectors",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T16:23:01.076Z",
        "request_id": "332a2ff3-197b-4207-9822-e4da91ce6e2a"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/climatetrace-api
OpenAPI spec: https://www.oanor.com/api/climatetrace-api/openapi.json