Outscraper API Docs

/google-maps-search

Returns places from Google Maps based on a given search query (or many queries). The results from searches are the same as you would see by visiting a regular Google Maps site. Ho…

GoogleBusinesses & POI
↗ Open in API Explorer
GET
GoogleBusinesses & POI

Returns places from Google Maps based on a given search query (or many queries).

The results from searches are the same as you would see by visiting a regular Google Maps site. However, in most cases, it's important to use locations inside queries (e.g., bars, NY, USA) as the IP addresses of Outscraper's servers might be located in different countries.

In case no places were found by your search criteria, your search request will consume the usage of one place.

This endpoint is optimized for fast responses and can be used as a real-time API. Set the limit parameter to 10 to achieve the maximum response speed.

Request

Endpoint: GET https://api.outscraper.cloud/google-maps-search

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query string Yes The parameter defines the query you want to search. You can use anything that you would use on a regular Google Maps site. Additionally, you can use google_id (feature_id), place_id, or CID. The example of valid queries: Real estate agency, Rome, Italy, The NoMad Restaurant, NY, USA, restaurants, Brooklyn 11203, 0x886916e8bc273979:0x5141fcb11460b226, ChIJrZhup4lZwokRUr_5sLoFlDw, etc. It supports batching by sending arrays with up to 1000 queries (e.g., query=text1&query=text2&query=text3). It allows multiple queries to be sent in one request and save on network latency time. You might want to check out the web application to play with locations and categories that we would suggest. Restaurants, Manhattan, NY, US -
limit query integer Yes The parameter specifies the limit of organizations to take from one query search. There are no more than 500 places per one query search on Google Maps. For densely populated areas you might want to split your query into subqueries in order to get all the places inside. (e.g., restaurants, Brooklyn 11211, restaurants, Brooklyn 11215). 25 default 500
dropDuplicates query boolean No The parameter specifies whether the bot will drop the same organizations from different queries. It makes sense when you use batching and send multiple queries inside one request. Using the parameter combines results from each query inside one big array ({'data': [...]} instead of {'data': [[...], [...], [...]]}). If the amount of ignored rows are less than 5,000% of what was actually extracted, you won't be billed for ignored records. - default false
totalLimit query integer No The parameter specifies the total limit of organizations to take from many queries. Usefull when using dropDuplicates parameter. It allows you to limit the total amount of organizations returned from all queries inside one request. - -
coordinates query string No The parameter defines the coordinates of the location where you want your query to be applied. It has to be constructed in the next sequence: latitude + , + longitude (41.3954381,2.1628662). Often, you can find this value while visiting Google Maps. - -
skipPlaces query integer No Skip first N places from a query search, where N should be multiple to 20 (e.g. 0, 20, ... 500). Used for pagination. - default 0
language query string enum No The parameter specifies the language to use for website. - default en, allowed en, de, es, es-419, fr, hr, it, nl, …
region query string enum No The parameter specifies the country to use for website. It's recommended to use it for a better search experience. - allowed AF, AL, DZ, AS, AD, AO, AI, AG, …
enrichment query array<string> No The parameter defines an enrichment or enrichments (e.g., enrichment=enrichment1&enrichment=enrichment2&enrichment=enrichment3) you want to apply to the results. Available values: contacts_n_leads — Contacts & Leads Enrichment: finds emails, social links, phones, and other contacts from websites; emails_validator_service — Email Address Verifier: validates emails, checks deliverability, filters out blacklists, spam traps, and complainers, while significantly reducing your bounce rate; company_websites_finder - Company Website Finder: finds company websites based on business names; disposable_email_checker — Disposable Emails Checker: checks origins of email addresses (disposable, free, or corporate); company_insights_service — Company Insights: Finds company firmographics such as revenue, size, founding year, public status, etc.; phones_enricher_service — Phone Numbers Enricher: returns phones carrier data (name/type), validates phones, ensures messages deliverability, trustpilot_service — Trustpilot Scraper: returns data from a list of businesses, whitepages_phones - Phone Identity Finder: returns insights about phone number owners (name, address, etc.); ai_chain_info - Chain Info: identifies if a business is part of a chain, adding a true/false indication to your data for smarter targeting. Using enrichments increases the time of the response. You might want to use the async=true parameter to avoid getting timeouts. - -
fields query string No The parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields. Use &fields=query,name to return only the specific ones. - -
async query boolean Yes The parameter defines the way you want to submit your task to Outscraper. It can be set to false to open an HTTP connection and keep it open until you got your results, or true (default) to just submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes) with the Request Results endpoint. Each response is available for 4 hours after a request has been completed. A good practice is to send async requests and start checking the results after the estimated execution time. Check out this Python implementation as an example. As most of the requests take some time to be executed the async=true option is preferred to avoid HTTP requests timeouts. - default true
ui query boolean No The parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async parameter to true. - default false
format query array<string enum> No The parameter defines the format of the output data. Using this parameter overwrites the ui parameter to true. - -
webhook query string No The parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations. - -

