{
  "info": {
    "name": "Big Mac Index API",
    "description": "Real-time Big Mac prices, PPP data, and currency valuation signals.\n\nPublic REST API. No auth required for light read-only usage.\nContact https://thebigmacindex.com/api for commercial / high-volume use.\n\nIndependent project. Not affiliated with McDonald's or The Economist.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "_postman_id": "thebigmacindex-v1",
    "version": "1.0.0"
  },
  "variable": [
    { "key": "baseUrl", "value": "https://api.thebigmacindex.com/api/v1/burger", "type": "string" },
    { "key": "country", "value": "ch", "type": "string", "description": "Default country ID for examples" }
  ],
  "auth": { "type": "noauth" },
  "item": [
    {
      "name": "Snapshot",
      "item": [
        {
          "name": "GET /latest — all countries",
          "request": {
            "method": "GET",
            "header": [{ "key": "Accept", "value": "application/json" }],
            "url": { "raw": "{{baseUrl}}/latest", "host": ["{{baseUrl}}"], "path": ["latest"] },
            "description": "Latest snapshot across all tracked countries."
          }
        },
        {
          "name": "GET /latest?country={{country}} — single country",
          "request": {
            "method": "GET",
            "header": [{ "key": "Accept", "value": "application/json" }],
            "url": {
              "raw": "{{baseUrl}}/latest?country={{country}}",
              "host": ["{{baseUrl}}"], "path": ["latest"],
              "query": [{ "key": "country", "value": "{{country}}" }]
            }
          }
        }
      ]
    },
    {
      "name": "Rankings",
      "item": [
        {
          "name": "GET /rankings?metric=usd_price&order=desc",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/rankings?metric=usd_price&order=desc&limit=20",
              "host": ["{{baseUrl}}"], "path": ["rankings"],
              "query": [
                { "key": "metric", "value": "usd_price", "description": "raw_ppp_index | gdp_adjusted_index | absolute_price_index | usd_price" },
                { "key": "order", "value": "desc", "description": "asc | desc" },
                { "key": "limit", "value": "20" }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "History",
      "item": [
        {
          "name": "GET /history?country={{country}}&days=30",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/history?country={{country}}&days=30",
              "host": ["{{baseUrl}}"], "path": ["history"],
              "query": [
                { "key": "country", "value": "{{country}}" },
                { "key": "days", "value": "30", "description": "Max 365" }
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Comparison",
      "item": [
        {
          "name": "GET /compare?countries=us,ch,de",
          "request": {
            "method": "GET",
            "url": {
              "raw": "{{baseUrl}}/compare?countries=us,ch,de",
              "host": ["{{baseUrl}}"], "path": ["compare"],
              "query": [{ "key": "countries", "value": "us,ch,de", "description": "Comma-separated country IDs. Min 2, max 5." }]
            }
          }
        }
      ]
    },
    {
      "name": "Metadata",
      "item": [
        {
          "name": "GET /countries",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/countries", "host": ["{{baseUrl}}"], "path": ["countries"] }
          }
        },
        {
          "name": "GET /currencies",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/currencies", "host": ["{{baseUrl}}"], "path": ["currencies"] }
          }
        }
      ]
    },
    {
      "name": "Operations",
      "item": [
        {
          "name": "GET /scrape/status",
          "request": {
            "method": "GET",
            "url": { "raw": "{{baseUrl}}/scrape/status", "host": ["{{baseUrl}}"], "path": ["scrape", "status"] }
          }
        }
      ]
    }
  ]
}