Google Maps Posts API
The Google Maps Posts API returns the posts a business publishes on its Google Business Profile: updates, events, offers and alerts, newest first and 10 per page. Each post comes with its type, the date Google shows, an exact publish time and its share link, plus its title, full text, photos, videos, call to action and offer terms when available. The business it belongs to comes alongside.
API Parameters
Search Query
-
- Name
-
data_id - Required
- Required
- Description
-
Parameter defines the Google Maps
data_idof the business whose posts you want, for example0x8640c029f8083707:0xcd6e26f5984d9aaa. Get it from thedata_idof a result of the Google Maps API or the Google Maps Autocomplete API. Note: Thedata_idparameter is not required if theplace_idparameter is used.
-
- Name
-
place_id - Required
- Required
- Description
-
Parameter defines the Google
place_idof the business, which starts withChIJ, for exampleChIJ0RWk_A5ZwokR-QEzcuKdpP4. More details aboutplace_idcan be found in the Google Maps Place ID documentation. Note: Theplace_idparameter is not required if thedata_idparameter is used.
Localization
-
- Name
-
hl - Required
- Optional
- Description
-
Parameter defines the language of the date and call to action labels. The text of a post stays in the language the business wrote it in. Check the full list of supported Google
hllanguages.
-
- Name
-
gl - Required
- Optional
- Description
-
Parameter defines the country whose date formats the labels use. Check the full list of supported Google
glcountries. Google serves no business posts forcn,cu,ir,ruandsy, so those values are refused.
Pagination
-
- Name
-
next_page_token - Required
- Optional
- Description
-
Parameter defines the token that retrieves the next 10 posts of the same business. Copy it unchanged from the JSON response under
pagination.next_page_token. Tokens for another business return an error. The last page has no token.
Engine
-
- Name
-
engine - Required
- Required
- Description
-
Parameter defines an engine that will be used to retrieve real-time data. It must be set to
google_maps_posts.
API key
-
- Name
-
api_key - Required
- Required
- Description
-
The
api_keyauthenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).
Zero Data Retention
-
- Name
-
zero_retention - Enterprise Only
- Enterprise Only
- Required
- Optional
- Description
-
Set this parameter to
trueto disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.
API Examples
Full Response
https://www.searchapi.io/api/v1/search?data_id=0x89c2599a3ca3d9d3%3A0x4612ca7ce163b2dd&engine=google_maps_posts
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_maps_posts",
"data_id": "0x89c2599a3ca3d9d3:0x4612ca7ce163b2dd"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_FJxhzXrxBVPooFK85dkyHeMK",
"status": "Success",
"created_at": "2026-11-12T14:47:40Z",
"request_time_taken": 5.74,
"parsing_time_taken": 0.0,
"total_time_taken": 5.74,
"request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x89c2599a3ca3d9d3:0x4612ca7ce163b2dd!8m2!3d0!4d0?...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_FJxhzXrxBVPooFK85dkyHeMK.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_FJxhzXrxBVPooFK85dkyHeMK"
},
"search_parameters": {
"engine": "google_maps_posts",
"data_id": "0x89c2599a3ca3d9d3:0x4612ca7ce163b2dd",
"hl": "en",
"gl": "us"
},
"place_result": {
"title": "LaVista Pizza",
"data_id": "0x89c2599a3ca3d9d3:0x4612ca7ce163b2dd",
"place_id": "ChIJ09mjPJpZwokR3bJj4XzKEkY",
"ludocid": "5049320769941910237",
"thumbnail": "https://lh4.googleusercontent.com/-m4UTyZWtbqo/AAAAAAAAAAI/AAAAAAAAAAA/uJOoTwkhi3s/s40-c-k-mo/photo....",
"phone": "(212) 837-1593"
},
"posts": [
{
"position": 1,
"post_id": "977210316706489196",
"type": "event",
"title": "Late Summer Flavors for Everyone! 🥗🍕",
"snippet": "Craving variety? We’re more than just great crust! From fresh summer salads to juicy wings and party spreads, our full menu has something for every appetite.",
"date": "Aug 3, 2026",
"iso_date": "2026-08-03T20:15:07Z",
"schedule": "Aug 3 - Sep 7",
"images": [
{
"image": "https://lh3.googleusercontent.com/geougc/AF1QipNWrzfHrQ4fZ4fEq_D6iCOiwLKwSrL-JW40QvvB=h305-no",
"thumbnail": "https://lh3.googleusercontent.com/geougc/AF1QipNWrzfHrQ4fZ4fEq_D6iCOiwLKwSrL-JW40QvvB=w232-h130-p-no"
},
"..."
],
"cta": "Order online",
"link": "https://slicelife.com/restaurants/ny/new-york/10022/la-vista-pizza-2/menu?utm_source=gmb_event&utm_c...",
"post_link": "https://search.google.com/local/posts?q=LaVista+Pizza&ludocid=5049320769941910237&lpsid=CIHM0ogKENbR..."
},
"..."
],
"pagination": {
"next_page_token": "..."
}
}
Posts by place_id
https://www.searchapi.io/api/v1/search?engine=google_maps_posts&place_id=ChIJ0RWk_A5ZwokR-QEzcuKdpP4
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_maps_posts",
"place_id": "ChIJ0RWk_A5ZwokR-QEzcuKdpP4"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_y4ZLbxTW5SPNvqGF781ufx3J",
"status": "Success",
"created_at": "2026-11-12T14:47:46Z",
"request_time_taken": 4.59,
"parsing_time_taken": 0.0,
"total_time_taken": 4.59,
"request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x89c2590efca415d1:0xfea49de2723301f9!8m2!3d0!4d0?...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_y4ZLbxTW5SPNvqGF781ufx3J.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_y4ZLbxTW5SPNvqGF781ufx3J"
},
"search_parameters": {
"engine": "google_maps_posts",
"data_id": "0x89c2590efca415d1:0xfea49de2723301f9",
"place_id": "ChIJ0RWk_A5ZwokR-QEzcuKdpP4",
"hl": "en",
"gl": "us"
},
"place_result": {
"title": "Don Antonio",
"data_id": "0x89c2590efca415d1:0xfea49de2723301f9",
"place_id": "ChIJ0RWk_A5ZwokR-QEzcuKdpP4",
"ludocid": "18348964377718358521",
"thumbnail": "https://lh5.googleusercontent.com/-EmgClDe0cHU/AAAAAAAAAAI/AAAAAAAAAAA/kKuEqDJgZ-M/s40-c-k-mo/photo....",
"phone": "(646) 719-1043"
},
"posts": [
{
"position": 1,
"post_id": "5985246245808434546",
"type": "update",
"snippet": "World Cup's heating up this weekend. Watching the match? Order a pizza ahead and skip the wait. Delivery available!",
"date": "Jul 11, 2026",
"iso_date": "2026-07-11T15:00:00Z",
"images": [
{
"image": "https://lh3.googleusercontent.com/geougc/AF1QipNQ_GwY6swHdf88nvWuPPHmEkCpy4d1yAw-XcNL=h305-no",
"thumbnail": "https://lh3.googleusercontent.com/geougc/AF1QipNQ_GwY6swHdf88nvWuPPHmEkCpy4d1yAw-XcNL=w232-h130-p-no"
},
"..."
],
"cta": "Order online",
"link": "https://www.donantoniopizza.com/order-online/#/restaurants/donantonio/18081",
"post_link": "https://search.google.com/local/posts?q=Don+Antonio&ludocid=18348964377718358521&lpsid=CIHM0ogKELCs-..."
},
"..."
],
"pagination": {
"next_page_token": "..."
}
}
Next Page
Set SEARCHAPI_API_KEY to your API key. This Python example uses requests to fetch the first page and, if available, the next page for the same business. Tokens in the example response are abbreviated.
import os
import requests
url = "https://www.searchapi.io/api/v1/search"
headers = {"Authorization": "Bearer " + os.environ["SEARCHAPI_API_KEY"]}
params = {"engine": "google_maps_posts", "data_id": "0x8640c029f8083707:0xcd6e26f5984d9aaa"}
first = requests.get(url, headers=headers, params=params, timeout=90)
first.raise_for_status()
token = first.json().get("pagination", {}).get("next_page_token")
if token:
second = requests.get(url, headers=headers, params={**params, "next_page_token": token}, timeout=90)
second.raise_for_status()
print(second.json())
{
"search_metadata": {
"id": "search_XIEHzEtUU0e1wYuFagHV59er",
"status": "Success",
"created_at": "2026-11-12T14:47:56Z",
"request_time_taken": 1.35,
"parsing_time_taken": 0.0,
"total_time_taken": 1.35,
"request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x8640c029f8083707:0xcd6e26f5984d9aaa!8m2!3d0!4d0?...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_XIEHzEtUU0e1wYuFagHV59er.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_XIEHzEtUU0e1wYuFagHV59er"
},
"search_parameters": {
"engine": "google_maps_posts",
"data_id": "0x8640c029f8083707:0xcd6e26f5984d9aaa",
"hl": "en",
"gl": "us",
"next_page_token": "..."
},
"place_result": {
"title": "Doggett Ford South Loop",
"data_id": "0x8640c029f8083707:0xcd6e26f5984d9aaa",
"place_id": "ChIJBzcI-CnAQIYRqppNmPUmbs0",
"ludocid": "14802811861477464746",
"thumbnail": "https://lh5.googleusercontent.com/-4lwooD0qaUY/AAAAAAAAAAI/AAAAAAAAAAA/9YA6jjHNqxA/s40-c-k-mo/photo.jpg",
"phone": "(346) 560-7160"
},
"posts": [
{
"position": 11,
"post_id": "8306340105422328150",
"type": "update",
"snippet": "Sunny skies + a full lot = it’s a GOOD weekend at Doggett Ford! Spend your weekend the right way and come check out what’s waiting for you on our lot! Whether you’re F-Series shopping, Bronco shopping, or just here to catch some Texas sunshine, we’re ready for you! Click the link below to get started. \n\nHappy Friday from Doggett Ford South Loop!",
"date": "Sep 19, 2026",
"iso_date": "2026-09-19T19:13:03Z",
"images": [
{
"image": "https://lh3.googleusercontent.com/geougc/AF1QipPw1PYdyd4hCL1cSymh6M_iWGIBHWpBdhaoMMLW=h305-no",
"thumbnail": "https://lh3.googleusercontent.com/geougc/AF1QipPw1PYdyd4hCL1cSymh6M_iWGIBHWpBdhaoMMLW=w232-h130-p-no"
},
"..."
],
"cta": "Order online",
"link": "https://www.doggettfordsouthloop.com/inventory/new-vehicles/",
"post_link": "https://search.google.com/local/posts?q=Doggett+Ford+South+Loop&ludocid=14802811861477464746&lpsid=C..."
},
"..."
],
"pagination": {
"next_page_token": "..."
}
}
Localized Labels
https://www.searchapi.io/api/v1/search?data_id=0x89c2590efca415d1%3A0xfea49de2723301f9&engine=google_maps_posts&gl=jp&hl=ja
- Python
- Node
- Ruby
- Java
- Go
- PHP
- Bash
- R
- Kotlin
- Swift
- C#
- C
- C++
- requests
import requests
url = "https://www.searchapi.io/api/v1/search"
params = {
"engine": "google_maps_posts",
"data_id": "0x89c2590efca415d1:0xfea49de2723301f9",
"hl": "ja",
"gl": "jp"
}
response = requests.get(url, params=params)
print(response.text)
{
"search_metadata": {
"id": "search_X2n5SizvLKUk7QpKm7n2slLH",
"status": "Success",
"created_at": "2026-11-12T14:47:57Z",
"request_time_taken": 0.88,
"parsing_time_taken": 0.0,
"total_time_taken": 0.88,
"request_url": "https://www.google.com/maps/place/data=!4m5!3m4!1s0x89c2590efca415d1:0xfea49de2723301f9!8m2!3d0!4d0?...",
"html_url": "https://www.searchapi.io/api/v1/searches/search_X2n5SizvLKUk7QpKm7n2slLH.html",
"json_url": "https://www.searchapi.io/api/v1/searches/search_X2n5SizvLKUk7QpKm7n2slLH"
},
"search_parameters": {
"engine": "google_maps_posts",
"data_id": "0x89c2590efca415d1:0xfea49de2723301f9",
"hl": "ja",
"gl": "jp"
},
"place_result": {
"title": "ドン アントニオ",
"data_id": "0x89c2590efca415d1:0xfea49de2723301f9",
"place_id": "ChIJ0RWk_A5ZwokR-QEzcuKdpP4",
"ludocid": "18348964377718358521",
"thumbnail": "https://lh5.googleusercontent.com/-EmgClDe0cHU/AAAAAAAAAAI/AAAAAAAAAAA/kKuEqDJgZ-M/s40-c-k-mo/photo....",
"phone": "+1 646-719-1043"
},
"posts": [
{
"position": 1,
"post_id": "5985246245808434546",
"type": "update",
"snippet": "World Cup's heating up this weekend. Watching the match? Order a pizza ahead and skip the wait. Delivery available!",
"date": "2026/07/11",
"iso_date": "2026-07-11T15:00:00Z",
"images": [
{
"image": "https://lh3.googleusercontent.com/geougc/AF1QipNQ_GwY6swHdf88nvWuPPHmEkCpy4d1yAw-XcNL=h305-no",
"thumbnail": "https://lh3.googleusercontent.com/geougc/AF1QipNQ_GwY6swHdf88nvWuPPHmEkCpy4d1yAw-XcNL=w232-h130-p-no"
},
"..."
],
"cta": "オンライン注文",
"link": "https://www.donantoniopizza.com/order-online/#/restaurants/donantonio/18081",
"post_link": "https://search.google.com/local/posts?q=%E3%83%89%E3%83%B3+%E3%82%A2%E3%83%B3%E3%83%88%E3%83%8B%E3%8..."
},
"..."
],
"pagination": {
"next_page_token": "..."
}
}