IP Geo API – Bulk IP Geolocation

Use this endpoint when you need to geolocate multiple IPs simultaneously (up to 20) and want to minimize API calls. It is strictly more efficient than calling the single /lookup/ip endpoint repeatedly for each address. Ideal for log enrichment, fraud analysis, audience analytics, or security triage workflows where you have a batch of IPs ready. For a single IP, use /lookup/ip directly. For more than 20 IPs, split into multiple batch calls.

• More than 20 IPs submitted — request rejected with validation error
• Malformed or non-IP string in the array — that entry may error or return null fields
• Private/reserved IP ranges (e.g. 192.168.x.x, 10.x.x.x) return no meaningful geo data
• Empty ips array — may return empty results or an error
• Network timeout if the upstream geo database is slow
• Payment failure (x402) if USDC balance is insufficient