{"uid":"cap_qvpfXiynpyQtQ_769fjjB","slug":"ip-geolocation-bulk-lookup-a14e4d08","name":"IP Geolocation Bulk Lookup","description":"IP geolocation, batch lookup, distance calculation, and caller-IP introspection with x402 payments.","url":"https://ipgeo.payapi.market/lookup/bulk?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"ips":{"type":"array","items":{"type":"string"},"maxItems":20,"description":"Up to 20 IPv4/IPv6 addresses to geolocate in one batch."}}},"responseSchema":{"type":"json","example":{"count":2,"results":[{"ip":"8.8.8.8","asn":"AS15169","isp":"Google LLC","org":"Google Public DNS","city":"Ashburn","found":true,"is_vpn":null,"region":"Virginia","source":"ip-api.com","country":"United States","is_proxy":null,"latitude":39.03,"timezone":"America/New_York","longitude":-77.5,"postal_code":"20149","region_code":"VA","country_code":"US","is_datacenter":true},{"ip":"1.1.1.1","asn":"AS13335","isp":"Cloudflare, Inc.","org":"Cloudflare DNS Resolver","city":"Sydney","found":true,"is_vpn":null,"region":"New South Wales","source":"ip-api.com","country":"Australia","is_proxy":null,"latitude":-33.87,"timezone":"Australia/Sydney","longitude":151.21,"postal_code":"2000","region_code":"NSW","country_code":"AU","is_datacenter":true}]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_zizGSfRgsBFVXGN07w1ee","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Geolocates up to 20 IPv4 or IPv6 addresses in a single batch request, returning city, region, country, ISP, ASN, coordinates, timezone, postal code, and datacenter/proxy flags for each IP.","exampleAgentPrompt":"Look up the geolocation for these IP addresses in one batch: 8.8.8.8, 1.1.1.1, 192.168.1.1 — I need the city, country, ISP, ASN, coordinates, timezone, and whether each one is a datacenter IP.","exampleUseCases":[{"title":"Fraud detection for sign-up IPs","prompt":"I have a list of IPs from today's new user sign-ups — 8.8.8.8, 203.0.113.5, 45.33.32.156, and 104.21.44.180 — can you geolocate all of them at once and flag which ones are datacenter or proxy IPs so I can review suspicious registrations?"},{"title":"Analytics dashboard geo-enrichment","prompt":"Enrich these 10 server log IPs with their country, city, region, ISP, and coordinates so I can plot them on a map: 1.1.1.1, 9.9.9.9, 208.67.222.222, 64.6.64.6, 198.41.0.4, 77.88.8.8, 8.26.56.26, 156.154.70.1, 195.46.39.39, 216.146.35.35."},{"title":"VPN and datacenter IP screening","prompt":"Check whether these IP addresses belong to datacenters or are known proxies: 104.16.0.0, 172.64.0.0, 13.32.0.0, and 151.101.0.0 — return the ISP, ASN, and datacenter flag for each."}],"resultDescription":"Returns a JSON object with a count and a results array. Each element contains: ip, found (boolean), city, region, region_code, country, country_code, postal_code, latitude, longitude, timezone, ISP, ASN, org, is_datacenter, is_proxy, is_vpn, and source (the underlying data provider). Up to 20 IPs are resolved per request.","failureModes":["Invalid IP address format causes that entry to return found:false or an error","Exceeding 20 IPs per batch results in a request rejection","Payment failure via x402 blocks the request entirely","Private or reserved IP ranges (e.g. 192.168.x.x) may return found:false or null geo fields","Rate limiting if too many requests are made in quick succession","Some fields (is_vpn, is_proxy) may return null if detection data is unavailable"],"whenToPreferThis":"Choose this endpoint when you need to geolocate multiple IP addresses in a single round-trip (up to 20), especially when you also need ISP, ASN, datacenter, proxy, or VPN classification alongside geographic data. It is ideal for fraud detection pipelines, log enrichment, and analytics dashboards where per-IP overhead must be minimized. Prefer it over single-IP lookup endpoints when processing batches from server logs or user activity data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T12:38:51.432Z","isFirstParty":false,"canonicalSlug":"ip-geolocation-bulk-lookup-a14e4d08"}