Bulk IP Geolocation Lookup
ipgeolocation_bulk_lookupRead-onlyIdempotent
Look up geolocation data for up to 50,000 IP addresses or hostnames in a single request. Returns an array of geolocation objects with individual error handling.
Instructions
Look up geolocation data for up to 50,000 IP addresses or hostnames in one request. Returns an array of geolocation objects — same fields as the single lookup. Individual IP failures include a 'message' field; they don't block other results.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ips | Yes | List of IPv4/IPv6 addresses or hostnames to look up (max 50,000). Example: ["8.8.8.8", "1.1.1.1"] | |
| lang | No | Language for location name fields. Defaults to English. | en |
| include | No | Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, time_zone, geo_accuracy. | |
| fields | No | Comma-separated dot-path fields to include in the response (allowlist). E.g. 'location.city,asn.organization'. | |
| excludes | No | Comma-separated dot-path fields to exclude from the response (denylist). E.g. 'location.city,asn.organization'. |