Google Maps Search API (Async)

The Google Maps Search API endpoint returns Google Maps Search result page and transform it into usable JSON.

Single Query Request

curl -X POST \
    -H "Content-Type: application/json" \
    -d '{
            "apiKey": "API_KEY",
            "query": "QUERY",
            "latitude": LATITUDE,
            "longitude": LONGITUDE,
            "callback": {
                "type": "webhook",
                "url": "YYYYYY"
            }
        }' \
    "https://async.scraperapi.com/structured/google/mapssearch"

import requests

url = "https://async.scraperapi.com/structured/google/mapssearch"
headers = {
    "Content-Type": "application/json"
}
data = {
    "apiKey": "API_KEY",
    "query": "QUERY",
    "latitude": LATITUDE,
    "longitude": LONGITUDE,
    "callback": {
        "type": "webhook",
        "url": "YYYYY"
    }
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

import fetch from 'node-fetch';

const options = {
  method: 'POST',
  body: JSON.stringify({
    apiKey: 'API_KEY',
    query: 'QUERY',
    latitude: LATITUDE,
    longitude: LONGITUDE,
    callback: {
      type: 'webhook',
      url: 'YYYYY'
    }
  }),
  headers: {
    'Content-Type': 'application/json',
  },
}

fetch('https://async.scraperapi.com/structured/google/mapssearch', options)
  .then(response => {
    response.text().then(text => console.log(text));
  })
  .catch(error => {
    console.log(error);
  });

<?php
$curl = curl_init();

$data = json_encode(array(
    'apiKey' => 'API_KEY',
    'query' => 'QUERY',
    'latitude' => LATITUDE,
    'longitude' => LONGITUDE,
    'callback' => array(
        'type' => 'webhook',
        'url' => 'YYYYY'
    )
));

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://async.scraperapi.com/structured/google/mapssearch',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data,
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error:' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://async.scraperapi.com/structured/google/mapssearch')
request = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json')
request.body = {
  apiKey: 'API_KEY',
  query: 'QUERY',
  latitude: LATITUDE,
  longitude: LONGITUDE,
  callback: {
    type: 'webhook',
    url: 'YYYYY'
  }
}.to_json

begin
  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end
  puts response.body
rescue => e
  puts "Error: #{e.message}"
end

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import javax.net.ssl.HttpsURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        try {
            String apiKey = "API_KEY";
            String jsonInputString = "{"
                + "\"apiKey\": \"" + apiKey + "\", "
                + "\"query\": \"QUERY\", "
                + "\"latitude\": LATITUDE, "
                + "\"longitude\": LONGITUDE, "
                + "\"callback\": {"
                + "    \"type\": \"webhook\", "
                + "    \"url\": \"YYYYY\""
                + "}}";

            URL url = new URL("https://async.scraperapi.com/structured/google/mapssearch");
            HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
            connection.setRequestMethod("POST");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "*/*");
            connection.setDoOutput(true);

            try (OutputStream os = connection.getOutputStream()) {
                byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);
            }

            int responseCode = connection.getResponseCode();
            StringBuilder response = new StringBuilder();
            BufferedReader in = new BufferedReader(new InputStreamReader(connection.getInputStream()));
            String readLine;
            while ((readLine = in.readLine()) != null) {
                response.append(readLine);
            }
            in.close();

            if (responseCode == HttpURLConnection.HTTP_OK) {
                System.out.println("Response: " + response.toString());
            } else {
                throw new Exception("Error in API Call: Response code " + responseCode + "\nbody: " + response.toString());
            }

        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}

Multiple Queries Request

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "apiKey": "API_KEY",
    "jobs": [
      {
        "query": "QUERY1",
        "latitude": LATITUDE_1,
        "longitude": LONGITUDE_1,
        "callback": {
          "type": "webhook",
          "url": "YYYYYY"
        }
      },
      {
        "query": "QUERY2",
        "latitude": LATITUDE_2,
        "longitude": LONGITUDE_2,
        "callback": {
          "type": "webhook",
          "url": "YYYYYY"
        }
      }
    ]
  }' \
  "https://async.scraperapi.com/structured/google/mapssearch"

