> ## Documentation Index
> Fetch the complete documentation index at: https://docs.social-api.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Business Profile

> Connect and interact with Google Business Profile locations via the Google Business Profile API.

<Badge>Available</Badge>

[SocialAPI](https://social-api.ai) handles the Google Cloud OAuth client and Google Business Profile API access for you. No customer-side Google Cloud setup is required. See [Platform credentials](/guides/platform-credentials).

## At a glance

| Field         | Value                                                                        |
| ------------- | ---------------------------------------------------------------------------- |
| Platform slug | `google`                                                                     |
| Auth type     | OAuth 2.0 (Google)                                                           |
| API           | Google Business Profile API                                                  |
| Best for      | Local business presence: local posts and reviews on Google Business Profile. |

## Capabilities

| Feature              | Supported | Notes                                                                |
| -------------------- | --------- | -------------------------------------------------------------------- |
| List posts           | Yes       | GBP local posts (updates, offers, events)                            |
| Comments             | No        | Google Business Profile has no comments or Q\&A API (see note below) |
| Reply to comment     | No        | No comments or Q\&A API                                              |
| Moderate comment     | No        | Not supported by Google Business Profile API                         |
| Toggle post comments | No        | Not supported by Google Business Profile API                         |
| DMs                  | No        | Not supported by platform                                            |
| Reviews              | Yes       | Google Reviews on your business listing                              |
| Reply to review      | Yes       |                                                                      |
| Mentions             | No        | Not supported by platform                                            |
| Create post          | Yes       | Local posts (updates, offers, events)                                |
| Update post          | Yes       |                                                                      |
| Delete post          | Yes       |                                                                      |

## Connecting

```bash theme={null}
curl -X POST https://api.social-api.ai/v1/accounts/connect \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "google",
    "redirect_uri": "https://app.example.com/oauth/callback",
    "state": "session_abc123"
  }'
```

Response:

```json theme={null}
{
  "auth_url": "https://accounts.google.com/o/oauth2/v2/auth?client_id=...&state=...",
  "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2"
}
```

Redirect your user to `auth_url`. After they authorize, SocialAPI exchanges the code with Google and redirects the user to your `redirect_uri` with the connection result. See [OAuth flows](/guides/oauth#step-3-receive-the-result-at-your-redirect_uri) for the redirect parameters.

<Note>
  If the Google login manages more than one Business Profile, the redirect carries `status=selection_required` and a `connection_id` instead of an immediate `account_id`. See [Google: connecting a login with multiple Business Profiles](/guides/oauth#google-connecting-a-login-with-multiple-business-profiles) for the selection steps. This only applies to logins with more than one Profile; a single-Profile login connects directly.
</Note>

## Reading samples

### List posts

```bash theme={null}
curl "https://api.social-api.ai/v1/posts?account_ids=acc_01HZ9X3Q4R5M6N7P8V2K0W1J" \
  -H "Authorization: Bearer $SOCAPI_KEY"
```

### Comments and Q\&A

Google Business Profile does not offer a comments or Q\&A API. Google discontinued the Business Profile Q\&A API on November 3, 2025, with no replacement, and Google Business Profile has never had post-level comments. Reading or answering questions through the API is not available.

### List reviews

```bash theme={null}
curl "https://api.social-api.ai/v1/inbox/reviews/{account_id}" \
  -H "Authorization: Bearer $SOCAPI_KEY"
```

Sample response:

```json theme={null}
{
  "data": [
    {
      "author": {
        "avatar_url": "https://example.com/avatar.jpg",
        "id": "17841405793187218",
        "name": "Jane Smith",
        "username": "janesmith"
      },
      "created_at": "2026-06-20T18:24:31Z",
      "id": "sapi_rev_TXY...",
      "rating": 3,
      "reply": {
        "text": "Thanks for the feedback!",
        "updated_at": "2026-06-21T10:00:00Z"
      },
      "text": "Great school",
      "updated_at": "2026-06-20T18:24:31Z"
    }
  ],
  "pagination": {
    "has_more": true,
    "next_cursor": "<string>"
  },
  "summary": {
    "average_rating": 4.2,
    "total_count": 87
  }
}
```

To reply to a review:

```bash theme={null}
curl -X POST \
  "https://api.social-api.ai/v1/inbox/reviews/{id}/reply" \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thank you for your kind review, Jane!", "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J"}'
```

## Publishing

For the full field reference, media constraints, and error recovery, see [Publishing to Google](/posts/google).

## Limitations and gotchas

* **Local posts** include updates, offers, and event posts published through Google Business Profile.
* **Token refresh**: Google OAuth tokens expire after 1 hour. [SocialAPI](https://social-api.ai) handles refresh automatically. If you receive `401` with `code: "platform.google.auth"`, reconnect the account.

## Permissions

[SocialAPI](https://social-api.ai)'s managed Google Cloud OAuth app already requests these scopes on your behalf: `https://www.googleapis.com/auth/business.manage`. You don't need to set up a Google Cloud project. See [Platform credentials](/guides/platform-credentials).

## Related

* [Platform credentials](/guides/platform-credentials)
* [OAuth flows](/guides/oauth)
* [Publishing to Google](/posts/google)
* [Errors](/guides/errors)
* [Interaction IDs](/guides/interaction-ids)