--- title: "Google Maps API: JSON data, 10 endpoints, 1 credit per call" description: "Get Google Maps data as structured JSON with one API key: advanced search, simple search, business details and contributor reviews. Free credits every month." url: https://perceptlayer.com/apis/google-maps --- [APIs](https://perceptlayer.com/apis) / [Search engines](https://perceptlayer.com/verticals/search) / Google Maps 1 credit per call 10 endpoints 28 datapoints # Google Maps API Get Google Maps data as structured JSON with one API key: advanced search, simple search, business details and contributor reviews. Free credits every month. [Get a free API key](https://perceptlayer.com/signup) Run it below Google Maps GET /v1/google-maps/simple-search?query=restaurants+in+new+york ``` { "items": [ { "name": "Altair Restaurant NYC", "review_count": 1225, "rating": 4.8, "website": "https://www.altairnyc.com/", "domain": "altairnyc.com", "latitude": 40.7556565, "longitude": -73.9936282, "business_id": "0x89c2591598891521:0x4ebcde18610e64", "subtypes": [ "New American restaurant", "Restaurant" ], "district": "Manhattan", "full_address": "351 W 38th St, New York, NY 10018, United States", "timezone": "America/New_York", "owner_id": "107444272980109255975", "owner_name": "Altair Restaurant NYC (Owner)", "owner_link": "https://maps.google.com/maps/contrib/107444272980109255975", "order_link": "https://www.google.com/maps/reserve/v/dine/c/x4b2hrHtPNo?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2…", "google_mid": "/g/11l1ncyn3_", "phone_numbers": [ "+1 929-561-6131" ], "place_id": "ChIJIRWJmBVZwokRZA5hGN68TgA=", "photos_sample": [ { "photo_id": "CIABIhBYc3BDxCaQc_uFKXR3OdWZ", "photo_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLclIWNWEpHAS_ZfLzHbhgdk-n-vOqv2qRY9cg2EiOVnCBtZi80Si0nxJWS1y-q7erapIjJZ1lJeeR51ptN57lu8jInPLk371gnTlvHosWLJAHxRBUNaa0wp5Sus3H7K-Nm4ESp4yEDtLWrk=w86-h114-k-no", "photo_url_large": "https://lh5.googleusercontent.com/p/CIABIhBYc3BDxCaQc_uFKXR3OdWZ?w3024-h3024-k-no", "latitude": 40.75565649230674, "longitude": -73.99362817600482, "type": "photo" } ], "neighborhood": "Manhattan", "street_address_alt": "351 W 38th St", "street_address_full": "351 W 38th St", "city": "New York", "zip_code": "10018", "state": "New York", "country_code": "US", "attributes": { "accessibility": { "Wheelchair-accessible entrance": true, "Wheelchair-accessible seating": true, "Wheelchair-accessible toilet": true } } }, { "name": "Lulla NYC", "review_count": 1571, "rating": 4.8, "website": "http://www.lullanyc.com/", "domain": "lullanyc.com", "latitude": 40.7441117, "longitude": -73.99299409999999, "business_id": "0x89c259bf22ca32bd:0x35d818a560181b20", "subtypes": [ "Italian restaurant", "Restaurant" ], "district": "Manhattan", "full_address": "113 W 24th St, New York, NY 10011, United States", "timezone": "America/New_York", "owner_id": "114181353879818223269", "owner_name": "Lulla NYC (Owner)", "owner_link": "https://maps.google.com/maps/contrib/114181353879818223269", "order_link": "https://www.google.com/maps/reserve/v/dine/c/Jdtwk-1WpiY?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2…", "google_mid": "/g/11ks6mqp8n", "phone_numbers": [ "+1 929-588-8556" ], "place_id": "ChIJvTLKIr9ZwokRIBsYYKUY2DU=", "photos_sample": [ { "photo_id": "CIHM0ogKEICAgIDvycftjQE", "photo_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLc0kk7d1qFcNbV0VXBb0neL3nT1j-VleIt2_krC3AKshr8xev_546j5whP6m60MyrSVwsRaQ8Tk1Z6rzorgyCNyn7Kz6OwF4f9Y45KK2sm_7dh9h4PsBRMiTdtwsnqskLopaaJfwA=w86-h107-k-no", "photo_url_large": "https://lh5.googleusercontent.com/p/CIHM0ogKEICAgIDvycftjQE?w3024-h3024-k-no", "latitude": 40.744111702947535, "longitude": -73.99299412410348, "type": "photo" } ], "neighborhood": "Manhattan", "street_address_alt": "113 W 24th St", "street_address_full": "113 W 24th St", "city": "New York", "zip_code": "10011", "state": "New York", "country_code": "US", "attributes": { "accessibility": { "Wheelchair-accessible entrance": true, "Wheelchair-accessible seating": true, "Wheelchair-accessible toilet": true } } }, { "name": "Manhatta", "review_count": 4127, "rating": 4.7, "website": "https://www.manhattarestaurant.com/restaurant-menu/", "domain": "manhattarestaurant.com", "latitude": 40.707997399999996, "longitude": -74.00888259999999, "business_id": "0x89c25bc797d635a1:0x60b055910436a0a4", "subtypes": [ "New American restaurant", "Fine dining restaurant", "Lounge bar" ], "district": "Manhattan", "full_address": "28 Liberty St 60th floor, New York, NY 10005, United States", "timezone": "America/New_York", "short_description": "High-end New American meals on 60th floor", "full_description": "Set on the 60th floor, this ritzy, high-end restaurant features New American cuisine and city views.", "owner_id": "100843555729741380380", "owner_name": "Manhatta (Owner)", "owner_link": "https://maps.google.com/maps/contrib/100843555729741380380", "order_link": "https://www.google.com/maps/reserve/v/dine/c/pyjjUZqJ9lQ?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2…", "google_mid": "/g/11gh9qhb9q", "phone_numbers": [ "+1 212-230-5788" ], "place_id": "ChIJoTXWl8dbwokRpKA2BJFVsGA=", "photos_sample": [ { "photo_id": "CIHM0ogKEICAgIC8-5qOlAE", "photo_url": "https://lh3.googleusercontent.com/grass-cs/AABkmLc2zafZWAjljFYTzgo3_gXnvE35c6VTSU68XztRX0lD4yTiK8Rky0O4KAro8HQjPM1vMJmebZrji8rOmsLT9meoBNhvBcmhmE-BPd37mCw8CZKvcvjITdXNBu_Q0dxQV_f5UtyunA=w128-h86-k-no", "photo_url_large": "https://lh5.googleusercontent.com/p/CIHM0ogKEICAgIC8-5qOlAE?w3024-h3024-k-no", "latitude": 40.70799741807325, "longitude": -74.00888262951247, "type": "photo" } ], "neighborhood": "Manhattan", "street_address_alt": "28 Liberty St 60th floor", "street_address_full": "28 Liberty St 60th floor", "city": "New York", "zip_code": "10005", "state": "New York", "country_code": "US", "attributes": { "accessibility": { "Wheelchair-accessible entrance": true, "Wheelchair-accessible seating": true, "Wheelchair-accessible toilet": true, "Assistive hearing loop": false, "Wheelchair-accessible car park": false } } } ], "pagination": { "current_page": 0, "total_results": 173, "has_more": false } } ``` 200 OK JSON X-Credits-Used: 1 Recorded from our API and shortened. Sample data ## What one call returns A recorded run of `simple-search`: the fields and shapes you will get, shortened to 3 items. | # | name string | review\_count integer | rating number | website url | domain string | latitude number | longitude number | business\_id string | subtypes string\[\] | district string | full\_address string | timezone string | owner\_id string | owner\_name string | owner\_link url | order\_link url | google\_mid string | phone\_numbers string\[\] | place\_id string | photos\_sample object\[\] | neighborhood string | street\_address\_alt string | street\_address\_full string | city string | zip\_code string | state string | country\_code string | attributes object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | Altair Restaurant NYC | 1225 | 4.8 | https://www.altairnyc.com/ | altairnyc.com | 40.7556565 | \-73.9936282 | 0x89c2591598891521:0x4ebcde18610e64 | \[2 items\] | Manhattan | 351 W 38th St, New York, NY 10018, United States | America/New\_York | 107444272980109255975 | Altair Restaurant NYC (Owner) | https://maps.google.com/maps/contrib/107444272980109255975 | https://www.google.com/maps/reserve/v/dine/c/x4b2hrHtPNo?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu\_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… | /g/11l1ncyn3\_ | \[1 item\] | ChIJIRWJmBVZwokRZA5hGN68TgA= | \[1 item\] | Manhattan | 351 W 38th St | 351 W 38th St | New York | 10018 | New York | US | {1 fields} | | 2 | Lulla NYC | 1571 | 4.8 | http://www.lullanyc.com/ | lullanyc.com | 40.7441117 | \-73.99299409999999 | 0x89c259bf22ca32bd:0x35d818a560181b20 | \[2 items\] | Manhattan | 113 W 24th St, New York, NY 10011, United States | America/New\_York | 114181353879818223269 | Lulla NYC (Owner) | https://maps.google.com/maps/contrib/114181353879818223269 | https://www.google.com/maps/reserve/v/dine/c/Jdtwk-1WpiY?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu\_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… | /g/11ks6mqp8n | \[1 item\] | ChIJvTLKIr9ZwokRIBsYYKUY2DU= | \[1 item\] | Manhattan | 113 W 24th St | 113 W 24th St | New York | 10011 | New York | US | {1 fields} | | 3 | Manhatta | 4127 | 4.7 | https://www.manhattarestaurant.com/restaurant-menu/ | manhattarestaurant.com | 40.707997399999996 | \-74.00888259999999 | 0x89c25bc797d635a1:0x60b055910436a0a4 | \[3 items\] | Manhattan | 28 Liberty St 60th floor, New York, NY 10005, United States | America/New\_York | 100843555729741380380 | Manhatta (Owner) | https://maps.google.com/maps/contrib/100843555729741380380 | https://www.google.com/maps/reserve/v/dine/c/pyjjUZqJ9lQ?source=pa&opi=79508299&hl=en-DK&gei=SL3Yaqu\_H4THwPAPp-aPwQE&ahbb=1&sourceurl=https://www.google.com/search?tbm%3Dmap%26hl%3Den%26pb%3D!4m8!1m3!1d5000!2d11.9373824!3d57.67168!2m3!1f0!2… | /g/11gh9qhb9q | \[1 item\] | ChIJoTXWl8dbwokRpKA2BJFVsGA= | \[1 item\] | Manhattan | 28 Liberty St 60th floor | 28 Liberty St 60th floor | New York | 10005 | New York | US | {1 fields} | Recorded from our API · 3 items shown · 28 datapoints per item GET /v1/google-maps/simple-search?query=restaurants+in+new+york 28 datapoints ### Identity - name string - business\_id string - subtypes string\[\] - google\_mid string - place\_id string ### Contact - website url - domain string - owner\_id string - owner\_name string - owner\_link url - order\_link url - phone\_numbers string\[\] ### Location - latitude number - longitude number - district string - full\_address string - timezone string - neighborhood string - street\_address\_alt string - street\_address\_full string - city string - zip\_code string - state string - country\_code string ### Reputation - review\_count integer - rating number - photos\_sample object\[\] - attributes object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/google-maps/simple-search?query=restaurants+in+new+york" \ -H "X-API-Key: $API_KEY" ``` Google Maps · 10 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/google-maps/advanced-search`](https://perceptlayer.com/apis/google-maps/advanced-search) | `query` `zoom` +8 optional | 1 credit | | [GET `/v1/google-maps/autocomplete`](https://perceptlayer.com/apis/google-maps/autocomplete) | none +6 optional | 1 credit | | [GET `/v1/google-maps/business-details`](https://perceptlayer.com/apis/google-maps/business-details) | `business_id` +2 optional | 1 credit | | [GET `/v1/google-maps/contributor-reviews`](https://perceptlayer.com/apis/google-maps/contributor-reviews) | `contributor_id` +2 optional | 1 credit | | [GET `/v1/google-maps/directions`](https://perceptlayer.com/apis/google-maps/directions) | `origin` `destination` +3 optional | 1 credit | | [GET `/v1/google-maps/photos`](https://perceptlayer.com/apis/google-maps/photos) | `business_id` +2 optional | 1 credit | | [GET `/v1/google-maps/posts`](https://perceptlayer.com/apis/google-maps/posts) | `data_id` +3 optional | 1 credit | | [GET `/v1/google-maps/review`](https://perceptlayer.com/apis/google-maps/review) | `review_id` `business_id` | 1 credit | | [GET `/v1/google-maps/reviews`](https://perceptlayer.com/apis/google-maps/reviews) | `business_id` +7 optional | 1 credit | | [GET `/v1/google-maps/simple-search`](https://perceptlayer.com/apis/google-maps/simple-search) | `query` +6 optional | 1 credit | Overview ## About the Google Maps API ## What you can get The Google Maps API returns advanced search, simple search, business details and contributor reviews as clean JSON. Each successful call costs one credit, and calls that fail are free. Search engines JSON REST MCP ### More search engines APIs [Baidu](https://perceptlayer.com/apis/baidu) [Bing](https://perceptlayer.com/apis/bing) [Brave Search](https://perceptlayer.com/apis/brave) [DuckDuckGo](https://perceptlayer.com/apis/duckduckgo) [Google Events](https://perceptlayer.com/apis/google-events) [Google Finance](https://perceptlayer.com/apis/google-finance) [Google Forums](https://perceptlayer.com/apis/google-forums) [Google Images](https://perceptlayer.com/apis/google-images) [Google Lens](https://perceptlayer.com/apis/google-lens) [Google Local](https://perceptlayer.com/apis/google-local) [Google Local Services](https://perceptlayer.com/apis/google-local-services) [Google News](https://perceptlayer.com/apis/google-news) Use cases ### Build lead lists of local businesses with phone numbers and hours `Use the Google Maps API to build lead lists of local businesses with phone numbers and hours` ### Monitor ratings and reviews for your locations `Use the Google Maps API to monitor ratings and reviews for your locations` ### Map competitors in a neighbourhood `Use the Google Maps API to map competitors in a neighbourhood` FAQ ## Questions **How much does the Google Maps API cost?** Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a separate key for Google Maps?** No. One key works for every API in the catalogue. ## Try the Google Maps API with 1,000 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)