How to Post to Google Business Profile via API — Updates, Events & Offers

When someone searches for "coffee shop near me" or "plumber in Brooklyn," Google displays a Local Pack — three business listings with reviews, hours, and photos pulled directly from Google Business Profile. Businesses that publish regular GBP posts signal freshness to Google's ranking algorithm, which correlates with higher placement in the Local Pack and Maps results.

According to Google's own documentation, businesses with complete and active profiles are 2.7x more likely to be considered reputable by customers. Posts add another engagement layer: they show up as cards below your business info, giving searchers a reason to click through before they even visit your website.

The challenge is that most businesses treat GBP as a set-and-forget listing. They fill in the address and hours, maybe upload a logo, and never touch it again. Meanwhile, competitors who post weekly updates, events, and offers consistently outrank them in local search. The solution is automation — and that starts with the API.

CodivUpload exposes Google Business Profile as one of its 12 supported platforms. You post to GBP using the same API endpoint, the same authentication, and the same scheduling system you already use for TikTok, Instagram, YouTube, and the rest. No separate integration, no Google API credentials to manage — CodivUpload handles the OAuth flow and token refresh.

Franchise owners, restaurant chains, and service businesses with multiple branches face a specific challenge: each Google Business location is a separate listing that needs its own posts, photos, and engagement. Manually posting to 15 or 50 locations every week is not realistic.

CodivUpload solves this with the gbp_location_id parameter. Each API call targets one location. To publish the same offer to all your locations, iterate over your location IDs and send one request per location. The payload stays identical except for the location ID.

// Post the same offer to 3 locations
const locations = ["locations/001", "locations/002", "locations/003"];

for (const loc of locations) {
  await codiv.posts.create({
    profile_name: "chain-brand",
    platforms: ["google_business"],
    post_type: "text",
    description: "Grand opening sale — 30% off everything!",
    gbp_location_id: loc,
    gbp_topic_type: "OFFER",
    gbp_offer_coupon_code: "GRAND30",
  });
}

For businesses with dozens of locations, consider using CodivUpload's scheduling to stagger posts across locations — Google may throttle listings that receive many rapid updates simultaneously. A 30-second delay between requests is sufficient.

Google Business posts are most effective when published consistently. The ideal cadence is 1-2 posts per week per location. CodivUpload's scheduled_date field lets you batch-create an entire month of GBP content in one session.

Set scheduled_date to any future ISO 8601 timestamp. CodivUpload queues the post and publishes it at the specified time. You can also combine GBP posts with other platforms in the same scheduling workflow — publish an offer to Google Business and simultaneously announce it on Instagram, Facebook, and X.

A promotion does not stop at Google Business. The same offer should appear on Instagram, Facebook, and X to reach customers who do not search Google directly. CodivUpload's multi-platform posting makes this a single API call.

Add multiple platform slugs to the platforms array and include per-platform overrides. The GBP-specific parameters (gbp_*) are only sent to Google Business — Instagram, Facebook, and other platforms receive only their relevant fields.

For example, you could publish the same "Summer sale" message to Google Business (as an OFFER with coupon code), Instagram (as a Reel with location tag), and Facebook (as a Page post). One API call, three platforms, each with optimized formatting.