๐ŸŽ‰ Limited time โ€” 20% off all plans. View pricing โ†’
Docs ยท Intelligence

Bulk IP geolocation

Geolocate up to 100 IPs in a single call. Same enrichment per IP as /v1/intel/geoip.

POST /v1/intel/geoip/bulk

Pass an array of up to 100 public IPv4/IPv6 addresses, get back a parallel array of geolocation results. Each entry has the full enrichment of the single-IP endpoint (country/region/city/lat-lon/timezone/ASN/ISP/approximate postal). Charged at 1 credit per call regardless of how many IPs you pass โ€” batching is cheaper than fan-out from your side.

Parameters

Name Type Required Default Description
ips array yes โ€” List of public IPs (IPv4 or IPv6). Max 100 per request.

Request

curl -X POST https://api.qcrawl.com/v1/intel/geoip/bulk \
  -H "Authorization: Bearer osk_..." \
  -d '{"ips": ["8.8.8.8", "1.1.1.1", "208.67.222.222"]}'

Response

{
  "status": "success",
  "count": 3,
  "results": [
    {"status": "success", "ip": "8.8.8.8", "country": "US", "city": "Mountain View", "asn": 15169, "isp": "GOOGLE", ...},
    {"status": "success", "ip": "1.1.1.1", "country": "AU", "city": "Sydney", "asn": 13335, "isp": "CLOUDFLARENET", ...},
    {"status": "success", "ip": "208.67.222.222", "country": "US", "city": "San Francisco", "asn": 36692, "isp": "OPENDNS", ...}
  ]
}

Related