Skip to content
POST AI agent ready /v1/ip/bulk

Bulk IP Geolocation API - Free Batch Lookup

Returns geolocation data for multiple IP addresses in a single request. Includes the caller's own IP info alongside results for each requested IP.

Parameters

arrayrequired

Array of IPv4 or IPv6 addresses to geolocate.

Code examples

curl -X POST https://api.botoi.com/v1/ip/bulk \
  -H "Content-Type: application/json" \
  -d '{"ips":["8.8.8.8","1.1.1.1"]}'

When to use this API

Enrich analytics event logs in batch

After collecting a day of analytics events, extract unique visitor IPs and send them through the bulk endpoint. Append country and city data to each event row before loading into your data warehouse for geographic reporting.

Map distributed infrastructure

Feed a list of your server, CDN node, and load balancer IPs into this endpoint. Plot the returned coordinates on a map to visualize your infrastructure footprint and identify geographic gaps in coverage.

Frequently asked questions

How many IPs can I send in a single request?
You can send up to 100 IP addresses per request. For larger datasets, split them into batches and send multiple requests.
Does the response include my own IP?
Yes. The response includes a caller_ip field with geolocation for your own IP, in addition to results for each IP in the ips array.
Are duplicate IPs in the array handled?
Duplicate IPs are resolved independently. Each entry in the ips array gets its own result object, even if the same IP appears multiple times.
What happens if one IP in the batch is invalid?
The endpoint returns results for all valid IPs and includes an error message for any IP that could not be resolved. The request does not fail entirely because of one bad entry.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.