---
title: "Get business posts"
method: GET
path: "/v1/google/maps/posts"
tags: ["Google Maps"]
---

# Get business posts

`GET /v1/google/maps/posts`

Get Google Business posts / updates for a Maps place.

**Approach**: searches the Google SERP for the business by ``ludocid``
(derived from the ``data_id``'s low hex part) and parses the knowledge
panel's ``data-attrid="kc:/local:any posts"`` and
``kc:/local:merchant_description`` sections. This is the same data
surface and other SERP-based scrapers use.

The Maps protobuf endpoints (``localposts``, ``batchexecute Qt4aBe``)
return empty for virtually all businesses even when they have posts
in the knowledge panel — Google deprecated those endpoints in favor
of the SERP knowledge panel.

Requires ``data_id`` (``0x...:0x...``), available from ``/maps/search``
results.

## Query parameters

- `data_id` string — Google Maps data ID (0x...:0x...) — from /maps/search results
- `place_id` string, nullable — Google place ID (ChIJ...)
- `hl` string — Language code
- `gl` string — Country code

## Response `200`

Successful Response

- MapsPostsResponse — Response for GET /api/v1/maps/posts.
  - `location_details` MapsLocationDetails — Business identity shown alongside posts (matches shape).
    - `name` string, nullable
    - `logo` string, nullable
  - `post_data` MapsPost[]
    - `description` string, nullable
    - `date` string, nullable
    - `image` string, nullable
    - `link` string, nullable
  - `has_updates` boolean — True when the SERP knowledge panel shows an 'Updates from' section
  - `merchant_description` string, nullable — The 'From the business' description text set by the business owner
  - `pagination` Pagination, required — Pagination metadata.
    - `current` union
      - integer
      - string
    - `next` string, nullable
    - `total_results` integer, nullable
    - `total_pages` integer, nullable
    - `page_no` object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)