Google Maps Local Results API
The Google Maps Local Results API allows a user to scrape the results of a Google Maps Search. SerpApi is able to make sense of this information and extract ads and local_results blocks. Each of this result blocks can contain title, reviews, rating, price, type, address, phone, description, hours, thumbnail, gps_coordinates, data_id, links and more.
To scrape Google Maps Local results with SerpApi, create a search with these parameters:
type
Required
Parameter must be set to search. (I.e., type=search)
q
Required
You can use anything that you would use in a regular Google Maps search
start
Optional
Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 20 is the 2nd page of results, 40 is the 3rd page of results, etc.).
ll
Optional
Parameter defines GPS coordinates of location where you want your q (query) to be applied. It has to be constructed in the next sequence:@ + latitude + , + longitude + , + zoom
This will form a string that looks like this:
e.g. @40.7455096,-74.0083012,14z. The zoom parameter is optional but recommended for higher precision (it ranges from 3z, map completely zoomed out - to 21z, map completely zoomed in). The parameter should only be used when type is set to search.
* Parameter is required when using pagination.
Maps local results examples
Local results overview
This kind of results represent regular Google Maps search results. You can search for local businesses, stores or retail chains (e.g. "Starbucks", "Target", "Best Buy", etc.), products (e.g. "Beer", "Sushi", "Burgers", etc.) or places that fall under certain categories (e.g. "Hotels", "Cheap eateries", "Chinese", etc.).
{
...
"local_results": [
{
"position": 1,
"title": "Think Coffee",
"data_id": "0x89c259900d24e84b:0xd186a287933b4e4d",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259900d24e84b:0xd186a287933b4e4d",
"gps_coordinates": {
"latitude": 40.7395095,
"longitude": -74.0030029
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259900d24e84b%3A0xd186a287933b4e4d%218m2%213d40.7395095%214d-74.0030029&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.2,
"reviews": 739,
"price": "$",
"type": "Coffee shop",
"address": "73 8th Ave, New York, NY 10014",
"hours": "Opens at 8:00 AM",
"website": "http://www.thinkcoffee.com/",
"description": "Popular Fair Trade coffeehouse. Fair Trade organic coffee, sandwiches & baked goods served in a laid-back East Village setting.",
"service_options": {
"dine_in": false,
"takeout": true,
"delivery": false
},
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipPwcnmRIocYpfmGt6iZkNIWhv9HOMK3QtY0fzjk=w80-h142-k-no"
},
{
"position": 2,
"title": "Le Cafe Coffee",
"data_id": "0x89c25998658e7291:0x37d01eac663f737",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c25998658e7291:0x37d01eac663f737",
"gps_coordinates": {
"latitude": 40.7357843,
"longitude": -73.9927257
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c25998658e7291%3A0x37d01eac663f737%218m2%213d40.7357843%214d-73.9927257&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.4,
"reviews": 162,
"type": "Coffee shop",
"address": "7 E 14th St, New York, NY 10003",
"hours": "Opens at 7:00 AM",
"phone": "(212) 365-1060",
"website": "http://www.lecafecoffee.com/",
"description": "Cozy spot known for its latte art. Known for its latte art & seasonal drinks, this quaint coffee bar also offers pastries & sandwiches.",
"service_options": {
"dine_in": false,
"takeout": true,
"delivery": false
},
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipMkTUWe_M18VNUq5PIy-mYVYmnoojJLfV1b4TRC=w80-h142-k-no"
},
{
"position": 3,
"title": "Blue Bottle Coffee",
"data_id": "0x89c25999add201db:0x6c7a37c57f1cd482",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c25999add201db:0x6c7a37c57f1cd482",
"gps_coordinates": {
"latitude": 40.7340106,
"longitude": -73.992526
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c25999add201db%3A0x6c7a37c57f1cd482%218m2%213d40.7340106%214d-73.992526&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.4,
"reviews": 151,
"price": "$$",
"type": "Coffee shop",
"address": "101 University Pl, New York, NY 10003",
"hours": "Opens at 8:30 AM",
"phone": "(510) 653-3394",
"website": "https://bluebottlecoffee.com/cafes/university-place",
"description": "Hip cafe for gourmet coffee & pastries. Trendy cafe chain offering upscale coffee drinks & pastries, plus beans & brewing equipment.",
"service_options": {
"dine_in": false,
"takeout": true
},
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipP8kbMo_HSe9SGkrUCSssjEt4ltyGjtrWr3cc5M=w80-h106-k-no"
},
...
],
...
}
Ads results
SerpApi is also able to grab and extract ads (advertisement) results.
{
...
"ads": [
{
"position": 1,
"title": "Domino's Pizza",
"data_id": "0x89c259bb3054337d:0x3947f4f0f992630f",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259bb3054337d:0x3947f4f0f992630f",
"gps_coordinates": {
"latitude": 40.743674399999996,
"longitude": -73.995291
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259bb3054337d%3A0x3947f4f0f992630f%218m2%213d40.743674399999996%214d-73.995291&engine=google_maps&token=ee21b947a5e26b46&type=place",
"rating": 3.7,
"reviews": 237,
"price": "$",
"type": "Pizza delivery",
"address": "170 W 23rd St, New York, NY 10011",
"hours": "Open until 2:00 AM",
"phone": "(212) 243-5700",
"website": "https://www.dominos.com/en/?utm_source=google&utm_medium=loclist&utm_campaign=localmaps",
"description": "Longtime pizza chain known for delivery. Delivery/carryout chain offering a wide range of pizza, plus chicken & other sides.",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipOOYKR9pi0gjtEVde5ry1N_XJFXllGPyT3Cw5te=w360-h270-k-no"
}
],
...
}
Example with "Hotel" results
From this type of results, SerpApi is able to grab and extract, among other data, a price and amenities. You can also set custom filters to check hotel availability. You can do this by passing a value to the data parameter in the next format:
Date - !4m6!2m5!5m3!5m1!1s + date (e.g. data=!4m6!2m5!5m3!5m1!1s2019-11-27)
Price - !4m4!2m3!5m1!9i + price + !6e3 (e.g. data=!4m4!2m3!5m1!9i50000!6e3)
Date + Price - !4m6!2m5!5m3!5m1!1s + date + !9i + price + !6e3 (e.g. data=!4m6!2m5!5m3!5m1!1s2019-11-27!9i50000!6e3)
* If you are interested in passing other filters, you can visit the Google Maps website, set filters you want and simply copy data value from their URL to SerpApi URL.
* Filter won't work when using pagination.
{
...
"local_results": [
{
"position": 1,
"title": "Hotel Pennsylvania",
"data_id": "0x89c259aef28db459:0xc8cb71ead274b3a4",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259aef28db459:0xc8cb71ead274b3a4",
"gps_coordinates": {
"latitude": 40.7499775,
"longitude": -73.9910082
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259aef28db459%3A0xc8cb71ead274b3a4%218m2%213d40.7499775%214d-73.9910082&engine=google_maps&token=881595c88aac275c&type=place",
"rating": 2.7,
"reviews": 15786,
"price": "$94",
"type": "Hotel",
"address": "401 7th Ave, New York, NY 10001",
"phone": "(212) 736-5000",
"website": "https://www.hotelpenn.com/",
"description": "Casual lodging with dining & event space. Low-key rooms & suites in a 1919 hotel featuring meeting space, dining & fitness center access.",
"amenities": [
"Free Wi-Fi",
"Free breakfast"
],
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipMZjZD5ACp1e2azYFzyWJAL7skgaK5yU42EF52M=w80-h118-k-no"
},
{
"position": 2,
"title": "The Standard, High Line",
"data_id": "0x89c259c06677ef37:0x505cfe96ba9da92a",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259c06677ef37:0x505cfe96ba9da92a",
"gps_coordinates": {
"latitude": 40.7409232,
"longitude": -74.008111
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259c06677ef37%3A0x505cfe96ba9da92a%218m2%213d40.7409232%214d-74.008111&engine=google_maps&token=b4ed34648763cfd9&type=place",
"rating": 4.3,
"reviews": 3320,
"price": "$246",
"type": "Hotel",
"address": "848 Washington St, New York, NY 10014",
"phone": "(212) 645-4646",
"website": "https://www.standardhotels.com/new-york/properties/high-line?utm_source=google&utm_campaign=google_my_business&utm_medium=organic",
"description": "Hip lodging with dining & 2 rooftop bars. Funky hotel offering sleek quarters with scenic views, plus eclectic dining & 2 rooftop bars.",
"amenities": [
"Free Wi-Fi"
],
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipP2IQox3PkMPhDX_P3GWFVuenRfbVEt8SJarwnb=w180-h92-k-no"
},
{
"position": 3,
"title": "The Jane Hotel",
"data_id": "0x89c259955a4f5839:0x31c1bad4b65ed0c5",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259955a4f5839:0x31c1bad4b65ed0c5",
"gps_coordinates": {
"latitude": 40.7382967,
"longitude": -74.00941279999999
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259955a4f5839%3A0x31c1bad4b65ed0c5%218m2%213d40.7382967%214d-74.00941279999999&engine=google_maps&token=5595c681cd59f869&type=place",
"rating": 3.9,
"reviews": 1446,
"price": "$99",
"type": "Hotel",
"address": "113 Jane St, New York, NY 10014",
"phone": "(212) 924-6700",
"website": "https://www.thejanenyc.com/",
"description": "Chic, historic lodging with dining. Former sailors' residence with dining & an opulent lobby bar, plus cozy ship-inspired rooms.",
"amenities": [
"Free Wi-Fi"
],
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipM4Ox_dtq_4pJpReDvKzXw_fuiEVru1p4XoGlFW=w91-h92-k-no"
},
...
],
...
}
Pagination example: retrieving second page results
SerpApi supports Google Maps pagination. To retrieve these results use start parametar (defines results offset, e.g. 20 is the 2nd page of results, 40 is the 3rd page of results, etc.).
When using pagination, ll parameter that defines GPS coordinates is required.
Limitations when using pagination:
- Applying filters like "price", "rating" and other, won't work
- API does not have an HTML response, just a text. search_metadata.prettify_html_file contains link to the prettified version of the result.
{
"ads": [
{
"position": 1,
"title": "Dunkin'",
"data_id": "0x89c259b19715e1e5:0x1aee75fc89a4f155",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259b19715e1e5:0x1aee75fc89a4f155",
"gps_coordinates": {
"latitude": 40.7512203,
"longitude": -73.9975231
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259b19715e1e5%3A0x1aee75fc89a4f155%218m2%213d40.7512203%214d-73.9975231&engine=google_maps&google_domain=google.com&hl=en&start=20&type=place",
"rating": 3.9,
"reviews": 195,
"price": "$",
"type": "Coffee shop",
"address": "360 W 31st St, New York, NY 10001",
"hours": "Open until 8:00 PM",
"phone": "(212) 904-1160",
"website": "https://smart.link/abu8tr12sc1y6?utm_source=google&utm_medium=local&utm_campaign=gmbwebsiteorder&utm_content=342190",
"description": "Chain known for donuts & coffee. Long-running chain serving signature donuts, breakfast sandwiches & a variety of coffee drinks.",
"service_options": {
"dine_in": false,
"takeout": true,
"no_contact_delivery": true
},
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipPq0MtZXSN-J8f3RX-ZmZY9-SQUgVBkOUlbBXiF=w360-h202-k-no"
},
...
],
"local_results": [
{
"position": 1,
"title": "Blue Bottle Coffee",
"data_id": "0x89c259cd67d7a7e1:0xc4c276e0ac11f84f",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x89c259cd67d7a7e1:0xc4c276e0ac11f84f",
"gps_coordinates": {
"latitude": 40.7299502,
"longitude": -73.9925076
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x89c259cd67d7a7e1%3A0xc4c276e0ac11f84f%218m2%213d40.7299502%214d-73.9925076&engine=google_maps&google_domain=google.com&hl=en&start=20&type=place",
"rating": 4.3,
"reviews": 37,
"price": "$$",
"type": "Cafe",
"address": "2 Astor Pl, New York, NY 10003",
"hours": "Opens at 8:00 AM",
"phone": "(510) 653-3394",
"website": "https://bluebottlecoffee.com/cafes/astor-place",
"description": "Hip cafe for gourmet coffee & pastries. Trendy cafe chain offering upscale coffee drinks & pastries, plus beans & brewing equipment.",
"service_options": {
"dine_in": false,
"takeout": true
},
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipMg9yH0xgdf3UBwSo8gCcYRC4YbzTFHctBBcWDp=w80-h106-k-no"
},
...
],
"serpapi_pagination": {
"next": "https://serpapi.com/search.json?engine=google_maps&google_domain=google.com&hl=en&ll=@40.7455096,-74.0083012,14z&q=coffee&start=40&type=search",
"current": "https://serpapi.com/search.json?engine=google_maps&google_domain=google.com&hl=en&ll=@40.7455096,-74.0083012,14z&q=coffee&start=20&type=search",
"previous": "https://serpapi.com/search.json?engine=google_maps&google_domain=google.com&hl=en&ll=@40.7455096,-74.0083012,14z&q=coffee&start=0&type=search"
}
}
Example with "freezers austin" results
City can be used to refine a search(as well as state and zip)
{
...
"local_results": [
{
"position": 1,
"title": "Austin Industrial Refrigeration",
"data_id": "0x8644cd2e1f2e1d91:0xf6605527ed8f5d6a",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8644cd2e1f2e1d91:0xf6605527ed8f5d6a",
"gps_coordinates": {
"latitude": 30.4447577,
"longitude": -97.77864339999999
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8644cd2e1f2e1d91%3A0xf6605527ed8f5d6a%218m2%213d30.4447577%214d-97.77864339999999&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.0,
"reviews": 4,
"type": "HVAC contractor",
"address": "13200 Pond Springs Rd # D30, Austin, TX 78729, United States",
"hours": "Opens at 8:00 AM",
"phone": "+1 512-249-7634",
"website": "http://www.austin-industrial.com/",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipO3X-XhGC725jLwxc-opAJCOnLsXhN04oj15S_8=w163-h92-k-no"
},
{
"position": 2,
"title": "Appliance Associates",
"data_id": "0x8644ca46933fd353:0x9fc2ddb54bdc0d2d",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8644ca46933fd353:0x9fc2ddb54bdc0d2d",
"gps_coordinates": {
"latitude": 30.330581199999997,
"longitude": -97.7241722
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8644ca46933fd353%3A0x9fc2ddb54bdc0d2d%218m2%213d30.330581199999997%214d-97.7241722&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 3.9,
"reviews": 33,
"type": "Appliance store",
"address": "814 Romeria Dr, Austin, TX 78757, United States",
"hours": "Opens at 9:00 AM",
"phone": "+1 512-454-5896",
"website": "https://www.applianceofaustin.com/",
"description": "Dealer of brand-name home appliances. Retail showroom for new, imperfect & close-out brand-name home appliances, plus parts & repairs.",
"user_review": ""When looking for a refrigerator/freezer, I presented Kirk with my list of ..."",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipPwM-moaI-30sZ1Wrn98zO4py6_jKjlxI6SdZ7o=w122-h92-k-no"
},
{
"position": 3,
"title": "Thermal Trek, Inc. (Refrigerated Trailer Storage)",
"data_id": "0x8644b42ac9ec6603:0x7fea9cfbc8dd9e04",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8644b42ac9ec6603:0x7fea9cfbc8dd9e04",
"gps_coordinates": {
"latitude": 30.4305098,
"longitude": -97.6794413
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8644b42ac9ec6603%3A0x7fea9cfbc8dd9e04%218m2%213d30.4305098%214d-97.6794413&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 5.0,
"reviews": 3,
"type": "Trailer rental service",
"address": "1806 Hydro Dr, Austin, TX 78728, United States",
"hours": "Opens at 7:30 AM",
"phone": "+1 512-610-2010",
"website": "http://www.thermaltrek.com/",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipPwLyeadjIHFv9IyPBXwbI8xWtADUUaftcMUDk0=w117-h92-k-no"
},
...
],
...
}
Example with "freezers texas" results
State can be used to refine a search(as well as city and zip).
{
...
"local_results": [
{
"position": 1,
"title": "Preferred Freezer Services",
"data_id": "0x8640bb8615f5805b:0xafef39d9b63f1425",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8640bb8615f5805b:0xafef39d9b63f1425",
"gps_coordinates": {
"latitude": 29.781001099999997,
"longitude": -95.277844
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8640bb8615f5805b%3A0xafef39d9b63f1425%218m2%213d29.781001099999997%214d-95.277844&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.3,
"reviews": 58,
"type": "Cold storage facility",
"address": "555 Aleen St, Houston, TX 77029",
"hours": "Opens at 7:00 AM",
"phone": "(713) 222-6300",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipOEak5Md8nT0mmpYRPzEzQQYLnbKKWNUeXZw8r0=w163-h92-k-no"
},
{
"position": 2,
"title": "Preferred Freezer Services",
"data_id": "0x8640a01c243effef:0x17c0ef5ecf286b8e",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8640a01c243effef:0x17c0ef5ecf286b8e",
"gps_coordinates": {
"latitude": 29.6957961,
"longitude": -95.0751176
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8640a01c243effef%3A0x17c0ef5ecf286b8e%218m2%213d29.6957961%214d-95.0751176&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.1,
"reviews": 78,
"type": "Cold storage facility",
"address": "10060 Porter Rd, La Porte, TX 77571",
"hours": "Opens at 6:00 AM",
"phone": "(281) 867-4500",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipNRQcMP00HymIV7krLeORZWy1_kRz_1bizhXf-Y=w80-h106-k-no"
},
{
"position": 3,
"title": "Preferred Freezer Services",
"data_id": "0x86409e1a80cf441d:0xea5749b5ba3b0bd6",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x86409e1a80cf441d:0xea5749b5ba3b0bd6",
"gps_coordinates": {
"latitude": 29.6158269,
"longitude": -95.06889059999999
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x86409e1a80cf441d%3A0xea5749b5ba3b0bd6%218m2%213d29.6158269%214d-95.06889059999999&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.6,
"reviews": 75,
"type": "Warehouse",
"address": "10585 Red Bluff Rd, Pasadena, TX 77507",
"hours": "Opens at 7:00 AM",
"phone": "(281) 291-9100",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipMgY7xibL5oTEijCHlIa8PcAHUTu7SEpcE0Cotx=w163-h92-k-no"
},
{
"position": 4,
"title": "Lineage Logistics",
"data_id": "0x8640badfe9f2023b:0x25f63da126dfa129",
"reviews_link": "https://serpapi.com/search.json?engine=google_maps_reviews&hl=en&place_id=0x8640badfe9f2023b:0x25f63da126dfa129",
"gps_coordinates": {
"latitude": 29.825267999999998,
"longitude": -95.246612
},
"place_id_search": "https://serpapi.com/search.json?data=%214m5%213m4%211s0x8640badfe9f2023b%3A0x25f63da126dfa129%218m2%213d29.825267999999998%214d-95.246612&engine=google_maps&google_domain=google.com&hl=en&type=place",
"rating": 4.3,
"reviews": 42,
"type": "Warehouse",
"address": "7080 Express Ln, Houston, TX 77078",
"hours": "Opens at 7:00 AM",
"phone": "(832) 708-2200",
"website": "http://lineagelogistics.com/",
"thumbnail": "https://lh5.googleusercontent.com/p/AF1QipMW0cB26AKqBUvQrsVDR91aoul2QWu0bkbz-V8N=w122-h92-k-no"
}
],
...
}