v5

OpenAPI 3.1.0Proprietary2026-08-031,5423,1505.5 MB
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.

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).

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

yearinteger required

Year the comparison applies to.

Year the comparison applies to.

versionstring nullable

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

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"
    ]
  }
}