Google Maps and Local Places Scraper API is a tool that allows users to extract maps data from Google Maps and Google Local Search results in a structured format. The API returns a HTML (only Search Local) or JSON object that contains the search results and additional metadata about the search or CSV.

HTML Google Local

JSON Example Google Maps

{
  "search_parameters" : {
    "q" : "hotels",
    "location" : "location=lat:48.8566,lon:2.3522,zoom:14",
    "output" : "json",
    "search_type" : "places",
    "engine" : "google"
  },
  "search_metadata" : {
    "created_at" : "2023-04-23T07:52:10.585Z",
    "processed_at" : "2023-04-23T07:52:12.203Z",
    "total_time_taken" : 1.62,
    "engine_url" : "https://www.google.com/maps/search/hotels/@48.8566,2.3522,14z",
    "html_url" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=location%3Dlat%3A48.8566%2Clon%3A2.3522%2Czoom%3A14&output=html&api_key={API-KEY}&search_type=places&engine=google",
    "json_url" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=location%3Dlat%3A48.8566%2Clon%3A2.3522%2Czoom%3A14&output=json&api_key={API-KEY}&search_type=places&engine=google"
  },
  "search_information" : {
    "original_query_yields_zero_results" : false
  },
  "places_results" : [
    {
      "position" : 1,
      "title" : "Andréa Hotel - Paris Marais",
      "web_results_link" : "https://www.google.com/search?q=local+guide+program&ibp=gwp;0,26,OjEKLyIrQW5kcsOpYSBIb3RlbCAtIFBhcmlzIE1hcmFpcyBQYXJpcywgRnJhbmNpYSgC&pcl=lp",
      "place_id" : "ChIJ-T7A1x1u5kcRBZG7UmOau8A",
      "data_cid" : "13887863627307520261",
      "data_id" : "0x47e66e1dd7c03ef9:0xc0bb9a6352bb9105",
      "link" : "http://www.hotelandrea.paris/",
      "thumbnail" : "https://lh3.googleusercontent.com/gps-proxy/AE4_-5Hy5rqf-FebjO4ZEeJJsii8kcgoAG4R7BFB07IMO0VymQ1Kpcwx9361xbASXVgZmzM7HiTBVpvMyWWL2hDg3d1M_BeiBThztk6M1mcbVEiT0l8W3uml3eNypaGbkXaKr3C932pklShMDsf4qbGy3udqyGI_6xuey3rbE6HjCG66wUbWm_Glq3CENA=w91-h92-k-no",
      "address" : "3 Rue Saint-Bon, 75004 Paris, Francia",
      "phone" : "+33 1 42 78 43 93",
      "rating" : 3.6,
      "reviews" : 288,
      "category" : "Hotel",
      "all_categories" : [
        "Hotel"
      ],
      "gps_coordinates" : {
        "latitude" : 48.8582343,
        "longitude" : 2.3501828
      }
    },
    {
      "position" : 20,
      "title" : "Hotel Richard",
      "web_results_link" : "https://www.google.com/search?q=local+guide+program&ibp=gwp;0,26,OiIKICIcSG90ZWwgUmljaGFyZCBQYXJpcywgRnJhbmNpYSgC&pcl=lp",
      "place_id" : "ChIJ_WRcLvZt5kcRRc683YvF6G8",
      "data_cid" : "8063912337318137413",
      "data_id" : "0x47e66df62e5c64fd:0x6fe8c58bddbcce45",
      "link" : "https://www.shouthotels.com/hotel-richard-paris/",
      "thumbnail" : "https://lh5.googleusercontent.com/p/AF1QipNOkkVsQCThBiRpD3jjAg0tvg9NRRrFFwhbWmgM=w80-h106-k-no",
      "address" : "Hotel Richard, 35 Rue Richard Lenoir, 75011 Paris, Francia",
      "phone" : "+33 1 43 79 39 98",
      "rating" : 2.8,
      "reviews" : 689,
      "category" : "Hotel",
      "all_categories" : [
        "Hotel"
      ],
      "gps_coordinates" : {
        "latitude" : 48.856007299999995,
        "longitude" : 2.3813470999999997
      }
    }
  ]
}

JSON Example Google Local

