{
  "name": "BigDataCloud — IP geolocation with confidence",
  "nodes": [
    {
      "parameters": {
        "content": "## BigDataCloud IP geolocation (with confidence area)\n\n1. Replace `YOUR_BDC_API_KEY` on the HTTP Request node with your key from https://www.bigdatacloud.com/\n2. Prefer the `x-bdc-key` header (do not put the key in the URL).\n3. Change the `ip` query value as needed.\n4. Docs: https://www.bigdatacloud.com/ip-geolocation/ip-address-geolocation-with-confidence-area-api\n\n**This sample** uses `/data/ip-geolocation-with-confidence` (location + confidence area).\n\n**Swap the URL** on the same HTTP Request node for other reports (same header + `ip` query):\n- `/data/ip-geolocation` — basic city-level\n- `/data/ip-geolocation-full` — full report (geolocation + confidence + hazard)\n- `/data/hazard-report` — hazard report only (`ip` query; no `localityLanguage`)\n- `/data/country-by-ip` — country by IP (ISO names, currency, calling code, UN region)\n\nKeep `x-bdc-key` in the header only.",
        "height": 480,
        "width": 480
      },
      "id": "sticky-ip",
      "name": "Setup notes",
      "type": "n8n-nodes-base.stickyNote",
      "typeVersion": 1,
      "position": [
        -480,
        -120
      ]
    },
    {
      "parameters": {},
      "id": "manual-trigger",
      "name": "When clicking Test workflow",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "method": "GET",
        "url": "https://api-bdc.net/data/ip-geolocation-with-confidence",
        "sendQuery": true,
        "queryParameters": {
          "parameters": [
            {
              "name": "ip",
              "value": "54.234.65.233"
            },
            {
              "name": "localityLanguage",
              "value": "en"
            }
          ]
        },
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "x-bdc-key",
              "value": "YOUR_BDC_API_KEY"
            }
          ]
        },
        "options": {}
      },
      "id": "http-ip-geo",
      "name": "IP geolocation with confidence",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        300,
        0
      ],
      "notes": "GET /data/ip-geolocation-with-confidence — key in x-bdc-key only. Sample IP 54.234.65.233 (unicast).",
      "notesInFlow": true
    }
  ],
  "connections": {
    "When clicking Test workflow": {
      "main": [
        [
          {
            "node": "IP geolocation with confidence",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  },
  "pinData": {},
  "settings": {
    "executionOrder": "v1"
  },
  "staticData": null,
  "tags": [
    {
      "name": "BigDataCloud"
    }
  ],
  "meta": {
    "templateCredsSetupCompleted": false,
    "instanceId": "bigdatacloud-n8n-template"
  }
}