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.

EndpointWhat it returnsCost
GET/v1/google-maps/advanced-searchAdvanced Search 1 credit
GET/v1/google-maps/autocompleteAutocomplete 1 credit
GET/v1/google-maps/business-detailsBusiness Details 1 credit
GET/v1/google-maps/contributor-reviewsContributor Reviews 1 credit
GET/v1/google-maps/directionsDirections 1 credit
GET/v1/google-maps/photosPhotos 1 credit
GET/v1/google-maps/postsPosts 1 credit
GET/v1/google-maps/reviewReview 1 credit
GET/v1/google-maps/reviewsReviews 1 credit
GET/v1/google-maps/simple-searchSimple Search 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

Track rankings and SERP features for your keywords

Use the Google Maps API to track rankings and SERP features for your keywords

Build lead lists from local results

Use the Google Maps API to build lead lists from local results

Feed fresh search data into research and AI tools

Use the Google Maps API to feed fresh search data into research and AI tools

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