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, returning location, ISP, and more. Individual failures don't block results.
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 |
| fields | No | Comma-separated dot-path fields to include in the response (allowlist). E.g. 'location.city,asn.organization'. | |
| include | No | Additional data modules to include. Available: security, hostname, liveHostname, hostnameFallbackLive, user_agent, abuse, dma_code, geo_accuracy. Use '*' to include all modules. Note: 'security' and 'abuse' fields cost extra credits. | |
| excludes | No | Comma-separated dot-path fields to exclude from the response (denylist). E.g. 'location.city,asn.organization'. |