GDP Data API

About the GDP Data API

GDP API provides comprehensive economic data from the World Bank including GDP in current USD, GDP growth rate, and GDP per capita. Query the latest data or retrieve data for a specific year for economic analysis and research. With changes=true every reading is set against the country's own stored history: whether GDP rose or fell for every plan, and on paid plans the previous year, its GDP and real growth rate, the change in dollars and percent, the per-capita change, a growth trend (accelerating, slowing or steady), the 5-year average real growth rate, and the 5- and 10-year compound annual growth rates of nominal GDP.

What people use it for

Sovereign Risk Assessment

To assess national debt sustainability, credit rating agencies compare a government's outstanding obligations against total economic output and per capita income.

Cross-Border Expansion Benchmarking

When evaluating consumer purchasing power in emerging markets, retail strategists benchmark local gross domestic product per capita against established regional markets.

Macroeconomic Dashboard Widgets

Feed annual growth rates and formatted dollar outputs directly into financial intelligence portals to track national output shifts across continents.

Academic Research Modeling

Economists track multi-decade development trajectories by pulling historical national production numbers and yearly growth percentages for statistical regression models.

Without writing code

Evlar Markets, a Windows app built on this API, shows it on its markets dashboard beside your watchlist.

Historical US GDP on DigestYourFinances charts growth year by year.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON

Default REST response

XML

Markup format

YAML

Human-readable

CSV

Tabular export

Beta

GraphQL

Query language

New

MCP

For AI agents

Request parameters — GET /v1/gdp

Sent in the query string. Premium parameters are accepted on every plan but only take effect on plans that include them. Anything not listed here is dropped rather than passed through.

Required

Optional

1
2

curl "https://api.apiverve.com/v1/gdp?country=US&year=2023&changes=true" \
  -H "x-api-key: YOUR_API_KEY"

Authentication

Send your key in the x-api-key header. That is the only auth step — no token exchange, and no per-endpoint scope to configure.

Response — GET /v1/gdp

Every APIVerve endpoint returns the same three top-level keys, so one response handler covers your whole integration: status, error and data. Only data changes shape.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

{
  "status": "ok",
  "error": null,
  "data": {
    "country": "US",
    "countryName": "United States",
    "currency": "USD",
    "year": 2025,
    "gdp": 30769700000000,
    "gdpFormatted": "$30.77 trillion",
    "gdpGrowth": 2.16,
    "gdpPerCapita": 90027,
    "count": 1,
    "years": [
      {
        "year": 2025,
        "gdp": 30769700000000,
        "gdpFormatted": "$30.77 trillion",
        "gdpGrowth": 2.16,
        "gdpPerCapita": 90027
      }
    ],
    "previousYear": 2024,
    "changeDirection": "up",
    "previousGdp": 29298013000000,
    "gdpChange": 1471687000000,
    "gdpChangePercent": 5.02,
    "previousGdpGrowth": 2.79,
    "growthTrend": "slowing",
    "gdpPerCapitaChangePercent": 4.48,
    "gdpCagr5y": 7.56,
    "gdpCagr10y": 5.34,
    "averageGrowth5y": 3.31
  },
  "code": 200
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Response headers

Every response carries your balance, so your own code always knows where it stands without polling anything. All four are exposed to browsers through CORS.

Errors

Read the HTTP status first, then error for the specific reason. The body names the parameter that has to change.

What a call costs — 2 credits per call

Credits are shared across every APIVerve API — one balance, one key, one bill. Failed requests never count against it, so a rejected input costs nothing.

Calls are what the credits buy at this API's rate — spend them here, on any of the other APIs, or across both. Nothing is reserved per endpoint.

Zero-code embed — one snippet, no backend

Drop an interactive GDP Data form onto any page. The widget calls the API for you, so no key ever appears in your markup and there is nothing to deploy.

Changelog — GDP Data API

Every change to this endpoint, newest first. Breaking changes ship as a new version and the previous one keeps serving — response fields are added, never removed or retyped in place, so an integration written against v1 keeps working.

Currently v1Data refreshed daily