We are excited to unveil new features added that have been added to the responses of Google Maps SERP API and Google My Business Info endpoint of Business Data API.
1 Google Maps SERP API now includes data from the Directory tab which lists various stores and amenities within large buildings.
The Directory feature helps Google Maps users with navigating through large buildings, malls, and complex transit stations to find airport lounges, car rentals, specific shops, and more. Here’s what it looks like.
With the latest update, the Google Maps SERP API responses will provide you with data on the main place and return each business from the place’s Directory tab as a separate maps_search item with "is_directory_item": true
If there is no Directory feature for the parameters you set, we will return data on the discovered Maps Search results with "is_directory_item": false for each result.
Note that to receive data on businesses from the Directory tab of a certain place, you should indicate the name of the main place using the keyword field and set "search_this_area" to false
{
"version": "0.1.20221214",
"status_code": 20000,
"status_message": "Ok.",
"time": "3.1549 sec.",
"cost": 0.002,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "06071910-1535-0139-0000-43283bbf7421",
"status_code": 20000,
"status_message": "Ok.",
"time": "3.0253 sec.",
"cost": 0.002,
"result_count": 1,
"path": [
"v3",
"serp",
"google",
"maps",
"live",
"advanced"
],
"data": {
"api": "serp",
"function": "live",
"se": "google",
"se_type": "maps",
"language_name": "english",
"location_name": "Puteaux,Ile-de-France,France",
"keyword": "Les 4 Temps, Parvis de la Défense, Puteaux, France",
"search_this_area": false,
"device": "desktop",
"os": "windows"
},
"result": [
{
"keyword": "Les 4 Temps, Parvis de la Défense, Puteaux, France",
"type": "maps",
"se_domain": "google.fr",
"location_code": 1006099,
"language_code": "en",
"check_url": "https://google.fr/maps/search/Les+4+Temps,+Parvis+de+la+Défense,+Puteaux,+France/@48.884748,2.23964,14z?hl=en&gl=FR&uule=w+CAIQIFISCcX1GiwaZeZHEeDK8nnVPzvY",
"datetime": "2023-06-07 16:10:15 +00:00",
"spell": null,
"item_types": [
"maps_search"
],
"se_results_count": 0,
"items_count": 6,
"items": [
{
"type": "maps_search",
"rank_group": 1,
"rank_absolute": 1,
"domain": "fr.westfield.com",
"title": "Westfield Les 4 Temps",
"url": "https://fr.westfield.com/les4temps",
"rating": {
"rating_type": "Max5",
"value": 4.2,
"votes_count": 43476,
"rating_max": null
},
"rating_distribution": {
"1": 1347,
"2": 1182,
"3": 5542,
"4": 14982,
"5": 20423
},
"snippet": "15 Parv. de la Défense, 92092 Puteaux",
"address": "15 Parv. de la Défense, 92092 Puteaux",
"address_info": {
"borough": null,
"address": "15 Parv. de la Défense",
"city": "Puteaux",
"zip": "92092",
"region": null,
"country_code": "FR"
},
"place_id": "ChIJC2AYcANl5kcRBFvJIOLBkOA",
"phone": "+33147735444",
"main_image": "https://lh5.googleusercontent.com/p/AF1QipPh_wn0MYfVagjeFA9L71ntfXEyw6x7mB8JngvB=w408-h306-k-no",
"total_photos": 55451,
"category": "Shopping mall",
"additional_categories": null,
"category_ids": [
"shopping_center"
],
"work_hours": {...},
"feature_id": "0x47e665037018600b:0xe090c1e220c95b04",
"cid": "16181646638099028740",
"latitude": 48.8908664,
"longitude": 2.237256,
"is_claimed": true,
"local_justifications": null,
"is_directory_item": false
},
{
"type": "maps_search",
"rank_group": 2,
"rank_absolute": 2,
"domain": null,
"title": "Auchan",
"url": null,
"rating": {
"rating_type": "Max5",
"value": 3.9,
"votes_count": 8901,
"rating_max": null
},
"rating_distribution": {
"1": 738,
"2": 484,
"3": 1443,
"4": 2672,
"5": 3564
},
"snippet": null,
"address": "Centre Commercial Westfield les 4 Temps Le Parvis de La Défense, 92800 Puteaux",
"address_info": {
"borough": null,
"address": null,
"city": null,
"zip": null,
"region": null,
"country_code": null
},
"place_id": null,
"phone": null,
"main_image": "https://lh5.googleusercontent.com/p/AF1QipMqi1lQU-HO5GOKxkJMQMpxA8Cd3OqkrKgpacdd=w86-h86-n-k-no",
"total_photos": null,
"category": "Hypermarket",
"additional_categories": null,
"category_ids": null,
"work_hours": {...},
"feature_id": "0x47e665027ed18721:0x5f083e700fad2e91",
"cid": "6847791884437106321",
"latitude": 48.891155399999995,
"longitude": 2.2351446999999998,
"is_claimed": null,
"local_justifications": null,
"is_directory_item": true
},
{
"type": "maps_search",
"rank_group": 3,
"rank_absolute": 3,
"domain": null,
"title": "Vapiano",
"url": null,
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": 7789,
"rating_max": null
},
"rating_distribution": {
"1": 756,
"2": 450,
"3": 912,
"4": 1927,
"5": 3744
},
"snippet": null,
"address": "92800 Puteaux",
"address_info": {
"borough": null,
"address": null,
"city": null,
"zip": null,
"region": null,
"country_code": null
},
"place_id": null,
"phone": null,
"main_image": "https://lh5.googleusercontent.com/p/AF1QipMlebWv4snHX1DvbN0RpMIjAMS-vC2pfKNFZ2ym=w86-h86-n-k-no",
"total_photos": null,
"category": "Italian restaurant",
"additional_categories": null,
"category_ids": null,
"work_hours": {...},
"feature_id": "0x47e66503711ec8e9:0x91cad55b639021da",
"cid": "10505443669284233690",
"latitude": 48.889736,
"longitude": 2.241843,
"is_claimed": null,
"local_justifications": null,
"is_directory_item": true
}
]
}
]
}
]
}
2 In addition to the Google Maps SERP API, the Google My Business Info endpoint will also provide you with complete and detailed information from a business profile that contains a Directory feature and an overview of each business listed in it.
You can obtain information from the Directory tab when indicating a name of a relevant place that can contain a number of businesses within itself, such as Westfield Les 4 Temps (the largest mall in Europe).
{
"version": "0.1.20221214",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0716 sec.",
"cost": 0,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "06071958-1535-0242-0000-bd201cc09f5d",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0221 sec.",
"cost": 0,
"result_count": 1,
"path": [
"v3",
"business_data",
"google",
"my_business_info",
"task_get",
"06071958-1535-0242-0000-bd201cc09f5d"
],
"data": {
"se_type": "business_info",
"se": "google",
"api": "business_data",
"function": "my_business_info",
"language_name": "english",
"location_name": "Puteaux,Ile-de-France,France",
"keyword": "Les 4 Temps, Parvis de la Défense, Puteaux, France",
"device": "desktop",
"os": "windows"
},
"result": [
{
"keyword": "Les 4 Temps, Parvis de la Défense, Puteaux, France",
"se_domain": "google.fr",
"location_code": 1006099,
"language_code": "en",
"check_url": "https://www.google.fr/maps?cid=16181646638099028740&hl=en&gl=FR",
"datetime": "2023-06-07 16:58:30 +00:00",
"item_types": [
"google_business_info"
],
"items_count": 1,
"items": [
{
"type": "google_business_info",
"rank_group": 1,
"rank_absolute": 1,
"position": "left",
"title": "Westfield Les 4 Temps",
"description": "Mode homme, mode femme, agences de voyage, bien-être ou encore électroménager, Westfield Les 4 Temps et le CNIT ont regroupé pour vous les plus grandes enseignes. Shopping, détente et loisirs, venez profiter de tous les avantages de vos centres commerciaux Westfield Les 4 Temps et le CNIT.",
"category": "Shopping mall",
"category_ids": [
"shopping_center"
],
"additional_categories": null,
"cid": "16181646638099028740",
"feature_id": "0x47e665037018600b:0xe090c1e220c95b04",
"address": "15 Parv. de la Défense, 92092 Puteaux",
"address_info": {
"borough": null,
"address": "15 Parv. de la Défense",
"city": "Puteaux",
"zip": "92092",
"region": null,
"country_code": "FR"
},
"place_id": "ChIJC2AYcANl5kcRBFvJIOLBkOA",
"phone": "+33147735444",
"url": "https://fr.westfield.com/les4temps",
"domain": "fr.westfield.com",
"logo": "https://lh5.googleusercontent.com/-gkk7TNW7fIs/AAAAAAAAAAI/AAAAAAAAAAA/U6Mw0AvFggo/s44-p-k-no-ns-nd/photo.jpg",
"main_image": "https://lh5.googleusercontent.com/p/AF1QipPh_wn0MYfVagjeFA9L71ntfXEyw6x7mB8JngvB=w408-h306-k-no",
"total_photos": 55451,
"snippet": "15 Parv. de la Défense, 92092 Puteaux",
"latitude": 48.8908664,
"longitude": 2.237256,
"is_claimed": true,
"attributes": {
"available_attributes": {
"service_options": [
"has_in_store_shopping"
],
"accessibility": [
"has_wheelchair_accessible_entrance",
"has_wheelchair_accessible_elevator"
]
},
"unavailable_attributes": null
},
"place_topics": {
"party": 52,
"auchan": 316,
"cinema": 262,
"metro": 178,
"plug": 148,
"UGC": 61,
"animation": 61,
"temple": 62,
"armoured fighting vehicle": 28,
"cultura s.a.": 19
},
"rating": {
"rating_type": "Max5",
"value": 4.2,
"votes_count": 43476,
"rating_max": null
},
"rating_distribution": {
"1": 1347,
"2": 1182,
"3": 5542,
"4": 14981,
"5": 20424
},
"people_also_search": [...],
"work_time": {...},
"popular_times": {...},
"local_business_links": null,
"is_directory_item": false,
"directory": {
"title": "At this place",
"items": [
{
"type": "maps_search",
"rank_group": 1,
"rank_absolute": 1,
"domain": null,
"title": "Auchan",
"url": null,
"rating": {
"rating_type": "Max5",
"value": 3.9,
"votes_count": 8902,
"rating_max": null
},
"rating_distribution": {
"1": 738,
"2": 484,
"3": 1443,
"4": 2672,
"5": 3565
},
"snippet": null,
"address": "Centre Commercial Westfield les 4 Temps Le Parvis de La Défense, 92800 Puteaux",
"address_info": {
"borough": null,
"address": null,
"city": null,
"zip": null,
"region": null,
"country_code": null
},
"place_id": null,
"phone": null,
"main_image": "https://lh5.googleusercontent.com/p/AF1QipMqi1lQU-HO5GOKxkJMQMpxA8Cd3OqkrKgpacdd=w86-h86-n-k-no",
"total_photos": null,
"category": "Hypermarket",
"additional_categories": null,
"category_ids": null,
"work_hours": {...},
"feature_id": "0x47e665027ed18721:0x5f083e700fad2e91",
"cid": "6847791884437106321",
"latitude": 48.891155399999995,
"longitude": 2.2351446999999998,
"is_claimed": null,
"local_justifications": null,
"is_directory_item": true
},
{
"type": "maps_search",
"rank_group": 2,
"rank_absolute": 2,
"domain": null,
"title": "Vapiano",
"url": null,
"rating": {
"rating_type": "Max5",
"value": 4,
"votes_count": 7790,
"rating_max": null
},
"rating_distribution": {
"1": 756,
"2": 450,
"3": 912,
"4": 1927,
"5": 3745
},
"snippet": null,
"address": "92800 Puteaux",
"address_info": {
"borough": null,
"address": null,
"city": null,
"zip": null,
"region": null,
"country_code": null
},
"place_id": null,
"phone": null,
"main_image": "https://lh5.googleusercontent.com/p/AF1QipMlebWv4snHX1DvbN0RpMIjAMS-vC2pfKNFZ2ym=w86-h86-n-k-no",
"total_photos": null,
"category": "Italian restaurant",
"additional_categories": null,
"category_ids": null,
"work_hours": {...},
"feature_id": "0x47e66503711ec8e9:0x91cad55b639021da",
"cid": "10505443669284233690",
"latitude": 48.889736,
"longitude": 2.241843,
"is_claimed": null,
"local_justifications": null,
"is_directory_item": true
},
{
"type": "maps_search",
"rank_group": 3,
"rank_absolute": 3,
"domain": null,
"title": "Cultura",
"url": null,
"rating": {
"rating_type": "Max5",
"value": 4.3,
"votes_count": 7510,
"rating_max": null
},
"rating_distribution": {
"1": 188,
"2": 150,
"3": 834,
"4": 2586,
"5": 3752
},
"snippet": null,
"address": "Centre Commercial Les 4 Temps, 92800 Puteaux",
"address_info": {
"borough": null,
"address": null,
"city": null,
"zip": null,
"region": null,
"country_code": null
},
"place_id": null,
"phone": null,
"main_image": "https://lh5.googleusercontent.com/p/AF1QipMa8VTgJtwg3eeumi7zWIgHmFK2mMNgWRDvG8XU=w86-h86-n-k-no",
"total_photos": null,
"category": "Book Shop",
"additional_categories": null,
"category_ids": null,
"work_hours": {...},
"feature_id": "0x47e665023b1559bf:0xe6b5633b6ca1c985",
"cid": "16624302706384816517",
"latitude": 48.890842199999994,
"longitude": 2.2372359,
"is_claimed": null,
"local_justifications": null,
"is_directory_item": true
}
]
}
}
]
}
]
}
]
}
We encourage you to explore the updated structure of the Google Maps SERP API and Google My Business Info endpoint responses.
We also hope these latest enhancements provide you with more valuable data for your tools and projects.