Rank countries by greenhouse-gas emissions for a gas and window

Rank every country / territory in the Climate TRACE inventory by total emissions of a selected gas over a start / end window. Optionally restrict to a continent or named country group (g7, g20, g77, eu, aosis, arab_league). Each row returns the emissions total, per-capita figure, share of the global total, and year-over-year percentage change. Data sourced from Climate TRACE under CC BY 4.0.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Country rows ranked by emissions plus global totals and a time-series breakdown.

Bodyapplication/json

Example

{
    "data": {
        "totals": {
            "start": "string",
            "end": "string",
            "gas": "string",
            "emissionsQuantity": 0,
            "emissionsFactor": 0,
            "emissionsFactorUnits": "string",
            "activity": 0,
            "activityUnits": "string",
            "capacity": 0,
            "capacityUnits": "string",
            "capacityFactor": 0,
            "summaries": [
                {
                    "gas": "string",
                    "emissionsQuantity": 0,
                    "percentage": 0
                }
            ],
            "timeseries": [
                {
                    "year": 0,
                    "month": 0,
                    "gas": "string",
                    "sector": "string",
                    "subsector": "string",
                    "emissionsQuantity": 0
                }
            ]
        },
        "location": {
            "name": "string",
            "id": "string"
        },
        "rankings": [
            {
                "rank": 0,
                "country": "string",
                "name": "string",
                "continent": "string",
                "emissionsQuantity": 0,
                "emissionsPerCapita": 0,
                "percentage": 0,
                "emissionsPercentChange": 0,
                "population": 0
            }
        ]
    },
    "meta": {
        "endpoint": "/api/v1/fred/us/cpi",
        "data_time": "2026-04-16T14:30:00Z",
        "response_time": "2026-04-16T14:30:12Z",
        "provider": "Sugra API v1.0.1",
        "source": "string",
        "fallback_used": true,
        "fallback_chain": [
            "string"
        ],
        "cached": true
    }
}

🟠401

🟠422

🟠429

🔴503