Google Business Profile

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

Coming soon

Coming soon. Google Business Profile (formerly Google My Business) integration is in active development via the Google Business Profile API. The connector will cover reviews, local posts, and comments on those posts.

When it launches, SocialAPI will handle the Google Cloud OAuth client and Google Business Profile API access for you. No customer-side Google Cloud setup will be 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: posts, reviews, and Q&A on Google Business Profile.

Capabilities

Feature	Supported	Notes
List posts	Coming soon	GBP local posts (updates, offers, events)
Comments	Coming soon	Comments on local posts
Reply to comment	Coming soon
Comment replies (thread)	Coming soon
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	Coming soon	Google Reviews on your business listing
Reply to review	Coming soon
Mentions	No	Not supported by platform
Create post	Coming soon	Local posts (updates, offers, events)
Update post	Coming soon
Delete post	Coming soon

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",
    "metadata": {
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'

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, Google redirects to your redirect_uri with ?code=...&state=.... Then call:

curl -X POST https://api.social-api.ai/v1/oauth/exchange \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "platform": "google",
    "code": "4/0AX4XfWh...",
    "metadata": {
      "state": "4a8f2c1e9b3d7f06a5c2e8b4d1f3a7e2",
      "redirect_uri": "https://app.example.com/oauth/callback"
    }
  }'

Reading samples

List posts

curl "https://api.social-api.ai/v1/posts?account_ids=acc_01HZ9X3Q4R5M6N7P8V2K0W1J&limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

List comments on a post

curl "https://api.social-api.ai/v1/accounts/{id}/posts/{pid}/comments?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

List reviews

curl "https://api.social-api.ai/v1/accounts/{id}/reviews?limit=10" \
  -H "Authorization: Bearer $SOCAPI_KEY"

Sample response:

{
  "data": [
    {
      "id": "sapi_rev_Z29vZ2xlOmNoSUpBYnVu",
      "platform": "google",
      "type": "review",
      "author": {
        "id": "accounts/123456789",
        "name": "Jane Smith",
        "avatar_url": "https://lh3.googleusercontent.com/..."
      },
      "content": {
        "text": "Great service, highly recommend!",
        "media": []
      },
      "metadata": {
        "rating": 5
      },
      "created_at": "2026-03-01T14:30:00Z",
      "account_id": "acc_01HZ9X3Q4R5M6N7P8V2K0W1J",
      "platform_id": "chIJAbun..."
    }
  ],
  "count": 1
}

To reply to a review:

curl -X POST \
  "https://api.social-api.ai/v1/accounts/{id}/interactions/sapi_rev_Z29vZ2xlOmNoSUpBYnVu/reply" \
  -H "Authorization: Bearer $SOCAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "Thank you for your kind review, Jane!"}'

Publishing

For the full field reference, media constraints, and error recovery, see Publishing to Google.

Limitations and gotchas

• Review ratings are returned in metadata.rating as an integer (1-5).
• 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: "invalid_token", 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.

Related

• Platform credentials
• OAuth flows
• Publishing to Google
• Errors
• Interaction IDs