Responses

200

application/json

The response contains the status of the request and data. Data is an array where each element represents a response for a single query from the request.

{
  "id": "your-request-id",
  "status": "Success",
  "data": [
    [
      {
        "query": "restaurants, Manhattan, NY, USA",
        "name": "Upland",
        "place_id": "ChIJWVD7FadZwokRs_pS6XY7VOU",
        "google_id": "0x89c259a715fb5059:0xe5543b76e952fab3",
        "full_address": "345 Park Ave S, New York, NY 10010",
        "borough": "Manhattan",
        "street": "345 Park Ave S",
        "postal_code": "10010",
        "area_service": false,
        "country_code": "US",
        "country": "United States of America",
        "city": "New York",
        "us_state": "New York",
        "state": "New York",
        "plus_code": null,
        "latitude": 40.7419313,
        "longitude": -73.984644,
        "time_zone": "America/New_York",
        "popular_times": null,
        "site": "https://uplandnyc.com/?utm_source=Google+My+Business&utm_medium=Website+Button",
        "phone": "+1 212-686-1006",
        "type": "Californian restaurant",
        "logo": "https://lh4.googleusercontent.com/-zvSnhN_Mek4/AAAAAAAAAAI/AAAAAAAAAAA/XHbA606mawk/s44-p-k-no-ns-nd/photo.jpg",
        "description": "Spacious, casually chic brasserie with hearty dishes featuring Californian & Italian influences.",
        "located_in": null,
        "located_google_id": null,
        "category": "Californian restaurant",
        "subtypes": "Californian restaurant, American restaurant, Bar, Italian restaurant, Takeout Restaurant, Restaurant",
        "posts": null,
        "reviews_tags": null,
        "rating": 4.5,
        "reviews": 1766,
        "photos_count": 4255,
        "cid": "16524898314635901619",
        "reviews_link": "https://search.google.com/local/reviews?placeid=ChIJWVD7FadZwokRs_pS6XY7VOU&q=restaurants,+Manhattan,+NY,+USA&authuser=0&hl=en&gl=US",
        "reviews_id": "-1921845759073649997",
        "photo": "https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w800-h500-k-no",
        "street_view": "https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w1600-h1000-k-no",
        "working_hours_old_format": "Monday: 11:30 AM-3 PM,5-10 PM | Tuesday: 11:30 AM-3 PM,5-10 PM | Wednesday: 11:30 AM-3 PM,5-10 PM | Thursday: 11:30 AM-3 PM,5-10 PM | Friday: 11:30 AM-3 PM,5-11 PM | Saturday: 10 AM-3 PM,5-11 PM | Sunday: 10 AM-3 PM,5-9 PM",
        "working_hours": {
          "Monday": "11:30 AM-3 PM,5-10 PM",
          "Tuesday": "11:30 AM-3 PM,5-10 PM",
          "Wednesday": "11:30 AM-3 PM,5-10 PM",
          "Thursday": "11:30 AM-3 PM,5-10 PM",
          "Friday": "11:30 AM-3 PM,5-11 PM",
          "Saturday": "10 AM-3 PM,5-11 PM",
          "Sunday": "10 AM-3 PM,5-9 PM"
        },
        "other_hours": [
          {
            "lunch": {
              "Monday": "11:30 AM-3 PM",
              "Tuesday": "11:30 AM-3 PM",
              "Wednesday": "11:30 AM-3 PM",
              "Thursday": "11:30 AM-3 PM",
              "Friday": "11:30 AM-3 PM",
              "Saturday": "Closed",
              "Sunday": "Closed"
            }
          },
          {
            "dinner": {
              "Monday": "5-10 PM",
              "Tuesday": "5-10 PM",
              "Wednesday": "5-10 PM",
              "Thursday": "5-10 PM",
              "Friday": "5-10 PM",
              "Saturday": "5-10 PM",
              "Sunday": "5-9 PM"
            }
          },
          {
            "delivery": {
              "Monday": "11:30 AM-3:30 PM,5-10 PM",
              "Tuesday": "11:30 AM-3:30 PM,5-10 PM",
              "Wednesday": "11:30 AM-3:30 PM,5-10 PM",
              "Thursday": "11:30 AM-3:30 PM,5-10 PM",
              "Friday": "Closed",
              "Saturday": "Closed",
              "Sunday": "11 AM-3 PM,5-10 PM"
            }
          },
          {
            "takeout": {
              "Monday": "11:30 AM-3:30 PM,5-10 PM",
              "Tuesday": "11:30 AM-3:30 PM,5-10 PM",
              "Wednesday": "11:30 AM-3:30 PM,5-10 PM",
              "Thursday": "11:30 AM-3:30 PM,5-10 PM",
              "Friday": "Closed",
              "Saturday": "Closed",
              "Sunday": "11 AM-3 PM,5-10 PM"
            }
          },
          {
            "brunch": {
              "Monday": "Closed",
              "Tuesday": "Closed",
              "Wednesday": "Closed",
              "Thursday": "Closed",
              "Friday": "Closed",
              "Saturday": "10 AM-3 PM",
              "Sunday": "10 AM-3 PM"
            }
          }
        ],
        "business_status": "OPERATIONAL",
        "about": {
          "Service options": {
            "Delivery": true,
            "Takeout": true,
            "Dine-in": true
          },
          "Highlights": {
            "Great coffee": true,
            "Great dessert": true,
            "Great tea selection": true
          },
          "Popular for": {
            "Lunch": true,
            "Dinner": true,
            "Solo dining": true
          },
          "Accessibility": {
            "Wheelchair accessible entrance": true,
            "Wheelchair accessible restroom": true,
            "Wheelchair accessible seating": true,
            "Wheelchair accessible parking lot": false
          },
          "Offerings": {
            "Alcohol": true,
            "Beer": true,
            "Cocktails": true,
            "Coffee": true,
            "Comfort food": true,
            "Hard liquor": true,
            "Healthy options": true,
            "Late-night food": true,
            "Small plates": true,
            "Vegetarian options": true,
            "Wine": true
          },
          "Dining options": {
            "Brunch": true,
            "Lunch": true,
            "Dinner": true,
            "Dessert": true,
            "Seating": true
          },
          "Amenities": {
            "Bar onsite": true,
            "High chairs": true,
            "Restroom": true,
            "Wi-Fi": true
          },
          "Atmosphere": {
            "Romantic": true,
            "Upscale": true
          },
          "Crowd": {
            "Family-friendly": true,
            "Groups": true,
            "LGBTQ+ friendly": true,
            "Tourists": true,
            "Transgender safespace": true
          },
          "Planning": {
            "Lunch reservations recommended": true,
            "Dinner reservations recommended": true,
            "Accepts reservations": true,
            "Usually a wait": true
          },
          "Payments": {
            "Debit cards": true,
            "Credit cards": true
          },
          "Other": {
            "LGBTQ+ friendly": true
          }
        },
        "range": "$$$",
        "reviews_per_score": {
          "1": 50,
          "2": 35,
          "3": 113,
          "4": 394,
          "5": 1174
        },
        "reservation_links": [
          "https://resy.com/cities/ny/upland",
          "https://uplandnyc.com/?utm_source=Google%20My%20Business&utm_medium=Reservation%20Button"
        ],
        "booking_appointment_link": "https://resy.com/cities/ny/upland",
        "menu_link": null,
        "order_links": null,
        "owner_id": "111762591187585073824",
        "verified": true,
        "owner_title": "Upland",
        "owner_link": "https://www.google.com/maps/contrib/111762591187585073824",
        "location_link": "https://www.google.com/maps/place/Upland/@40.7419313,-73.984644,14z/data=!4m8!1m2!2m1!1sUpland!3m4!1s0x89c259a715fb5059:0xe5543b76e952fab3!8m2!3d40.7419313!4d-73.984644"
      },
      {
        "query": "restaurants, Manhattan, NY, USA",
        "name": "Scarpetta",
        "place_id": "ChIJt8W7n79ZwokRsyXs3QDbE3o",
        "google_id": "0x89c259bf9fbbc5b7:0x7a13db00ddec25b3",
        "full_address": "88 Madison Ave, New York, NY 10016",
        "borough": "Manhattan",
        "street": "88 Madison Ave",
        "postal_code": "10016",
        "area_service": false,
        "country_code": "US",
        "country": "United States of America",
        "city"…

202

application/json

The response contains a request ID that can be used to fetch results by using Request Results endpoint. Each response is available for 4 hours after a request has been completed.

{
  "id": "your-request-id",
  "status": "Pending",
  "results_location": "https://api.outscraper.cloud/requests/your-request-id"
}

204

application/json

The request was finished with failure and has no results.

{
  "id": "your-request-id",
  "status": "Failure"
}

401

application/json

Wrong or missing API Key (token).

{
  "error": true,
  "errorMessage": "401 Unauthorized: The server could not verify that you are authorized to access the URL requested. You either supplied the wrong credentials (e.g. a bad password), or your browser doesn't understand how to supply the credentials required."
}

402

application/json

Past due invoices or a payment method not connected.

{
  "error": true,
  "errorMessage": "Please close past due invoices or verify your card information is correct."
}

422

application/json

Wrong query url parameters.

{
  "error": true,
  "errorMessage": "422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors."
}

Code Samples

cURL

curl -X GET "https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3&async=false" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3" -H  "X-API-KEY: YOUR-API-KEY"

Python

from outscraper import OutscraperClient

api_client = OutscraperClient(api_key='YOUR-API-KEY')
results = api_client.google_maps_search('restaurants, Manhattan, NY, USA', limit=3)
POST

Google Places (bigger payload capabilities)

GoogleBusinesses & POI

Returns places from Google Maps based on a given search query (or many queries).

The results from searches are the same as you would see by visiting a regular Google Maps site. However, in most cases, it's important to use locations inside queries (e.g., bars, NY, USA) as the IP addresses of Outscraper's servers might be located in different countries.

In case no places were found by your search criteria, your search request will consume the usage of one place.

This endpoint is optimized for fast responses and can be used as a real-time API. Set the limit parameter to 10 to achieve the maximum response speed.

The POST endpoint is identical to GET and made to support a bigger payload, such as when sending a large number of queries.

Request

Endpoint: POST https://api.outscraper.cloud/google-maps-search

Parameters

NameInTypeRequiredDescriptionExampleConstraints
query query string Yes The parameter defines the query you want to search. You can use anything that you would use on a regular Google Maps site. Additionally, you can use google_id (feature_id), place_id, or CID. The example of valid queries: Real estate agency, Rome, Italy, The NoMad Restaurant, NY, USA, restaurants, Brooklyn 11203, 0x886916e8bc273979:0x5141fcb11460b226, ChIJrZhup4lZwokRUr_5sLoFlDw, etc. It supports batching by sending arrays with up to 1000 queries (e.g., query=text1&query=text2&query=text3). It allows multiple queries to be sent in one request and save on network latency time. You might want to check out the web application to play with locations and categories that we would suggest. Restaurants, Manhattan, NY, US -
limit query integer Yes The parameter specifies the limit of organizations to take from one query search. There are no more than 500 places per one query search on Google Maps. For densely populated areas you might want to split your query into subqueries in order to get all the places inside. (e.g., restaurants, Brooklyn 11211, restaurants, Brooklyn 11215). 25 default 500
dropDuplicates query boolean No The parameter specifies whether the bot will drop the same organizations from different queries. It makes sense when you use batching and send multiple queries inside one request. Using the parameter combines results from each query inside one big array ({'data': [...]} instead of {'data': [[...], [...], [...]]}). If the amount of ignored rows are less than 5,000% of what was actually extracted, you won't be billed for ignored records. - default false
totalLimit query integer No The parameter specifies the total limit of organizations to take from many queries. Usefull when using dropDuplicates parameter. It allows you to limit the total amount of organizations returned from all queries inside one request. - -
coordinates query string No The parameter defines the coordinates of the location where you want your query to be applied. It has to be constructed in the next sequence: latitude + , + longitude (41.3954381,2.1628662). Often, you can find this value while visiting Google Maps. - -
skipPlaces query integer No Skip first N places from a query search, where N should be multiple to 20 (e.g. 0, 20, ... 500). Used for pagination. - default 0
language query string enum No The parameter specifies the language to use for website. - default en, allowed en, de, es, es-419, fr, hr, it, nl, …
region query string enum No The parameter specifies the country to use for website. It's recommended to use it for a better search experience. - allowed AF, AL, DZ, AS, AD, AO, AI, AG, …
enrichment query array<string> No The parameter defines an enrichment or enrichments (e.g., enrichment=enrichment1&enrichment=enrichment2&enrichment=enrichment3) you want to apply to the results. Available values: contacts_n_leads — Contacts & Leads Enrichment: finds emails, social links, phones, and other contacts from websites; emails_validator_service — Email Address Verifier: validates emails, checks deliverability, filters out blacklists, spam traps, and complainers, while significantly reducing your bounce rate; company_websites_finder - Company Website Finder: finds company websites based on business names; disposable_email_checker — Disposable Emails Checker: checks origins of email addresses (disposable, free, or corporate); company_insights_service — Company Insights: Finds company firmographics such as revenue, size, founding year, public status, etc.; phones_enricher_service — Phone Numbers Enricher: returns phones carrier data (name/type), validates phones, ensures messages deliverability, trustpilot_service — Trustpilot Scraper: returns data from a list of businesses, whitepages_phones - Phone Identity Finder: returns insights about phone number owners (name, address, etc.); ai_chain_info - Chain Info: identifies if a business is part of a chain, adding a true/false indication to your data for smarter targeting. Using enrichments increases the time of the response. You might want to use the async=true parameter to avoid getting timeouts. - -
fields query string No The parameter defines which fields you want to include with each item returned in the response. By default, it returns all fields. Use &fields=query,name to return only the specific ones. - -
async query boolean Yes The parameter defines the way you want to submit your task to Outscraper. It can be set to false to open an HTTP connection and keep it open until you got your results, or true (default) to just submit your requests to Outscraper and retrieve them later (usually within 1-3 minutes) with the Request Results endpoint. Each response is available for 4 hours after a request has been completed. A good practice is to send async requests and start checking the results after the estimated execution time. Check out this Python implementation as an example. As most of the requests take some time to be executed the async=true option is preferred to avoid HTTP requests timeouts. - default true
ui query boolean No The parameter defines whether a task will be executed as a UI task. This is commonly used when you want to create a regular platform task with API. Using this parameter overwrites the async parameter to true. - default false
format query array<string enum> No The parameter defines the format of the output data. Using this parameter overwrites the ui parameter to true. - -
webhook query string No The parameter defines the URL address (callback) to which Outscraper will create a POST request with a JSON body once a task/request is finished. Using this parameter overwrites the webhook from integrations. - -

Responses

200

application/json

The response contains the status of the request and data. Data is an array where each element represents a response for a single query from the request.

{
  "id": "your-request-id",
  "status": "Success",
  "data": [
    [
      {
        "query": "restaurants, Manhattan, NY, USA",
        "name": "Upland",
        "place_id": "ChIJWVD7FadZwokRs_pS6XY7VOU",
        "google_id": "0x89c259a715fb5059:0xe5543b76e952fab3",
        "full_address": "345 Park Ave S, New York, NY 10010",
        "borough": "Manhattan",
        "street": "345 Park Ave S",
        "postal_code": "10010",
        "area_service": false,
        "country_code": "US",
        "country": "United States of America",
        "city": "New York",
        "us_state": "New York",
        "state": "New York",
        "plus_code": null,
        "latitude": 40.7419313,
        "longitude": -73.984644,
        "time_zone": "America/New_York",
        "popular_times": null,
        "site": "https://uplandnyc.com/?utm_source=Google+My+Business&utm_medium=Website+Button",
        "phone": "+1 212-686-1006",
        "type": "Californian restaurant",
        "logo": "https://lh4.googleusercontent.com/-zvSnhN_Mek4/AAAAAAAAAAI/AAAAAAAAAAA/XHbA606mawk/s44-p-k-no-ns-nd/photo.jpg",
        "description": "Spacious, casually chic brasserie with hearty dishes featuring Californian & Italian influences.",
        "located_in": null,
        "located_google_id": null,
        "category": "Californian restaurant",
        "subtypes": "Californian restaurant, American restaurant, Bar, Italian restaurant, Takeout Restaurant, Restaurant",
        "posts": null,
        "reviews_tags": null,
        "rating": 4.5,
        "reviews": 1766,
        "photos_count": 4255,
        "cid": "16524898314635901619",
        "reviews_link": "https://search.google.com/local/reviews?placeid=ChIJWVD7FadZwokRs_pS6XY7VOU&q=restaurants,+Manhattan,+NY,+USA&authuser=0&hl=en&gl=US",
        "reviews_id": "-1921845759073649997",
        "photo": "https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w800-h500-k-no",
        "street_view": "https://lh5.googleusercontent.com/p/AF1QipPFzGn4Ie2huHtDmrAmxl0GkSIp5rrXipoxPF55=w1600-h1000-k-no",
        "working_hours_old_format": "Monday: 11:30 AM-3 PM,5-10 PM | Tuesday: 11:30 AM-3 PM,5-10 PM | Wednesday: 11:30 AM-3 PM,5-10 PM | Thursday: 11:30 AM-3 PM,5-10 PM | Friday: 11:30 AM-3 PM,5-11 PM | Saturday: 10 AM-3 PM,5-11 PM | Sunday: 10 AM-3 PM,5-9 PM",
        "working_hours": {
          "Monday": "11:30 AM-3 PM,5-10 PM",
          "Tuesday": "11:30 AM-3 PM,5-10 PM",
          "Wednesday": "11:30 AM-3 PM,5-10 PM",
          "Thursday": "11:30 AM-3 PM,5-10 PM",
          "Friday": "11:30 AM-3 PM,5-11 PM",
          "Saturday": "10 AM-3 PM,5-11 PM",
          "Sunday": "10 AM-3 PM,5-9 PM"
        },
        "other_hours": [
          {
            "lunch": {
              "Monday": "11:30 AM-3 PM",
              "Tuesday": "11:30 AM-3 PM",
              "Wednesday": "11:30 AM-3 PM",
              "Thursday": "11:30 AM-3 PM",
              "Friday": "11:30 AM-3 PM",
              "Saturday": "Closed",
              "Sunday": "Closed"
            }
          },
          {
            "dinner": {
              "Monday": "5-10 PM",
              "Tuesday": "5-10 PM",
              "Wednesday": "5-10 PM",
              "Thursday": "5-10 PM",
              "Friday": "5-10 PM",
              "Saturday": "5-10 PM",
              "Sunday": "5-9 PM"
            }
          },
          {
            "delivery": {
              "Monday": "11:30 AM-3:30 PM,5-10 PM",
              "Tuesday": "11:30 AM-3:30 PM,5-10 PM",
              "Wednesday": "11:30 AM-3:30 PM,5-10 PM",
              "Thursday": "11:30 AM-3:30 PM,5-10 PM",
              "Friday": "Closed",
              "Saturday": "Closed",
              "Sunday": "11 AM-3 PM,5-10 PM"
            }
          },
          {
            "takeout": {
              "Monday": "11:30 AM-3:30 PM,5-10 PM",
              "Tuesday": "11:30 AM-3:30 PM,5-10 PM",
              "Wednesday": "11:30 AM-3:30 PM,5-10 PM",
              "Thursday": "11:30 AM-3:30 PM,5-10 PM",
              "Friday": "Closed",
              "Saturday": "Closed",
              "Sunday": "11 AM-3 PM,5-10 PM"
            }
          },
          {
            "brunch": {
              "Monday": "Closed",
              "Tuesday": "Closed",
              "Wednesday": "Closed",
              "Thursday": "Closed",
              "Friday": "Closed",
              "Saturday": "10 AM-3 PM",
              "Sunday": "10 AM-3 PM"
            }
          }
        ],
        "business_status": "OPERATIONAL",
        "about": {
          "Service options": {
            "Delivery": true,
            "Takeout": true,
            "Dine-in": true
          },
          "Highlights": {
            "Great coffee": true,
            "Great dessert": true,
            "Great tea selection": true
          },
          "Popular for": {
            "Lunch": true,
            "Dinner": true,
            "Solo dining": true
          },
          "Accessibility": {
            "Wheelchair accessible entrance": true,
            "Wheelchair accessible restroom": true,
            "Wheelchair accessible seating": true,
            "Wheelchair accessible parking lot": false
          },
          "Offerings": {
            "Alcohol": true,
            "Beer": true,
            "Cocktails": true,
            "Coffee": true,
            "Comfort food": true,
            "Hard liquor": true,
            "Healthy options": true,
            "Late-night food": true,
            "Small plates": true,
            "Vegetarian options": true,
            "Wine": true
          },
          "Dining options": {
            "Brunch": true,
            "Lunch": true,
            "Dinner": true,
            "Dessert": true,
            "Seating": true
          },
          "Amenities": {
            "Bar onsite": true,
            "High chairs": true,
            "Restroom": true,
            "Wi-Fi": true
          },
          "Atmosphere": {
            "Romantic": true,
            "Upscale": true
          },
          "Crowd": {
            "Family-friendly": true,
            "Groups": true,
            "LGBTQ+ friendly": true,
            "Tourists": true,
            "Transgender safespace": true
          },
          "Planning": {
            "Lunch reservations recommended": true,
            "Dinner reservations recommended": true,
            "Accepts reservations": true,
            "Usually a wait": true
          },
          "Payments": {
            "Debit cards": true,
            "Credit cards": true
          },
          "Other": {
            "LGBTQ+ friendly": true
          }
        },
        "range": "$$$",
        "reviews_per_score": {
          "1": 50,
          "2": 35,
          "3": 113,
          "4": 394,
          "5": 1174
        },
        "reservation_links": [
          "https://resy.com/cities/ny/upland",
          "https://uplandnyc.com/?utm_source=Google%20My%20Business&utm_medium=Reservation%20Button"
        ],
        "booking_appointment_link": "https://resy.com/cities/ny/upland",
        "menu_link": null,
        "order_links": null,
        "owner_id": "111762591187585073824",
        "verified": true,
        "owner_title": "Upland",
        "owner_link": "https://www.google.com/maps/contrib/111762591187585073824",
        "location_link": "https://www.google.com/maps/place/Upland/@40.7419313,-73.984644,14z/data=!4m8!1m2!2m1!1sUpland!3m4!1s0x89c259a715fb5059:0xe5543b76e952fab3!8m2!3d40.7419313!4d-73.984644"
      },
      {
        "query": "restaurants, Manhattan, NY, USA",
        "name": "Scarpetta",
        "place_id": "ChIJt8W7n79ZwokRsyXs3QDbE3o",
        "google_id": "0x89c259bf9fbbc5b7:0x7a13db00ddec25b3",
        "full_address": "88 Madison Ave, New York, NY 10016",
        "borough": "Manhattan",
        "street": "88 Madison Ave",
        "postal_code": "10016",
        "area_service": false,
        "country_code": "US",
        "country": "United States of America",
        "city"…

202

application/json

The response contains a request ID that can be used to fetch results by using Request Results endpoint. Each response is available for 4 hours after a request has been completed.

{
  "id": "your-request-id",
  "status": "Pending",
  "results_location": "https://api.outscraper.cloud/requests/your-request-id"
}

204

application/json

The request was finished with failure and has no results.

{
  "id": "your-request-id",
  "status": "Failure"
}

401

application/json

Wrong or missing API Key (token).

{
  "error": true,
  "errorMessage": "401 Unauthorized: The server could not verify that you are authorized to access the URL requested. You either supplied the wrong credentials (e.g. a bad password), or your browser doesn't understand how to supply the credentials required."
}

402

application/json

Past due invoices or a payment method not connected.

{
  "error": true,
  "errorMessage": "Please close past due invoices or verify your card information is correct."
}

422

application/json

Wrong query url parameters.

{
  "error": true,
  "errorMessage": "422 Unprocessable Entity: The request was well-formed but was unable to be followed due to semantic errors."
}

Code Samples

cURL

curl -X POST https://api.outscraper.cloud/google-maps-search -d '{"query": ["restaurants Manhattan NY USA"], "limit": 3, "async": false}' -H "Content-Type: application/json" -H  "X-API-KEY: YOUR-API-KEY"

cURL (async)

curl -X GET "https://api.outscraper.cloud/google-maps-search?query=restaurants%2C%20Manhattan%2C%20NY%2C%20USA&limit=3" -H  "X-API-KEY: YOUR-API-KEY"

Related Endpoints

POST
/businesses

Retrieve business records with optional enrichment data. This endpoint provides access to millions of business listings with support for pagination and selective data enrichment.…

Businesses & POIBusiness Data API