IPGeolocation.io · JSON Structure

Ip Location Bulk Geolocation Request Structure

Request body for the bulk geolocation lookup. Contains a single `ips` field with an array of IP addresses or domain names to look up.

Type: object Properties: 1 Required: 1
GeocodingIP GeolocationIP IntelligenceIP SecurityASN LookupAbuse ContactTimezoneAstronomyUser AgentThreat IntelligencePublic APIs

BulkGeolocationRequest is a JSON Structure definition published by IPGeolocation.io, describing 1 property, of which 1 is required. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

ips

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑ 
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/ipgeolocation/refs/heads/main/json-structure/ip-location-bulk-geolocation-request-structure.json",
  "name": "BulkGeolocationRequest",
  "description": "Request body for the bulk geolocation lookup. Contains a single `ips` field\nwith an array of IP addresses or domain names to look up.\n",
  "type": "object",
  "properties": {
    "ips": {
      "type": "array",
      "description": "Array of IPv4 addresses, IPv6 addresses, or domain names to look up.\nMust not be empty. Maximum 50,000 entries per request. Each entry is\nresolved independently, so you can mix IPv4, IPv6, and domains freely.\n",
      "minItems": 1,
      "maxItems": 50000,
      "items": {
        "type": "string"
      },
      "examples": [
        "8.8.8.8",
        "91.128.103.196",
        "2607:fb91:16c6:8860:e531:2d1d:4944:6c7c",
        "ipgeolocation.io"
      ]
    }
  },
  "required": [
    "ips"
  ]
}