Tutorial: Geocode an address
Turn a street address into coordinates + jurisdiction (county, FIPS, census tract) with one call.
Call it
curl -X POST "https://api.buildwithapi.io/v1/actors/geocode/run-sync-get-dataset-items" \
-H "X-API-Key: vk_live_..." -H "Content-Type: application/json" \
-d '{"address":"1600 Amphitheatre Pkwy, Mountain View, CA"}'
What you get
{
"status": "SUCCEEDED",
"items": [{
"address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043",
"lat": 37.4224, "lng": -122.0841,
"county": "Santa Clara", "state": "CA", "fips": "06085"
}],
"sources": ["https://nominatim.openstreetmap.org/..."]
}
Notes
- Keyless by default (public geocoders). Add a Google Maps key for higher accuracy + Street View enrichment.
- Batch: pass
{"addresses": ["...", "..."]}to geocode many at once. - Pair with the
census-jurisdictionactor for deeper location intelligence.