# Google Search Business Updates API (https://www.socialcrawl.dev/platforms/google/business-updates)

> Returns the owner-published posts (updates) on a Google Business Profile: text, image, publish date, and any call-to-action link. Most businesses publish none; an empty result is a valid 'no posts' answer. Identify the business by keyword or cid.

TL;DR: `GET /v1/google/business/updates` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | no | Business name + location (e.g. 'Toyota of Manhattan New York'). |
| `cid` | no | Google customer id (cid) of the business. |
| `location_name` | no | Geographic context as 'City,Region,Country'. |
| `language_name` | no | Result language (default 'English'). |
| `since` | no | Only rows published on or after this date: YYYY-MM-DD (midnight UTC) or an ISO 8601 timestamp. Rows older than it are left off each page. This list is not in date order, so the walk does not stop at the date: keep following `next_cursor`, and each page costs what a page costs even when every row on it is filtered out. A row with no date is kept. `published_after`, `start_date`, `from_date`, `publish_time` (`yesterday`, `this-week`, `this-month`, `last-3-months`, `last-6-months`) and `max_age_days` are accepted and applied as `since`. |
| `until` | no | Only rows published on or before this date: YYYY-MM-DD (that whole UTC day is included) or an ISO 8601 timestamp. Newer rows are left off each page and the walk does not stop, so older pages follow. A row with no date is kept. `published_before`, `end_date` and `to_date` are accepted and applied as `until`. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/google/business/updates" \
  --data-urlencode "keyword=Toyota of Manhattan New York" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### How do I get Google Business posts with an API?

Send a GET request to /v1/google/business/updates for a business. SocialCrawl returns the owner-published posts (updates) on that Google Business Profile: each with its text, image, publish date, and any call-to-action link, in the unified schema used across every platform.

### What does each business update include?

Each update returns the post text, an image when the owner attached one, the publish date, and any call-to-action link (such as Order, Book, or Learn more). That covers the offers, events, and announcements a business shares directly on its Google profile.

### Can I monitor a competitor's Google posts?

Yes. Run this endpoint on a cron for any business and diff the results to catch new offers, events, and announcements as they go live. Because it returns publish dates, you can sort newest-first and alert on posts you have not seen before.

### How is this different from the reviews endpoint?

Updates are content the business owner publishes: promotions, events, news. The extended-reviews endpoint returns what customers and third-party sites say about the business. Use updates to track a brand's own messaging and reviews to track public sentiment.

### How much does the Google Business Posts API cost?

Each request costs 1 credit, powered by DataForSEO. New accounts get 100 free credits with no credit card required, enough to pull updates for 100 businesses, or build a daily post-monitoring cron before you pay anything.

See the full Google Search API: https://www.socialcrawl.dev/platforms/google

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How to get a Google Business Profile's owner posts with an API
- What API returns Google Business updates and call-to-action links?