Research

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

Changed on

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

Request

  • Base URL: https://sugra.ai
  • URL: https://sugra.ai/api/v1/research/pwt/compare
  • Auth: API key in header x-api-key

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",
    "data_age_days": 8.532,
    "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"
    ],
    "stale_since": "2026-09-08T12:00:00Z",
    "period": "2026-Q1",
    "notes": "the UKMTO report behind these counts is dated 2026-08-21 and is 11 days old"
  }
}

Changes