API v1

Programmatic access.

REST endpoints over the WorldPrice dataset — 23 countries, 45 items, 895 prices, 25 years of Big Mac history. Open, no key required for now. CDN-cached for 24h. Rate limited by the cache, not by you.

JSON + CSV

REST JSON via /api/v1/*. Bulk CSV via /api/download/*.

Daily-refreshed

FX rates 06:00 UTC. Weekly snapshots in price_history.

Open CORS

Allow-Origin *. Use from browsers, servers, notebooks.

Endpoints

GET/api/v1Root directory — lists every endpoint.

GET/api/v1/countriesAll 23 countries with FX rates.

GET/api/v1/countries/{code}Single country: full price set + wage data. e.g. /api/v1/countries/KR

GET/api/v1/itemsAll 45 items with metadata.

GET/api/v1/items/{slug}Single item: ranked across all countries. e.g. /api/v1/items/big-mac

GET/api/v1/prices?country=KR&item=bigmac&limit=500Filtered prices, paginated up to 1000/req.

GET/api/v1/indices/big-macBig Mac Index — ranked + 25-year time series (769 historical points).

GET/api/v1/indices/iphoneiPhone Workday — ranked + median wage per country.

GET/api/v1/indices/rentRent Affordability — % of annual income per country.

GET/api/v1/exchange-ratesLatest FX (1 local unit → USD / KRW).

Bulk download (CSV)

GET/api/download/pricesFull prices · 895 rows

GET/api/download/big-mac-history25 years · 769 rows

GET/api/download/items45 items metadata

GET/api/download/countries23 countries with FX

Examples

cURL

curl https://worldprice.live/api/v1/indices/big-mac \
  -H "Accept: application/json"

JavaScript

const r = await fetch('https://worldprice.live/api/v1/items/big-mac');
const { data, meta } = await r.json();
console.log(`${meta.count} markets, cheapest = ${data.prices[0].country_code}`);

Python

import requests
r = requests.get('https://worldprice.live/api/v1/countries/KR')
country = r.json()['data']
print(country['country']['name_en'], len(country['prices']), 'prices')

Pandas

import pandas as pd
df = pd.read_csv('https://worldprice.live/api/download/big-mac-history')
df.groupby('country_code')['price_usd'].agg(['min', 'max']).head()

Response shape

{
  "data": [ /* the actual payload */ ],
  "meta": {
    "api_version": "1",
    "generated_at": "2025-04-15T06:00:00.000Z",
    "count": 23,
    "limit": 500,
    "offset": 0
  }
}

Errors return { "error": { "status": 404, "message": "..." } }.

License & attribution

Attribute as "WorldPrice (worldprice.live)" for derived charts/articles. Re-distribution permitted for rows where data_license is own or public. Restricted-license rows (Big Mac Index, Apple) include source URLs — link there instead.

Full methodology