# Posts

Fetch the owner posts of the Updates tab of a single Google Maps place: post text, offer and event headlines, validity window, call-to-action link, thumbnails and publication date. Posts come newest first, 10 per page, and the response carries the next page token.

- **Documentation:** [https://scrappa.co/docs/google-maps-api/google_maps_posts](https://scrappa.co/docs/google-maps-api/google_maps_posts)
- **API group:** Google Maps API
- **Endpoint:** `GET https://scrappa.co/api/maps/posts`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `data_id` | string | Yes | Google Maps place identifier in google_id (0x...:0x...) format, the same id the reviews endpoints accept. |
| `next_page_token` | string | No | Token from the previous response to read the next, older page of posts. |
| `hl` | string | No | Interface language for the upstream payload. |
| `gl` | string | No | Country/region code for the upstream payload. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/maps/posts?data_id=0x89c259a61c75684f%3A0x79d31adb123348d2&hl=en&gl=us"
```

## Example response

```json
{
    "place": {
        "data_id": "0x89c259a61c75684f:0x79d31adb123348d2",
        "cid": "8778389626880739538",
        "name": "Stumptown Coffee Roasters",
        "logo": "https://lh6.googleusercontent.com/-uNxSvNQ0g1M/AAAAAAAAAAI/AAAAAAAAAAA/_ns-K8u9qxU/s40-c-k-mo/photo.jpg"
    },
    "posts": [
        {
            "post_id": "7922670519655566438",
            "title": null,
            "description": "We're proud to welcome back Costa Rica Montes de Oro to our single-origin lineup for the 15th year! Enjoy tasty notes of crisp green apple, syrupy apricot, and caramel sweetness in every cup.",
            "link": "http://stumptowncoffee.com/",
            "post_link": "https://search.google.com/local/posts?q=Stumptown+Coffee+Roasters&ludocid=8778389626880739538&lpsid=CIHM0ogKEICAgIC6ibDXGg&source=sh/x/loc/post/m1/1&lsig=AB86z5Vmj2Bn15Dk-BEO21A7q_SQ&shem=epsd1,esd2e,rimspwouoe,sdpie&shndl=-1",
            "thumbnails": [
                "https://lh3.googleusercontent.com/geougc/AF1QipMRyagBv6NZAjs4n7GOE7zjFMXos10L9mCYN5Gr=h305-no"
            ],
            "source": "Stumptown Coffee Roasters",
            "source_logo": "https://lh6.googleusercontent.com/-uNxSvNQ0g1M/AAAAAAAAAAI/AAAAAAAAAAA/_ns-K8u9qxU/s40-c-k-mo/photo.jpg",
            "online_link": "http://stumptowncoffee.com/",
            "online_link_text": "Order online",
            "posted_at_text": "Sep 7, 2021",
            "time": null
        },
        {
            "post_id": "1365009519158844022",
            "title": "Free Shipping",
            "description": "Free shipping on all orders until 9/5",
            "link": "https://search.google.com/local/posts?q=Stumptown+Coffee+Roasters&ludocid=8778389626880739538&lpsid=136500",
            "post_link": "https://search.google.com/local/posts?q=Stumptown+Coffee+Roasters&ludocid=8778389626880739538&lpsid=136500",
            "thumbnails": [
                "https://lh3.googleusercontent.com/geougc/AF1QipPjMsnKP14O3fJfh89EqfFopfpoG-b8dmq4MUvK=h305-no"
            ],
            "source": "Stumptown Coffee Roasters",
            "source_logo": "https://lh6.googleusercontent.com/-uNxSvNQ0g1M/AAAAAAAAAAI/AAAAAAAAAAA/_ns-K8u9qxU/s40-c-k-mo/photo.jpg",
            "online_link": "https://search.google.com/local/posts?q=Stumptown+Coffee+Roasters&ludocid=8778389626880739538&lpsid=136500",
            "online_link_text": "View Offer",
            "posted_at_text": "Aug 30, 2021",
            "time": "Valid Aug 30 - Sep 5"
        }
    ],
    "pagination": {
        "next_page_token": "CgsI6b369gUQwLGfBSoA",
        "has_more": true,
        "posts_returned": 10
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | Validation Error | The data_id, next_page_token, hl or gl parameter failed validation before any upstream request ran. This response is not billed. |
| 503 | Posts Temporarily Unavailable | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)