Google Business Profile

Available SocialAPI 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.

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

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:

{
  "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 for the redirect parameters.

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 for the selection steps. This only applies to logins with more than one Profile; a single-Profile login connects directly.

Reading samples

List posts

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

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

Sample response:

{
  "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:

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.

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 handles refresh automatically. If you receive 401 with code: "platform.google.auth", reconnect the account.

Permissions

SocialAPI’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.

​At a glance

​Capabilities

​Connecting

​Reading samples

​List posts

​Comments and Q&A

​List reviews

​Publishing

​Limitations and gotchas

​Permissions

​Related

At a glance

Capabilities

Connecting

Reading samples

List posts

Comments and Q&A

List reviews

Publishing

Limitations and gotchas

Permissions

Related