POST AI agent ready /v1/geo/batch

Batch Geocoding API - Free Bulk Address to Coordinates

Send an array of up to 10 freeform addresses and receive coordinates for each. Addresses are geocoded in parallel. Individual failures return an error message for that address without failing the entire batch. The response includes total, resolved, and failed counts.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/geo/batch \
  -H "Content-Type: application/json" \
  -d '{"addresses":["London, UK","Paris, France","xyzzy nowhere"]}'

When to use this API

Plot customer locations on a map

Geocode a list of customer addresses from your CRM export. Use the coordinates to place pins on a map for territory planning, delivery routing, or sales coverage analysis.

Enrich CSV imports with coordinates

Process uploaded CSV files containing addresses. Batch geocode the address column and append latitude and longitude to each row before storing in your database.

Validate multiple addresses in a form submission

When a user submits a multi-address form (e.g., billing + shipping + alternate), geocode all addresses in one API call. Flag any that fail to resolve before accepting the submission.

Frequently asked questions

What is the maximum number of addresses per request?

You can send up to 10 addresses per request. For larger batches, split your list into chunks of 10 and send multiple requests.

What happens if one address fails?

Failed addresses return lat: null, lng: null, and an error message. The rest of the batch processes normally. Check the failed count in the response to identify problematic addresses.

Are the geocoding calls made in parallel?

Yes. All addresses in the batch are geocoded simultaneously for faster response times. A batch of 10 addresses takes roughly the same time as a single geocode request.

Can I geocode more than 10 addresses?

Not in a single request. Split your list into batches of 10 and send multiple requests. With a paid plan, you can send multiple batch requests per second.

Is this the same geocoder as /v1/geo/geocode?

Yes. The batch endpoint uses the same OpenStreetMap Nominatim geocoder as the single-address endpoint. Results are identical for the same input.

Get your API key

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