# Get Google Maps Business Posts

> Get Google Maps Business Posts is a paid API for AI agents from agents.litescrape.com, paid per call via MPP, $0.000150/call, status unknown (last checked 2026-09-18).

Retrieves the posts a business has published on its Google Maps listing, identified by a hexadecimal feature ID, with pagination support.

## Facts

- Endpoint: GET https://agents.litescrape.com/api/google/maps/posts
- Price: $0.000150/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Provider: agents.litescrape.com
- Website: https://agents.litescrape.com
- Canonical page: https://www.zero.xyz/c/agents-litescrape-com-get-google-maps-business-posts-b5f6e547
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vC-ViapBA_1Ktzr7bmsMa

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-litescrape-com-get-google-maps-business-posts-b5f6e547
```

Example prompt: Can you pull all the posts that Starbucks on Fifth Avenue in New York has published on their Google Maps listing? Their Maps feature ID is 0x89c259a9b3117469:0x35b1cfbc89a6097f.

## When to prefer this

Use this endpoint when you need to programmatically retrieve posts a business has published on their Google Maps profile without running a browser or managing proxies. It is the right choice when you already have a Maps feature ID (data_id) from a prior Maps search, or when following a posts_link from a Maps result. Prefer this over generic scraping when you need structured JSON output, pagination support, and a simple per-call pricing model with no subscription required.

## Known failure modes

- Invalid or malformed data_id returns an error JSON with error_code and status_code
- Business with no posts returns an empty posts array
- Expired or invalid next_page_token results in an error response
- Unsupported language or country code may fall back to defaults or return an error
- Rate limiting or payment failure returns a 402 or relevant HTTP error with retryable flag

## How this service works

Returns the posts a business has published on its Google Maps listing, identified by the listing's hexadecimal feature ID (the data_id on a Maps result, or follow its posts_link for a ready-made request). Responses carry a next_page_token when more posts exist. One call is one request.

## Output

Returns a JSON object containing an array of posts published by the business on their Google Maps listing, a pagination object with a next_page_token and ready-made next URL when additional pages exist, search_metadata (request ID, status, time taken), and the normalized search_parameters echoed back. Errors return a JSON body with error, error_code, status_code, request_id, retryable flag, and echoed parameters.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "data_id"
 ],
 "properties": {
  "gl": {
   "type": "string",
   "default": "us",
   "maxLength": 2,
   "minLength": 2,
   "description": "Two-letter country code for regional localization."
  },
  "hl": {
   "type": "string",
   "default": "en",
   "description": "Language for labels and returned text, such as en, es, or fr."
  },
  "data_id": {
   "type": "string",
   "description": "Hexadecimal Maps feature ID in the form 0x123:0x456."
  },
  "google_domain": {
   "type": "string",
   "default": "google.com",
   "description": "Google domain to query, such as google.com or google.co.uk."
  },
  "next_page_token": {
   "type": "string",
   "maxLength": 4096,
   "minLength": 16,
   "description": "Continuation token from a previous posts response."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "posts": {
   "type": "array",
   "items": {
    "type": "object"
   },
   "description": "Posts published on the listing."
  },
  "pagination": {
   "type": "object",
   "description": "Present when more results exist: next (a ready-made URL for the next page) or next_page_token."
  },
  "search_metadata": {
   "type": "object",
   "properties": {
    "id": {
     "type": "string"
    },
    "status": {
     "type": "string"
    },
    "total_time_taken": {
     "type": "number"
    }
   }
  },
  "search_parameters": {
   "type": "object",
   "description": "The request parameters as normalized by the API."
  }
 },
 "description": "Successful responses carry request metadata, the normalized parameters, and the result groups available for the operation. Optional groups are omitted when the source does not provide them. Errors are a JSON body with error, error_code, status_code, request_id, retryable, and the echoed search_parameters."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-litescrape-com-get-google-maps-business-posts-b5f6e547/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.litescrape.com](https://www.zero.xyz/host/agents.litescrape.com/llms.txt)