import requests

url = "https://async.scraperapi.com/structured/google/mapssearch"
headers = {
    "Content-Type": "application/json"
}

data = {
    "apiKey": "API_KEY",
    "jobs": [
        {
            "query": "QUERY1",
            "latitude": LATITUDE_1,
            "longitude": LONGITUDE_1,
            "callback": {
                "type": "webhook",
                "url": "YYYYY"
            }
        },
        {
            "query": "QUERY2",
            "latitude": LATITUDE_2,
            "longitude": LONGITUDE_2,
            "callback": {
                "type": "webhook",
                "url": "YYYYY"
            }
        }
    ]
}

response = requests.post(url, json=data, headers=headers)
print(response.text)

import fetch from 'node-fetch';

const options = {
  method: 'POST',
  body: JSON.stringify({
    apiKey: 'API_KEY',
    jobs: [
      {
        query: 'QUERY1',
        latitude: LATITUDE_1,
        longitude: LONGITUDE_1,
        callback: {
          type: 'webhook',
          url: 'YYYYY'
        }
      },
      {
        query: 'QUERY2',
        latitude: LATITUDE_2,
        longitude: LONGITUDE_2,
        callback: {
          type: 'webhook',
          url: 'YYYYY'
        }
      }
    ]
  }),
  headers: {
    'Content-Type': 'application/json',
  },
};

fetch('https://async.scraperapi.com/structured/google/mapssearch', options)
  .then(response => response.text())
  .then(text => console.log(text))
  .catch(error => {
    console.error(error);
  });

<?php
$curl = curl_init();

$data = json_encode(array(
    'apiKey' => 'API_KEY',
    'jobs' => array(
        array(
            'query' => 'QUERY1',
            'latitude' => LATITUDE_1,
            'longitude' => LONGITUDE_1,
            'callback' => array(
                'type' => 'webhook',
                'url' => 'YYYYY'
            )
        ),
        array(
            'query' => 'QUERY2',
            'latitude' => LATITUDE_2,
            'longitude' => LONGITUDE_2,
            'callback' => array(
                'type' => 'webhook',
                'url' => 'YYYYY'
            )
        )
    )
));

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://async.scraperapi.com/structured/google/mapssearch',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS => $data,
  CURLOPT_HTTPHEADER => array(
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

if (curl_errno($curl)) {
    echo 'Error: ' . curl_error($curl);
} else {
    echo $response;
}

curl_close($curl);

require 'net/http'
require 'json'
require 'uri'

uri = URI('https://async.scraperapi.com/structured/google/mapssearch')
request = Net::HTTP::Post.new(uri, 'Content-Type' => 'application/json')

request.body = {
  apiKey: 'API_KEY',
  jobs: [
    {
      query: 'QUERY1',
      latitude: LATITUDE_1,
      longitude: LONGITUDE_1,
      callback: {
        type: 'webhook',
        url: 'YYYYY'
      }
    },
    {
      query: 'QUERY2',
      latitude: LATITUDE_2,
      longitude: LONGITUDE_2,
      callback: {
        type: 'webhook',
        url: 'YYYYY'
      }
    }
  ]
}.to_json

begin
  response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
    http.request(request)
  end
  puts response.body
rescue => e
  puts "Error: #{e.message}"
end

import java.io.BufferedReader;
import java.io.InputStreamReader;
import java.io.OutputStream;
import java.net.HttpURLConnection;
import javax.net.ssl.HttpsURLConnection;
import java.net.URL;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) {
        try {
            String apiKey = "API_KEY";

            String jsonInputString = "{"
                + "\"apiKey\": \"" + apiKey + "\", "
                + "\"jobs\": ["
                + "  {"
                + "    \"query\": \"QUERY1\", "
                + "    \"latitude\": LATITUDE_1, "
                + "    \"longitude\": LONGITUDE_1, "
                + "    \"callback\": {"
                + "      \"type\": \"webhook\", "
                + "      \"url\": \"YYYYY\""
                + "    }"
                + "  },"
                + "  {"
                + "    \"query\": \"QUERY2\", "
                + "    \"latitude\": LATITUDE_2, "
                + "    \"longitude\": LONGITUDE_2, "
                + "    \"callback\": {"
                + "      \"type\": \"webhook\", "
                + "      \"url\": \"YYYYY\""
                + "    }"
                + "  }"
                + "]"
                + "}";

            URL url = new URL("https://async.scraperapi.com/structured/google/mapssearch");
            HttpsURLConnection connection = (HttpsURLConnection) url.openConnection();
            connection.setRequestMethod("POST");
            connection.setRequestProperty("Content-Type", "application/json");
            connection.setRequestProperty("Accept", "*/*");
            connection.setDoOutput(true);

            try (OutputStream os = connection.getOutputStream()) {
                byte[] input = jsonInputString.getBytes(StandardCharsets.UTF_8);
                os.write(input, 0, input.length);
            }

            int responseCode = connection.getResponseCode();
            StringBuilder response = new StringBuilder();

            BufferedReader in = new BufferedReader(new InputStreamReader(
                responseCode >= 400 ? connection.getErrorStream() : connection.getInputStream()
            ));

            String readLine;
            while ((readLine = in.readLine()) != null) {
                response.append(readLine);
            }
            in.close();

            if (responseCode == HttpURLConnection.HTTP_OK) {
                System.out.println("Response: " + response.toString());
            } else {
                throw new Exception("Error in API Call: Response code " + responseCode + "\nbody: " + response.toString());
            }

        } catch (Exception ex) {
            ex.printStackTrace();
        }
    }
}

