Skip to content
All endpoints

Forward & Reverse Geocoding API for Google Maps

195 COUNTRIES5 Credits / Lookup($0.20–$0.50 / 1,000 geocodes · $1 = 10,000 Credits)

Convert street addresses, postal codes, and commercial landmarks into verified latitude / longitude coordinates and canonical Google place_id (ChIJ...) identifiers across all 195 countries—or reverse-geocode GPS coordinates back into structured street components. Built as a global, cache-friendly alternative to Geocodio and the $5.00/1K Official Google Geocoding API.

1. Forward Geocode

GET /v1/places/search — Address or business name → lat/lng, place_id, phone & website.

2. Reverse Geocode

GET /v1/geocode/reverse — GPS lat, lng → formatted street address, postal code & place_id.

3. Address Autocomplete

GET /v1/places/autocomplete — Sub-second typeahead predictions as users type partial addresses.

1. Forward Geocoding (Address → Coordinates & Place ID)

Pass any street address, postal code, intersection, or business name to GET /v1/places/search with limit=1 (or region=us / region=gb country bias). Unlike US/Canada-only tools like Geocodio, every response includes canonical place_id, numeric cid, and commercial POI metadata when matched.

curl -sS "https://api.placesdataapi.com/v1/places/search?q=350+Fifth+Ave+New+York+NY+10118&limit=1" \
  -H "x-api-key: pd_live_your_api_key"

2. Reverse Geocoding (Lat/Lng → Structured Street Address)

Pass WGS84 lat and lng coordinates to GET /v1/geocode/reverse to resolve rooftop street addresses, postal codes, administrative regions, and Google place_id values for 5 Credits per call.

curl -sS "https://api.placesdataapi.com/v1/geocode/reverse?lat=40.7484405&lng=-73.9856644&language=en" \
  -H "x-api-key: pd_live_your_api_key"

3. Parameter Mapping from Geocodio & Google

Switching from api.geocod.io/v1.7/* or maps.googleapis.com/maps/api/geocode/json takes less than two minutes. Compare full volume pricing on our Geocodio vs PlacesData API benchmark, our 2026 Geocodio Pricing Breakdown (10K, 100K & 1M lookups), or test interactive lookups in the Free Place ID & Coordinate Finder.

OperationGeocodio (geocod.io) / GooglePlacesData API Equivalent
Forward GeocodeGET /v1.7/geocode?q=<addr>GET /v1/places/search?q=<addr>&limit=1 (5 Credits)
Reverse GeocodeGET /v1.7/reverse?q=<lat,lng>GET /v1/geocode/reverse?lat=<lat>&lng=<lng> (5 Credits)
Address TypeaheadNot in Geocodio ($2.83/1K on Google)GET /v1/places/autocomplete?input=<text> (5 Credits)
Country Biascountry=US|CA only (Geocodio)region=<iso2> (195 countries supported)

Frequently Asked Questions

How does PlacesData API compare to Geocodio and Google Geocoding API?
Developers migrating off Geocodio often need international coverage or canonical Google Place IDs (ChIJ...). While Geocodio ($0.50/1K) only covers US and Canada street interpolation without Place IDs or business data, and Official Google Geocoding charges $5.00/1K while restricting database storage, PlacesData API resolves addresses and coordinates across all 195 countries for 5 Credits per lookup ($0.20–$0.50 per 1,000 lookups) with permanent PostgreSQL/CRM storage allowed.
How do I run high-throughput batch geocoding without CSV upload queues?
Instead of uploading static CSV files and polling async jobs, stream concurrent HTTP GET requests directly to /v1/places/search (forward) or /v1/geocode/reverse (reverse). Free Trial keys support 60 RPM / 5 RPS out of the box, scaling up to 600 RPM (15 RPS) on the Business plan ($499/mo), with Dedicated Enterprise Key Pools available for 1,000+ RPM.
Are failed or empty address lookups charged Credits?
Never. Zero-result queries, malformed addresses, and 4xx/5xx responses always cost 0 Credits.
Which endpoint should I use for checkout address typeahead vs backend coordinate geocoding?
Use GET /v1/places/autocomplete (5 Credits / call) for interactive frontend search bars where users type partial street strings, and GET /v1/places/search?q=<address>&limit=1 (5 Credits / record) or GET /v1/geocode/reverse (5 Credits / call) for server-side coordinate, postal code, and ChIJ... Place ID resolution.

Start with 3,000 Free Credits ($0.30 · 600 Geocodes)

Instant API key in 5 seconds · 3,000 Free Credits ($0.30) on sign-up — No Card Required.