Research

Side-by-side comparison of countries for one variable-year

Returns a single-year cross-section of up to 10 countries for one Penn World Table variable. Pass a comma-separated list of ISO 3166-1 alpha-3 codes via countries. Results are sorted descending by value, with any countries missing from the requested year surfaced in missing_countries. Useful for quick scatter-plot data or benchmark tables (e.g. compare the G7 on ctfp or the BRICs on rgdpo). Published under CC BY 4.0 with attribution to Penn World Table (Feenstra, Inklaar & Timmer, University of Groningen).

get/api/v1/research/pwt/compare

Query parameters

countriesstring required

Comma-separated ISO 3166-1 alpha-3 country codes (max 10). Case-insensitive; normalised to uppercase.

variablestring

Penn World Table variable to compare (e.g. rgdpo, ctfp, hc, labsh).

yearinteger required

Year the comparison applies to.

versionstring nullable

Release selector. pwt1100 (default) or pwt1001 (legacy).

Response

Ordered cross-section of requested countries for one variable-year plus missing-country list.

Example response

{
  "data": {
    "version": "pwt1100",
    "variable": "rgdpo",
    "year": 2020,
    "observations": [
      {
        "countrycode": "USA",
        "country": "United States",
        "value": 20953.03
      }
    ],
    "count": 3,
    "requested_countries": [
      "USA",
      "CHN",
      "DEU"
    ]
  },
  "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": "sugra_crypto",
    "attribution": "Short interest and Reg SHO daily short volume data is owned by and sourced from FINRA (Financial Industry Regulatory Authority).",
    "fallback_chain": [
      "sugra_crypto",
      "sugra_finance"
    ]
  }
}

Changes

Changed in 1 of the 21 revisions of this API.12

Aug 8, 20264c4530760ba112See the full diff
- ○
  added the optional property code to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property code to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property hint to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property plan to the response with the 503 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 401 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 429 status
  response-optional-property-added
- ○
  added the optional property reason to the response with the 503 status
  response-optional-property-added

Full history