{
  "search_parameters" : {
    "q" : "hotels",
    "location" : "Paris,France",
    "output" : "json",
    "search_type" : "places",
    "engine" : "google"
  },
  "search_metadata" : {
    "created_at" : "2023-04-23T07:53:56.050Z",
    "processed_at" : "2023-04-23T07:54:11.495Z",
    "total_time_taken" : 15.45,
    "engine_url" : "https://www.google.com/search?q=hotels&uule=w+CAIQICIMUGFyaXMsRnJhbmNl&tbm=lcl",
    "html_url" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=Paris%2CFrance&output=html&api_key={API-KEY}&search_type=places&engine=google",
    "json_url" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=Paris%2CFrance&output=json&api_key={API-KEY}&search_type=places&engine=google"
  },
  "search_information" : {
    "original_query_yields_zero_results" : false
  },
  "pagination" : {
    "current" : 1,
    "next" : "https://www.google.com/search?q=hotels&tbm=lcl&ei=HuREZPWSFNKj5NoPrP-bgAw&start=20&sa=N&ved=2ahUKEwj1mb-Ow7_-AhXSEVkFHaz_BsAQ8NMDegQIGRAi&uule=w+CAIQICIMUGFyaXMsRnJhbmNl",
    "other_pages" : [
      {
        "page" : 2,
        "link" : "https://www.google.com/search?q=hotels&tbm=lcl&ei=HuREZPWSFNKj5NoPrP-bgAw&start=20&sa=N&ved=2ahUKEwj1mb-Ow7_-AhXSEVkFHaz_BsAQ8tMDegQIGRAQ&uule=w+CAIQICIMUGFyaXMsRnJhbmNl"
      },
      {
        "page" : 3,
        "link" : "https://www.google.com/search?q=hotels&tbm=lcl&ei=HuREZPWSFNKj5NoPrP-bgAw&start=40&sa=N&ved=2ahUKEwj1mb-Ow7_-AhXSEVkFHaz_BsAQ8tMDegQIGRAS&uule=w+CAIQICIMUGFyaXMsRnJhbmNl"
      }
    ],
    "api_pagination" : {
      "next" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=Paris,France&output=json&api_key=c1bb817a8bfb418b9d05ee72171946d3&search_type=places&id=req0&page=2",
      "other_pages" : [
        {
          "page" : 2,
          "link" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=Paris,France&output=json&api_key=c1bb817a8bfb418b9d05ee72171946d3&search_type=places&id=req0&page=2"
        },
        {
          "page" : 3,
          "link" : "https://app.scrapein.app/api/v1/google/places?q=hotels&location=Paris,France&output=json&api_key=c1bb817a8bfb418b9d05ee72171946d3&search_type=places&id=req0&page=3"
        }
      ]
    }
  },
  "places_results" : [
    {
      "title" : "The People Paris Marais",
      "data_cid" : "7285232064807837980",
      "data_id" : "0x47e671f93cda1a8d:0x651a57f6d128211c",
      "gps_coordinates" : {
        "latitude" : 48.8501827,
        "longitude" : 2.3629827999999997
      },
      "address" : "17 Bd Morland",
      "sponsored" : false,
      "extensions" : [
        "The People Paris Marais",
        "4.0(378)",
        "Sleek dorms & rooms, some with balconies, in a chic hostel featuring a restaurant/bar.",
        "17 Bd Morland"
      ],
      "rating" : 4,
      "reviews" : 378,
      "position" : 1
    },
    {
      "title" : "Hôtel Georgette",
      "data_cid" : "11660908704058057659",
      "data_id" : "0x47e66e1bb196a367:0xa1d3deaf27a423bb",
      "gps_coordinates" : {
        "latitude" : 48.863291399999994,
        "longitude" : 2.35263
      },
      "address" : "36 Rue du Grenier-Saint-Lazare",
      "sponsored" : false,
      "extensions" : [
        "Hôtel Georgette",
        "4.4(251)",
        "Mid-rise hotel featuring modern art-inspired decor, minibars & free Wi-Fi, plus breakfast for a fee.",
        "36 Rue du Grenier-Saint-Lazare"
      ],
      "rating" : 4.4,
      "reviews" : 251,
      "position" : 2
    }
  ]
}

JSON Structure

The JSON structure returned by the Google Maps and Places Scraper API includes required elements, such as request_info, search_parameters, search_metadata, search_information, pagination, as described in the Results SERP Google API section, as well as those specific to Google Maps and Places, which are described below.

Here is a description of each parameter in the JSON response from the ScrapeIN Google Maps and Places API.

places_results

The places_results is an array that contains information about the places that match the search query.

position: an integer value that indicates the position of the place in the search results.
title: a string value that contains the title of the place.
web_results_link: a string value that contains a link to the search results page for the place.
place_id: a string value that uniquely identifies the place.
data_cid: a string value that represents the data client ID associated with the place. It's a unique identifier used by Google to track the data associated with a particular place.
data_id: a string value that represents the data ID associated with the place. It's a unique identifier used by Google to track the data associated with a particular place.
link: a string value that contains a link to the place's website.
thumbnail: a string value that contains a link to an image thumbnail for the place.
address: a string value that contains the address of the place.
phone: a string value that contains the phone number of the place.
rating: a numeric value that represents the rating of the place.
reviews: a numeric value that represents the number of reviews for the place.
category: a string value that represents the category of the place.
all_categories: an array that contains all the categories associated with the place.
gps_coordinates: an object that contains the GPS coordinates of the place, it includes the latitude and longitude coordinates for the place.
price: a string that indicates the relative price of services offered by the business, localized to the user's region. For example, "$$$" may indicate that the business is expensive.
price_parsed: a numeric representation of the relative price of services offered by the business, ranging from 1 for inexpensive to 5 for expensive.
price_description: a text representation of the relative price of services offered by the business, if provided. For example, "Inexpensive" may be used to describe a business that is affordable.
rating: the customer rating that the place has received, out of 5.
reviews: the number of customer reviews that the place has received.
description: the full-text description of the place result, if available.
extensions: an array of strings that represent the extensions or services offered by the business. For example, Offers takeaway may indicate that the business offers a takeaway service.
user_review: the full-text of a user review that is displayed next to the place result, if available.