Sign inGet a free API key
Menu

APIs / Search engines / Google Maps

1 credit per call10 endpoints28 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 keyRun 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 OKJSONX-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.

#namestringreview_countintegerratingnumberwebsiteurldomainstringlatitudenumberlongitudenumberbusiness_idstringsubtypesstring[]districtstringfull_addressstringtimezonestringowner_idstringowner_namestringowner_linkurlorder_linkurlgoogle_midstringphone_numbersstring[]place_idstringphotos_sampleobject[]neighborhoodstringstreet_address_altstringstreet_address_fullstringcitystringzip_codestringstatestringcountry_codestringattributesobject
1Altair Restaurant NYC12254.8https://www.altairnyc.com/altairnyc.com40.7556565-73.99362820x89c2591598891521:0x4ebcde18610e64[2 items]Manhattan351 W 38th St, New York, NY 10018, United StatesAmerica/New_York107444272980109255975Altair Restaurant NYC (Owner)https://maps.google.com/maps/contrib/107444272980109255975https://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]Manhattan351 W 38th St351 W 38th StNew York10018New YorkUS{1 fields}
2Lulla NYC15714.8http://www.lullanyc.com/lullanyc.com40.7441117-73.992994099999990x89c259bf22ca32bd:0x35d818a560181b20[2 items]Manhattan113 W 24th St, New York, NY 10011, United StatesAmerica/New_York114181353879818223269Lulla NYC (Owner)https://maps.google.com/maps/contrib/114181353879818223269https://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]Manhattan113 W 24th St113 W 24th StNew York10011New YorkUS{1 fields}
3Manhatta41274.7https://www.manhattarestaurant.com/restaurant-menu/manhattarestaurant.com40.707997399999996-74.008882599999990x89c25bc797d635a1:0x60b055910436a0a4[3 items]Manhattan28 Liberty St 60th floor, New York, NY 10005, United StatesAmerica/New_York100843555729741380380Manhatta (Owner)https://maps.google.com/maps/contrib/100843555729741380380https://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]Manhattan28 Liberty St 60th floor28 Liberty St 60th floorNew York10005New YorkUS{1 fields}

Recorded from our API · 3 items shown · 28 datapoints per itemGET /v1/google-maps/simple-search?query=restaurants+in+new+york

28 datapoints

Identity

  • namestring
  • business_idstring
  • subtypesstring[]
  • google_midstring
  • place_idstring

Contact

  • websiteurl
  • domainstring
  • owner_idstring
  • owner_namestring
  • owner_linkurl
  • order_linkurl
  • phone_numbersstring[]

Location

  • latitudenumber
  • longitudenumber
  • districtstring
  • full_addressstring
  • timezonestring
  • neighborhoodstring
  • street_address_altstring
  • street_address_fullstring
  • citystring
  • zip_codestring
  • statestring
  • country_codestring

Reputation

  • review_countinteger
  • ratingnumber
  • photos_sampleobject[]
  • attributesobject

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/google-maps/advanced-search
queryzoom+8 optional
1 credit
GET/v1/google-maps/autocomplete
none+6 optional
1 credit
GET/v1/google-maps/business-details
business_id+2 optional
1 credit
GET/v1/google-maps/contributor-reviews
contributor_id+2 optional
1 credit
GET/v1/google-maps/directions
origindestination+3 optional
1 credit
GET/v1/google-maps/photos
business_id+2 optional
1 credit
GET/v1/google-maps/posts
data_id+3 optional
1 credit
GET/v1/google-maps/review
review_idbusiness_id
1 credit
GET/v1/google-maps/reviews
business_id+7 optional
1 credit
GET/v1/google-maps/simple-search
query+6 optional
1 credit

Overview

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 enginesJSONRESTMCP

More search engines APIs

BaiduBingBrave SearchDuckDuckGoGoogle EventsGoogle FinanceGoogle ForumsGoogle ImagesGoogle LensGoogle LocalGoogle Local ServicesGoogle 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 keyRead the docs