Geocode a thousand addresses at once.
Run up to 1,000 addresses through geocoding in a single call. Returns coordinates and confidence for each.
POST /v1/geocoding/batchThe problem this solves.
Customer-data cleaning, portfolio analysis, KYC, and fraud-check workflows process big lists of addresses. batch_geocode is one POST instead of a thousand, with per-row confidence for quality filtering and typed errors so failed rows route to the right exception handler.
What comes back in the response.
- Up to 1,000 addresses per request.
- Output array indexes align with input, so merging back into a CSV or DataFrame is trivial.
- Successful rows: coordinates plus structured components.
- Failed rows: typed error (timeout, upstream_unavailable, rate_limited, invalid_input).
- Pair with parse_address upstream to lift match rates on dirty input.
Call it from your backend.
Predictable HTTP. JSON in, JSON out. One auth header. Use it from any backend, edge function, or script.
curl -X POST https://api.footstep.ai/v1/geocoding/batch \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{ ... }'Related capabilities.
geocodeTurn an address, landmark, or place name into coordinates. Returns ranked candidates with confidence scores.
parse_addressFree-text in, structured out. Fixes typos, expands abbreviations, infers missing fields, and scores confidence.
reverse_geocodeGiven a coordinate, return the address or place label. Useful for labelling pins and incident reports.
Ready to call it?
£5 free credit on signup. One auth header, every major runtime.