Google Maps Posts API

GET   /api/v1/search?engine=google_maps_posts

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_id of the business whose posts you want, for example 0x8640c029f8083707:0xcd6e26f5984d9aaa. Get it from the data_id of a result of the Google Maps API or the Google Maps Autocomplete API.

    Note: The data_id parameter is not required if the place_id parameter is used.

  • Name
    place_id
    Required
    Required
    Description

    Parameter defines the Google place_id of the business, which starts with ChIJ, for example ChIJ0RWk_A5ZwokR-QEzcuKdpP4. More details about place_id can be found in the Google Maps Place ID documentation.

    Note: The place_id parameter is not required if the data_id parameter 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 hl languages.

  • Name
    gl
    Required
    Optional
    Description

    Parameter defines the country whose date formats the labels use. Check the full list of supported Google gl countries. Google serves no business posts for cn, cu, ir, ru and sy, 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_key authenticates 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 true to 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

Full Response
GET
https://www.searchapi.io/api/v1/search?data_id=0x89c2599a3ca3d9d3%3A0x4612ca7ce163b2dd&engine=google_maps_posts
Request
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)
Response
{
  "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

Posts by place_id
GET
https://www.searchapi.io/api/v1/search?engine=google_maps_posts&place_id=ChIJ0RWk_A5ZwokR-QEzcuKdpP4
Request
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)
Response
{
  "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())
Response
{
  "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

GET
https://www.searchapi.io/api/v1/search?data_id=0x89c2590efca415d1%3A0xfea49de2723301f9&engine=google_maps_posts&gl=jp&hl=ja
Request
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)
Response
{
  "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": "..."
  }
}