API reference/Economic Indicators/Compare Countries

Compare Countries

starter

Live data

Latest value of an indicator for up to 20 countries, ranked.

GET/api/v1/economy/compare

Data source

World Bank Indicators APIWorld Bank · CC-BY-4.0 · updates Yearly/quarterly

Query parameters

Parameter	Description	Try value
`indicator` string required	See /economy/indicators
`countries` string required	Comma-separated ISO codes
`apikey` string required	Your API key. Can also be sent as the `X-API-Key` header.	demo key used here

Response envelope

Success: { data, meta: { sources, fetchedAt, cached } }. Errors: { error: { code, message } } with HTTP 400, 401, 404, 502, 503 or 504.

curl "https://api.sectorapi.com/api/v1/economy/compare?indicator=gdp-per-capita&countries=US%2CCN%2CIN%2CDE%2CJP%2CBR&apikey=YOUR_API_KEY"

Calls the live source

Example response

{
  "data": {
    "indicator": "gdp-per-capita",
    "label": "GDP per capita",
    "unit": "current USD",
    "count": 6,
    "ranking": [
      {
        "rank": 1,
        "country": "United States",
        "code": "USA",
        "year": 2025,
        "value": 90026.5163005744
      },
      {
        "rank": 2,
        "country": "Germany",
        "code": "DEU",
        "year": 2025,
        "value": 60496.4350820414
      },
      {
        "rank": 3,
        "country": "Japan",
        "code": "JPN",
        "year": 2025,
        "value": 35951.0449549304
      }
    ]
  }
}