1. Home
  2. Docs
  3. API Docs
  4. Google Maps search API

Google Maps search API

Endpoint allows you to extract the results from Google Maps.

GET: https://api.app.outscraper.com/maps/search

Request parameters

apiKey (required)

API token from the profile page.

query (required)

Parameter defines the query you want to search. You can use anything that you would use in a regular Google Maps search. It supports batching by sending arrays with up to 50 items. It allows multiple queries to be sent in one request and save on network latency time. Example: ?query=restaurants&query=bars.

coordinates

Parameter defines the coordinates to use along with the query. Example: @41.3954381,2.1628662,15.1z

language

(default: en) – Parameter specifies the language to use for Google Maps site.

region

(default: us) – Parameter specifies the country to use for Google Maps site.

limit

(default: 400) – Parameter specifies the limit of organizations to take from one query search.

extractContacts

(default: false) – Parameter specifies whether the bot will scrape additional data (emails, social links, site keywords…) from companies’ websites. It increases the time of the extraction.

async

(default: true) – Parameter defines the way you want to submit your search to OutScraper. It can be set to false to open an HTTP connection and keep it open until you got your search results, or true (default) to just submit your search to OutScraper and retrieve them later (usually a few seconds). In this case, you’ll need to use Requests Archive to retrieve your results.


Example request async:
https://api.app.outscraper.com/maps/search?apiKey=SECRET_API_KEY&query=real estate agency, berlin

Example response async:
{"status":"Pending","id":"32692d16-725c-4e66-b013-95e80e873b7e"}

Example request:
https://api.app.outscraper.com/maps/search?apiKey=SECRET_API_KEY&query=real estate agency, berlin&async=false

Example response:
{
  "status": "Success",
  "data": [
    {
      "name": "Next Estate GmbH",
      "full_address": "Kollwitzstra\u00dfe 38, 10405 Berlin, Germany",
      "borough": "Pankow",
      "street": "Kollwitzstra\u00dfe 38",
      "city": "Berlin",
      "postal_code": "10405",
      "us_state": null,
      "country_code": "DE",
      "country": "Germany",
      "plus_code": "9F4MGCM8+F5",
      "latitude": 52.5337393,
      "longitude": 13.4154784,
      "time_zone": "Europe/Berlin",
      "site": "https://www.next-estate.de/",
      "phone": "+49 30 40301000",
      "type": "Real estate consultant",
      "subtypes": "Real estate consultant, Real estate agency",
      "rating": 4.6,
      "reviews": 42,
      "photos_count": 31,
      "google_id": "0x47a84e025f326e25:0x110d888e0e856f71",
      "place_id": "ChIJJW4yXwJOqEcRcW-FDo6IDRE",
      "reviews_link": "https://www.google.com/search?q=Next+Estate+GmbH,+Kollwitzstra%C3%9Fe+38,+10405+Berlin,+Germany&ludocid=1228788417052372849#lrd=0x47a84e025f326e25:0x110d888e0e856f71,1",
      "reviews_id": "1228788417052372849",
      "photo": "https://lh5.googleusercontent.com/p/AF1QipMXMPz-uBiB5FUMNfZzNpCRgP2k-rGhtxwtX2ot",
      "working_hours": "Sunday: Closed | Monday: 9AM\u20135PM | Tuesday: 9AM\u20135PM | Wednesday: 9AM\u20135PM | Thursday: 9AM\u20135PM | Friday: 9AM\u20135PM | Saturday: 12\u20134PM",
      "reviews_per_score": "1: 4, 2: 0, 3: 1, 4: 1, 5: 36",
      "verified": true,
      "reserving_table_link": null,
      "booking_appointment_link": null,
      "owner_id": "103015253234697768004",
      "owner_link": "https://www.google.com/maps/contrib/103015253234697768004",
      "location_link": "https://www.google.com/maps/place/Next+Estate+GmbH/@52.5337393,13.4154784,14z/data=!4m8!1m2!2m1!1sNext+Estate+GmbH!3m4!1s0x47a84e025f326e25:0x110d888e0e856f71!8m2!3d52.5337393!4d13.4154784"
    },
    ...
    {
      "name": "First Citiz Berlin",
      "full_address": "Pappelallee 11, 10437 Berlin, Germany",
      "borough": "Pankow",
      "street": "Pappelallee 11",
      "city": "Berlin",
      "postal_code": "10437",
      "us_state": null,
      "country_code": "DE",
      "country": "Germany",
      "plus_code": "9F4MGCV7+3P",
      "latitude": 52.5426905,
      "longitude": 13.4143504,
      "time_zone": "Europe/Berlin",
      "site": "https://www.firstcitiz.com/",
      "phone": "+49 30 41717274",
      "type": "Real estate agency",
      "subtypes": "Real estate agency, Property investment, Real estate agents, Real estate appraiser, Real estate consultant",
      "rating": 4.9,
      "reviews": 30,
      "photos_count": 35,
      "google_id": "0x47a852002e244151:0x9917d20b3f8343de",
      "place_id": "ChIJUUEkLgBSqEcR3kODPwvSF5k",
      "reviews_link": "https://www.google.com/search?q=First+Citiz+Berlin,+Pappelallee+11,+10437+Berlin,+Germany&ludocid=11031516758019359710#lrd=0x47a852002e244151:0x9917d20b3f8343de,1",
      "reviews_id": "-7415227315690191906",
      "photo": "https://lh5.googleusercontent.com/p/AF1QipOkAd93sNazMZTD7xSb_ByxPtsSbg8TqP_dhUjf",
      "working_hours": "Sunday: Closed | Monday: 9AM\u20136PM | Tuesday: 9AM\u20136PM | Wednesday: 9AM\u20136PM | Thursday: 9AM\u20136PM | Friday: 9AM\u20136PM | Saturday: Closed",
      "reviews_per_score": "1: 0, 2: 0, 3: 1, 4: 0, 5: 29",
      "verified": true,
      "reserving_table_link": null,
      "booking_appointment_link": null,
      "owner_id": "103775912516045674549",
      "owner_link": "https://www.google.com/maps/contrib/103775912516045674549",
      "location_link": "https://www.google.com/maps/place/First+Citiz+Berlin/@52.5426905,13.4143504,14z/data=!4m8!1m2!2m1!1sFirst+Citiz+Berlin!3m4!1s0x47a852002e244151:0x9917d20b3f8343de!8m2!3d52.5426905!4d13.4143504"
    }
  ]
}