Google Maps Search Scraper

Scrape search results page for any keyword and location on Google Maps

API Usage

The scraper is also available to use as an API. These parameters are accepted in the body

Request Body

Name	Description	Example
search	Search term	restaurants in New York City
geo_coordinates	Geographical coordinates of the location where you want to perform the search
zoom	Zoom level should be an integer value between 1 and 21
service_platform	Variable to indicate scraper platform name	gmaps_search
webhook_url	Callback url where results will be posted on job completion. URL must accept post requests.	https://yourserverurl.com/path

Authentication

Set the following header for authentication:

Authorization: Token <your_api_key>

Example

Using the scraper via API requires a simple post request with the search and service_platform details sent in the body of the request.

bash

1curl -X POST 'https://data.unwrangle.com/api/jobs/' \
2-H 'Authorization: Token <your_api_key_here>' \
3-H 'Content-Type: application/json' \
4-d '{
5  "search": "restaurants in New York City",
6  "geo_coordinates": "40.7128, -74.0060",
7  "zoom": 14,
8  "service_platform": "gmaps_search",
9  "webhook_url": "<optional_webhook_url_goes_here.com>"
10}'

API Response

This is the response you will receive when a scraping job is created successfully.

json

1{
2  "created": "2024-06-10T09:19:40.161178Z",
3  "id": 27602,
4  "url": null,
5  "search": "restaurants in New York City",
6  "geo_coordinates": "40.7128, -74.0060",
7  "zoom": 14,
8  "urls": [],
9  "status": "queued",
10  "n": null,
11  "service_platform": "gmaps_search",
12  "from_date": null,
13  "webhook_url": null,
14  "external_id": null,
15  "is_webhook_sent": false,
16  "credits_used": 10,
17  "completed": null
18}

Querying Results

The results retrieved by the scraping job can also be queried via API by making a request with the job ID in it if a webhook URL is not present.

bash

1curl -X GET 'https://data.unwrangle.com/api/jobs/27602/results/' \
2-H 'Authorization: Token <your_api_key>'

Request Cost

Each record returned will cost 1 credit and an additional 10 credits will be charged as a base fee for each job that is created