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.
| Connection | OAuth 2.0 in the browser |
|---|---|
| Channel | Required: pick a channel after connecting |
| Post types | standard, event, offer, alert |
| Text length | 1,500 characters |
| Comment length | Comments not supported |
| Media per post | Up to 1 |
Media rules
| Kind | Formats | Max size | Duration | Other |
|---|---|---|---|---|
| Image | jpeg, png | 5 MB | n/a | min width 400px |
What Siar can do on Google Business Profile
| Comments and replies | No |
|---|---|
| First comment | No |
| Edit a published post | Yes |
| Delete a published post | Yes |
| Edit a comment | No |
| Delete a comment | No |
| Import comments | No |
| Post analytics | No |
| Account analytics | Yes |
| Post history import | Yes |
| Direct messages | No |
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
-
textstring nullable -
uploadIdsstring[] nullable -
topicTypestring nullable default "STANDARD"One of:STANDARDEVENTOFFERALERT -
languageCodestring nullable -
callToActionTypestring nullableOne of:BOOKORDERSHOPLEARN_MORESIGN_UPCALL -
callToActionUrlstring nullable -
eventTitlestring nullable -
eventStartDatestring nullable date-time -
eventEndDatestring nullable date-time -
offerCouponCodestring nullable -
offerRedeemOnlineUrlstring nullable -
offerTermsConditionsstring nullable -
alertTypestring nullable default "COVID_19"One of:COVID_19
Daily caps
| Per connected account, per UTC day | Free | Pro | Business |
|---|---|---|---|
| Posts | 10 | 20 | 40 |
| Comments | 3 | 20 | 40 |
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.
| Operation | Endpoint |
|---|---|
| Add a media item (photo/video) using uploadId and category | POST /misc/google-business/media |
| List Google Business media items | GET /misc/google-business/media |
| Delete Google Business media item | DELETE /misc/google-business/media |
| Delete a Google Business post | DELETE /misc/google-business/post |
| Get Google Business location profile | GET /misc/google-business/location |
| Update Google Business location profile fields | PATCH /misc/google-business/location |
| Update Google Business regular/special/more hours | PATCH /misc/google-business/location/hours |
| Get Google Business location attributes | GET /misc/google-business/location/attributes |
| Update Google Business location attributes | PATCH /misc/google-business/location/attributes |
| List available Google Business attributes | GET /misc/google-business/location/attributes/available |
| List the search terms customers used to find the location | GET /misc/google-business/location/search-keywords |
| List available Google Business categories | GET /misc/google-business/location/categories/available |
| Get Google Business service list | GET /misc/google-business/location/service-list |
| Update Google Business service list | PATCH /misc/google-business/location/service-list |
| Get Google Business food menus | GET /misc/google-business/location/food-menus |
| Update Google Business food menus | PATCH /misc/google-business/location/food-menus |
| List Google Business place action links | GET /misc/google-business/location/place-action-links |
| Create Google Business place action link | POST /misc/google-business/location/place-action-links |
| Update Google Business place action link | PATCH /misc/google-business/location/place-action-links |
| Delete Google Business place action link | DELETE /misc/google-business/location/place-action-links |
| Start a new Google Reviews import | POST /misc/google-business/reviews/import |
| Get review import status list | GET /misc/google-business/reviews/import |
| Get review import by ID | GET /misc/google-business/reviews/import/{importId} |
| List imported Google Reviews | GET /misc/google-business/reviews |
| Get a single imported Google Review | GET /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 Review | DELETE /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.