Gross Domestic Product · Data API

Global Gross Domestic Product

Annual economic output in US dollars for every country in the world.

Gross domestic product at current US dollar prices for every country and regional aggregate, one row per country per year. The data comes from the World Bank's World Development Indicators, the standard reference series for cross-country economic comparison. Analysts, market-sizing tools and AI research agents use it to rank markets, normalise metrics per unit of economy and build country scoring models.

Get API key View docs

Source: World Development Indicators, The World Bank · CC BY 4.0 · Source: World Bank, World Development Indicators (CC BY 4.0)

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

GET /v1/data/global-gross-domestic-product
GET /v1/data/global-gross-domestic-product/search?q=...
GET /v1/data/global-gross-domestic-product/{key}

Base path /v1/data/global-gross-domestic-product · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

Field	Type	Description
country_name	str	Country or aggregate region name
country_code	str	Three-letter country code
indicator_name	str	Name of the indicator series being reported
year	int	Calendar year of the observation
gdp_usd	float	Gross domestic product in current US dollars; null where not reported

What you get

Every country plus World Bank regional and income-group aggregates

One clean row per country per year, no nested objects to unpack

Filter by country code, name or year range

Nulls preserved where a country did not report, so gaps are explicit

CC BY 4.0 licensed and safe to redistribute with attribution

FAQ

Why do some rows have no value?: The World Bank leaves an observation empty when a country has not reported for that year. We keep it as null rather than guessing a figure.
Are regions included as well as countries?: Yes. Rows such as World, Euro area and income-group aggregates are included; filter them out by country code if you only want sovereign states.
Is this adjusted for inflation?: No, these are current US dollar figures. Use them for cross-country comparison in a given year rather than as a real growth series.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day

100 API requests per day
All endpoints included
Community support

Get Started

Pro

$9/month

For production apps and AI agents

10,000 requests/day

10,000 API requests per day
All endpoints included
Priority support
Usage dashboard

Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests

Unlimited API requests
All endpoints included
Priority support
Usage dashboard
Dedicated support channel

Go Enterprise

Getting Started

Start building in minutes

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"