You can easily get the latitude and longitude for any location directly from Google Maps by right-clicking on the desired point and copying the coordinates.

Supported Parameters

Parameter

Details

API_KEY(required)

Your API Key.

QUERY(required)

Query string for example: vegan restaurant

LATITUDE(required)

Latitude value, for example: 21.029738077531196

LONGITUDE(required)

Longitude value, for example: 105.85222341863856

Sample Response

Single Query Request

{
    "id": "024559fd-4d71-419c-bda6-2915dda7667d",
    "attempts": 0,
    "status": "running",
    "statusUrl": "https://async.scraperapi.com/jobs/024559fd-4d71-419c-bda6-2915dda7667d",
    "query": "new york restaurants",
    "latitude": 40.74229676764451,
    "longitude": -73.98832638564608,
    "supposedToRunAt": "2024-10-31T09:56:44.748Z"
}

Multiple Queries Request

{
    "id": "0869fa1c-3a0d-4b06-891d-f2e58f5f05cf",
    "attempts": 0,
    "status": "running",
    "statusUrl": "https://async.scraperapi.com/jobs/0869fa1c-3a0d-4b06-891d-f2e58f5f05cf",
    "query": "new york restaurants",
    "latitude": 40.74229676764451,
    "longitude": -73.98832638564608
},

{
    "id": "0f0ed634-e3a0-4b5e-991d-dc10a251c6d7",
    "attempts": 0,
    "status": "running",
    "statusUrl": "https://async.scraperapi.com/jobs/0f0ed634-e3a0-4b5e-991d-dc10a251c6d7",
    "query": "hanoi laundries",
    "latitude": 21.028511,
    "longitude": 105.804817
}

After the job(s) finish, you will find the result under the response key in the response JSON object. The structure is the same as in the corresponding SYNC data endpoint.

PreviousGoogle Maps Search API NextReal Estate

Last updated 21 days ago

hashtagSample Response

Sample Response