Big Mac Index API

Get started in 30 seconds

No signup, no API key. Hit the endpoint, get JSON back.

Copycurl "https://api.thebigmacindex.com/api/v1/burger/latest"

Expected response shape (truncated):

{
  "date": "2026-05-02",
  "usBasePrice": 5.79,
  "countries": [
    {
      "countryId": "ch",
      "countryName": "Switzerland",
      "currency": "CHF",
      "localPrice": 8.9,
      "usdPrice": 11.36,
      "impliedPpp": 1.273247,
      "marketFxRate": 0.783348,
      "rawPppIndex": 62.54,
      "gdpAdjustedIndex": 26.97,
      "valuationLabel": "overvalued",
      "citiesSampled": 5,
      "cities": [...]
    }
  ],
  "metadata": { "lastUpdated": "2026-05-02 00:13:01", "countriesCount": 9, "baseCountry": "us" }
}

API status & data freshness

Live snapshot of the scraping pipeline. The /scrape/status endpoint backs this section and is also available to your own dashboards.

Authentication & rate limits

The public API is currently available without authentication for light usage. Please cache responses where possible and contact us for commercial, high-volume, or production use.

Public usage is intended for demos, research, editorial use, education, and light integrations. Formal API keys, rate limits, and paid tiers may be introduced for commercial or high-volume use cases. Contact us if you need a commitment.

Endpoints

All endpoints are GET. Base URL: https://api.thebigmacindex.com/api/v1/burger. See openapi.json for the complete machine-readable spec.

curl "https://api.thebigmacindex.com/api/v1/burger/latest?country=ch"

curl "https://api.thebigmacindex.com/api/v1/burger/rankings?metric=usd_price&order=desc&limit=20"

curl "https://api.thebigmacindex.com/api/v1/burger/history?country=ch&days=90"

curl "https://api.thebigmacindex.com/api/v1/burger/compare?countries=us,ch,de"

curl "https://api.thebigmacindex.com/api/v1/burger/countries"

curl "https://api.thebigmacindex.com/api/v1/burger/currencies?item=bigmac"

curl "https://api.thebigmacindex.com/api/v1/burger/scrape/status"

Try the API

Build a request, copy the URL, or fire it from this page. CORS lets the request hit the API directly from your browser.

Response fields

Country-level fields returned by /latest, /rankings, and /compare. See openapi.json for full schemas including City, HistoryRow, and error shapes.

Code examples

Copy-paste-ready in the language of your choice.

Copycurl "https://api.thebigmacindex.com/api/v1/burger/latest?country=ch"

Copyconst response = await fetch(
  "https://api.thebigmacindex.com/api/v1/burger/latest?country=ch"
);
const data = await response.json();
console.log(data);

Copy// Node 18+ has fetch built in
const url = "https://api.thebigmacindex.com/api/v1/burger/latest?country=ch";
const res = await fetch(url);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
console.log(data.countries?.[0]);

Copyimport requests

url = "https://api.thebigmacindex.com/api/v1/burger/latest"
params = {"country": "ch"}
response = requests.get(url, params=params)
response.raise_for_status()
data = response.json()
print(data)

Copylibrary(httr2)

req <- request("https://api.thebigmacindex.com/api/v1/burger/latest") |>
  req_url_query(country = "ch")
resp <- req_perform(req)
data <- resp_body_json(resp)
print(data)

Copy=IMPORTDATA("https://thebigmacindex.com/api/export/latest.csv")

What can you build?

Which one do you need?

/api is for live, programmatic access. /data is for citation, downloads, and one-shot use in articles or research.

Visit /data →

OpenAPI specification

Full OpenAPI 3.1 spec covering every public endpoint with request parameters, response schemas, and examples. Drop it into Postman, Swagger UI, Insomnia, or any AI agent that consumes OpenAPI.

Spec versioned at v1. Subscribe to the changelog for breaking-change notifications.

CSV & JSON downloads

For Google Sheets, Excel, AI agents, low-code tools, and citation-friendly URLs, the same data is also available as static, build-time-refreshed exports.

More context, citation guidance, and methodology on /data.

Errors

Errors return JSON with stable error codes. Use the error.code field for programmatic handling; error.message is human-readable.

{
  "success": false,
  "error": {
    "code": "INVALID_COUNTRY",
    "message": "Country ID not found.",
    "details": { "country": "xx" }
  }
}

API changelog

Need higher limits or commercial use?

The public API is designed for demos, research, editorial use, education, and light integrations. For commercial products, high-volume access, custom exports, redistribution, or partnership use cases, get in touch.

Request API access →

Include: company, expected monthly request volume, use case, and whether usage is commercial or non-commercial.

API FAQ