curl --request POST \
--url https://api.footstep.ai/v1/geocoding/batch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"items": [
{
"text": "Buckingham Palace, London"
},
{
"text": "Eiffel Tower, Paris"
},
{
"text": "Colosseum, Rome"
}
]
}
'{
"results": [
{
"index": 0,
"results": [
{
"coordinates": {
"lat": 51.5014,
"lng": -0.1419
},
"label": "Buckingham Palace, London, England, United Kingdom",
"name": "Buckingham Palace",
"country": "United Kingdom",
"country_code": "GBR",
"region": "England",
"locality": "London",
"confidence": 0.95,
"place_type": "venue"
}
]
},
{
"index": 1,
"results": [
{
"coordinates": {
"lat": 48.8584,
"lng": 2.2945
},
"label": "Eiffel Tower, Paris, Île-de-France, France",
"name": "Eiffel Tower",
"country": "France",
"country_code": "FRA",
"region": "Île-de-France",
"locality": "Paris",
"confidence": 0.96,
"place_type": "venue"
}
]
},
{
"index": 2,
"results": [
{
"coordinates": {
"lat": 41.8902,
"lng": 12.4922
},
"label": "Colosseum, Rome, Lazio, Italy",
"name": "Colosseum",
"country": "Italy",
"country_code": "ITA",
"region": "Lazio",
"locality": "Rome",
"confidence": 0.97,
"place_type": "venue"
}
]
}
],
"summary": {
"total": 3,
"matched": 3,
"failed": 0
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Geocoding
Batch Geocode
Batch geocode a list of addresses in a single request. Each item can be free text or structured address components. Results are returned per-item with the original index preserved, so failed items don’t break the batch. Use this for spreadsheet imports, database enrichment, or any bulk geocoding task.
POST
/
v1
/
geocoding
/
batch
curl --request POST \
--url https://api.footstep.ai/v1/geocoding/batch \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"items": [
{
"text": "Buckingham Palace, London"
},
{
"text": "Eiffel Tower, Paris"
},
{
"text": "Colosseum, Rome"
}
]
}
'{
"results": [
{
"index": 0,
"results": [
{
"coordinates": {
"lat": 51.5014,
"lng": -0.1419
},
"label": "Buckingham Palace, London, England, United Kingdom",
"name": "Buckingham Palace",
"country": "United Kingdom",
"country_code": "GBR",
"region": "England",
"locality": "London",
"confidence": 0.95,
"place_type": "venue"
}
]
},
{
"index": 1,
"results": [
{
"coordinates": {
"lat": 48.8584,
"lng": 2.2945
},
"label": "Eiffel Tower, Paris, Île-de-France, France",
"name": "Eiffel Tower",
"country": "France",
"country_code": "FRA",
"region": "Île-de-France",
"locality": "Paris",
"confidence": 0.96,
"place_type": "venue"
}
]
},
{
"index": 2,
"results": [
{
"coordinates": {
"lat": 41.8902,
"lng": 12.4922
},
"label": "Colosseum, Rome, Lazio, Italy",
"name": "Colosseum",
"country": "Italy",
"country_code": "ITA",
"region": "Lazio",
"locality": "Rome",
"confidence": 0.97,
"place_type": "venue"
}
]
}
],
"summary": {
"total": 3,
"matched": 3,
"failed": 0
}
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>",
"message": "<string>"
}Authorizations
Your Footstep API key
Body
application/json