Top N countries by GDP per capita or population for a year

GET

/api/v1/research/maddison/top

Last modified:2026-05-10 09:22:39

Maintainer:Not configured

OperationId:research_maddison_top

Ranks Maddison Project Database countries by a variable in descending order for one year. Answers questions like which 10 countries had the highest GDP per capita in 1913? without requiring the caller to pull the full panel and sort locally. Variable must be one of gdppc (GDP per capita in 2011 international dollars, PPP) or pop (population in thousands). Published under CC BY 4.0 by Bolt and van Zanden at the University of Groningen.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Query Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Descending ranking of countries with their iso3, country, region, and variable value.

Bodyapplication/json

Example

{
    "data": {
        "variable": "gdppc",
        "unit": "2011 international dollars (PPP)",
        "year": 2022,
        "limit": 10,
        "ranking": [
            {
                "rank": 1,
                "iso3": "string",
                "country": "string",
                "region": "string",
                "region_slug": "string",
                "value": 0
            }
        ],
        "count": 10
    },
    "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

Modified at 2026-05-10 09:22:39

Variable dictionary, methodology, and citation policy

Population-only isolated time series for one country