NetworksGoogle Business Profile

Google Business Profile APIthrough Siar.

Updates, offers, events and alerts on a Google Business Profile location, plus reviews, hours, attributes, media and menus through location-level operations.

At a glance

Account needed: A Google account that manages one or more Business Profile locations. Pick the location after sign-in.

ConnectionOAuth 2.0 in the browser
ChannelRequired: pick a channel after connecting
Post typesstandard, event, offer, alert
Text length1,500 characters
Comment lengthComments not supported
Media per postUp to 1

Media rules

KindFormatsMax sizeDurationOther
Imagejpeg, png5 MBn/amin width 400px

What Siar can do on Google Business Profile

Comments and repliesNo
First commentNo
Edit a published postYes
Delete a published postYes
Edit a commentNo
Delete a commentNo
Import commentsNo
Post analyticsNo
Account analyticsYes
Post history importYes
Direct messagesNo

Google Business Profile does not expose comments through its API, so comment features are not available for Google Business Profile accounts.

Publish a post

Put Google Business Profile's payload under data.GOOGLE_BUSINESS and list GOOGLE_BUSINESS in socialAccountTypes. Add other networks to the same request to post to all of them at once.

curl -X POST "https://api.siaran.my/api/v1/post" \
  -H "x-api-key: $SIAR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "teamId": "TEAM_ID",
    "title": "Google Business Profile post",
    "postDate": "2026-11-02T09:00:00.000Z",
    "status": "SCHEDULED",
    "socialAccountTypes": [
      "GOOGLE_BUSINESS"
    ],
    "data": {
      "GOOGLE_BUSINESS": {
        "text": "Hello from Siar",
        "uploadIds": [
          "UPLOAD_ID"
        ],
        "topicType": "STANDARD"
      }
    }
  }'

Google Business Profile fields

  • text string nullable
  • uploadIds string[] nullable
  • topicType string nullable default "STANDARD"
    One of: STANDARD EVENT OFFER ALERT
  • languageCode string nullable
  • callToActionType string nullable
    One of: BOOK ORDER SHOP LEARN_MORE SIGN_UP CALL
  • callToActionUrl string nullable
  • eventTitle string nullable
  • eventStartDate string nullable date-time
  • eventEndDate string nullable date-time
  • offerCouponCode string nullable
  • offerRedeemOnlineUrl string nullable
  • offerTermsConditions string nullable
  • alertType string nullable default "COVID_19"
    One of: COVID_19

Daily caps

Per connected account, per UTC dayFreeProBusiness
Posts102040
Comments32040

See pricing for monthly quotas. Enterprise uses the Business caps unless agreed otherwise.

Connecting a Google Business Profile account

Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire. Use POST /social-account/connect from your own UI, or send your customer a hosted link from POST /social-account/create-portal-link; see connecting accounts.

Permissions requested

Siar requests only these scopes at connect time:

  • https://www.googleapis.com/auth/business.manage

Google Business Profile-specific operations

These exist for Google Business Profile only and live under /misc/google-business.

OperationEndpoint
Add a media item (photo/video) using uploadId and categoryPOST /misc/google-business/media
List Google Business media itemsGET /misc/google-business/media
Delete Google Business media itemDELETE /misc/google-business/media
Delete a Google Business postDELETE /misc/google-business/post
Get Google Business location profileGET /misc/google-business/location
Update Google Business location profile fieldsPATCH /misc/google-business/location
Update Google Business regular/special/more hoursPATCH /misc/google-business/location/hours
Get Google Business location attributesGET /misc/google-business/location/attributes
Update Google Business location attributesPATCH /misc/google-business/location/attributes
List available Google Business attributesGET /misc/google-business/location/attributes/available
List the search terms customers used to find the locationGET /misc/google-business/location/search-keywords
List available Google Business categoriesGET /misc/google-business/location/categories/available
Get Google Business service listGET /misc/google-business/location/service-list
Update Google Business service listPATCH /misc/google-business/location/service-list
Get Google Business food menusGET /misc/google-business/location/food-menus
Update Google Business food menusPATCH /misc/google-business/location/food-menus
List Google Business place action linksGET /misc/google-business/location/place-action-links
Create Google Business place action linkPOST /misc/google-business/location/place-action-links
Update Google Business place action linkPATCH /misc/google-business/location/place-action-links
Delete Google Business place action linkDELETE /misc/google-business/location/place-action-links
Start a new Google Reviews importPOST /misc/google-business/reviews/import
Get review import status listGET /misc/google-business/reviews/import
Get review import by IDGET /misc/google-business/reviews/import/{importId}
List imported Google ReviewsGET /misc/google-business/reviews
Get a single imported Google ReviewGET /misc/google-business/reviews/{reviewId}
Reply to a Google Review (creates or updates the owner reply)PUT /misc/google-business/reviews/{reviewId}/reply
Delete the owner reply from a Google ReviewDELETE /misc/google-business/reviews/{reviewId}/reply

When Google Business Profile says no

Siar relays Google Business Profile's error code and message verbatim on the post, next to a status you can act on. The Google Business Profile error reference covers 10 common cases with what each one means and the fix. Open the Google Business Profile error reference.

Google Business Profile API questions

What can I post to Google Business Profile through the API?

standard, event, offer, alert. Updates, offers, events and alerts on a Google Business Profile location, plus reviews, hours, attributes, media and menus through location-level operations.

How many Google Business Profile posts can I publish per day?

Per connected account and UTC day: 10 on Free, 20 on Pro, 40 on Business. The caps keep the account within what Google Business Profile tolerates.

Can I schedule Google Business Profile posts?

Yes. Set postDate in the future and a status of SCHEDULED. Siar publishes at that time and sends a post.published webhook when the post reaches a final state.

How do I connect a Google Business Profile account?

A Google account that manages one or more Business Profile locations. Pick the location after sign-in. Siar sends the user to the network's consent page and stores the tokens it gets back, refreshing them before they expire.

What do I do when Google Business Profile rejects a post?

The post carries Google Business Profile's own code and message. The Google Business Profile error reference explains 10 common rejections and how to fix them.

Your first post isone request away.

The Free plan includes 20 posts and 200 uploads a month across 3 teams. No card needed.