Google Maps Search API (Async)

This endpoint will retrieve maps data from a Google Maps search and transform it into usable JSON.

Single Query Request:

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: 'YYYY' }}),
  headers: {
    'Content-Type': 'application/json',
  },
}

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

Multiple Query Request:

import fetch from 'node-fetch';
const options = {
  method: 'POST',
  body: JSON.stringify({
    apiKey: 'API_KEY',
    jobs: [
      {
        query: "QUERY",
        latitude: LATITUDE, 
        longitude: LONGITUDE,
        callback: {
          type: "webhook",
          url: "YYYY"
        }
      },
      {
        query: "QUERY",
        latitude: LATITUDE, 
        longitude: LONGITUDE, 
        callback: {
          type: "webhook",
          url: "YYYY"
        }
      }
    ]
  }),
  headers: { "Content-Type": "application/json" }
};

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

API_KEY(required)

User's normal 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 Query 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.

Last updated