Share updates, photos, events, and special offers on your Google Business Profile via the Publer API. Each post type has its own fields—use the right payload to drive engagement and conversions.
General news or announcement with an image and a CTA button.
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"google": {
"type": "photo",
"text": "Our new feature is live!\npubler.com",
"title": "LEARN_MORE",
"media": [
{
"id": "68133d70f09cb4aa6377d2dc",
"path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
"thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
"type": "photo"
}
]
}
},
"accounts": [
{
"id": "GOOGLE_ACCOUNT_ID",
"scheduled_at": "2025-05-24T08:46:00-04:00"
}
]
}
]
}
}Standalone photo update (no special details).
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"google": {
"type": "photo",
"details": { "type": "photo" },
"text": "Our office view today!",
"title": "PROFILE",
"media": [
{
"id": "68133d70f09cb4aa6377d2dc",
"path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
"thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
"type": "photo"
}
]
}
},
"accounts": [
{
"id": "GOOGLE_ACCOUNT_ID",
"scheduled_at": "2025-05-24T08:50:00-04:00"
}
]
}
]
}
}Promote an upcoming event with start/end times and an optional link.
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"google": {
"type": "photo",
"details": {
"type": "event",
"title": "Summer Workshop",
"start": "2025-06-07T12:50:00Z",
"end": "2025-08-03T12:50:00Z"
},
"text": "Join our Summer Workshop series!",
"title": "LEARN_MORE",
"url": "https://publer.com/events",
"media": [
{
"id": "68133d70f09cb4aa6377d2dc",
"path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
"thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
"type": "photo"
}
]
}
},
"accounts": [
{
"id": "GOOGLE_ACCOUNT_ID",
"scheduled_at": "2025-06-07T08:50:00-04:00"
}
]
}
]
}
}Advertise discounts or promotions with coupon codes and terms.
{
"bulk": {
"state": "scheduled",
"posts": [
{
"networks": {
"google": {
"type": "photo",
"details": {
"type": "offer",
"title": "Spring Sale",
"start": "2025-05-28T12:50:00Z",
"end": "2025-10-02T12:50:00Z",
"coupon": "30%OFF",
"terms": "https://publer.com/terms"
},
"text": "Enjoy 30% off sitewide!",
"url": "https://publer.com/sale",
"media": [
{
"id": "68133d70f09cb4aa6377d2dc",
"path": "https://cdn.publer.com/uploads/photos/68133d70f09cb4aa6377d2dc.png",
"thumbnail": "https://cdn.publer.com/uploads/photos/thumb_68133d70f09cb4aa6377d2dc.png",
"type": "photo"
}
]
}
},
"accounts": [
{
"id": "GOOGLE_ACCOUNT_ID",
"scheduled_at": "2025-06-14T08:50:00-04:00"
}
]
}
]
}
}networks.google.type
string
"photo"
networks.google.text
string
Main caption or description.
networks.google.title
string
CTA button label (LEARN_MORE, PROFILE, etc.).
networks.google.url
string
External URL (for events/offers).
networks.google.media[]
array
Array of 1 media object with keys: id, path, thumbnail, and type: "photo".
networks.google.details.type
string
One of: "photo", "event", "offer".
networks.google.details.title
string
Event or offer title (required for event/offer).
networks.google.details.start
string
ISO 8601 start date/time (for events/offers).
networks.google.details.end
string
ISO 8601 end date/time (for events/offers).
networks.google.details.coupon
string
Coupon code (offers only).
networks.google.details.terms
string
URL to terms & conditions (offers only).
accounts[].id
string
Google Business Profile account ID.
accounts[].scheduled_at
string
ISO 8601 timestamp for scheduling (omit for immediate publish).
Post Types
Updates, Photos, Events, Offers
Max Photo Size
5 MB
Min Photo Resolution
250 × 250 pixels
Call-to-Action Buttons
Supported (LEARN_MORE, PROFILE, etc.)
Events
Requires start and end fields
Offers
Supports coupon and terms
Video Support
Not supported
Select Profile
Choose the Google Business Profile in accounts[].id.
Choose Post Type
Update: general news with image & CTA.
Photo: standalone image.
Event: include details.type = "event", dates, and optional link.
Offer: include details.type = "offer", dates, coupon, and terms URL.
Add Media Upload or reference one photo via the Media Upload API.
Compose & Schedule
Build your JSON, set state and scheduled_at, then POST to /posts/schedule.
Use high-resolution images (≥250×250 pixels).
Craft clear CTAs to direct user action.
Include complete offer details (coupon & terms).
Set accurate event dates for reliable reminders.