Google Business Profile

A Google Business Profile post shows up in Google Search, Google Maps and the business's knowledge panel, not in a feed. Posts help local ranking and fade after about a week, so a weekly rhythm works best. In Pozy the platform id is googlebusiness, and one connected account is one location.

This page covers publishing, reviews and analytics. Listing management (hours, photos, services, menus, attributes, verification) lives in the Google Business section.

#What you can do

#Connect

The location must be verified in Google. Request a connect URL and send the user to authUrl:

curl "https://api.pozy.ai/v1/connect/googlebusiness?profileId=66a1f0c2a4b9d3e8f1a2b3c4&redirect_url=https://app.example.com/connected" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/connect/googlebusiness?profileId=66a1f0c2a4b9d3e8f1a2b3c4&redirect_url=https:%2F%2Fapp.example.com%2Fconnected", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
// Send the user's browser to data.authUrl

import os, requests

resp = requests.get(
    "https://api.pozy.ai/v1/connect/googlebusiness",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"profileId": "66a1f0c2a4b9d3e8f1a2b3c4", "redirect_url": "https://app.example.com/connected"},
)
print(resp.json()["authUrl"])

After Google's consent screen the user picks the location to connect. Pozy hosts that picker by default. To build it yourself, pass headless=true and call List locations and Select location. Once done, the user lands on your redirect_url with connected=googlebusiness, profileId and accountId appended. See Hosted connect and Headless connect.

#Post types

A post with no topicType is a standard update. Send one image at most, and no video.

curl -X POST https://api.pozy.ai/v1/posts \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Open all weekend, 8am to 8pm. The autumn menu starts Friday.",
    "mediaItems": [{ "type": "image", "url": "https://pozy.ai/media/autumn-menu.jpg" }],
    "platforms": [{ "platform": "googlebusiness", "accountId": "66b2e19d8c3f5a7e9d0b1c2d" }],
    "publishNow": true
  }'

const res = await fetch("https://api.pozy.ai/v1/posts", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.POZY_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "Open all weekend, 8am to 8pm. The autumn menu starts Friday.",
    mediaItems: [{ type: "image", url: "https://pozy.ai/media/autumn-menu.jpg" }],
    platforms: [{ platform: "googlebusiness", accountId: "66b2e19d8c3f5a7e9d0b1c2d" }],
    publishNow: true,
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.post.platforms[0].platformPostId);

resp = requests.post(
    "https://api.pozy.ai/v1/posts",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    json={
        "content": "Open all weekend, 8am to 8pm. The autumn menu starts Friday.",
        "mediaItems": [{"type": "image", "url": "https://pozy.ai/media/autumn-menu.jpg"}],
        "platforms": [{"platform": "googlebusiness", "accountId": "66b2e19d8c3f5a7e9d0b1c2d"}],
        "publishNow": True,
    },
)
print(resp.json()["post"]["platforms"][0]["platformPostId"])

Text-only posts work, but posts with an image or a button get more visibility. To schedule instead, replace publishNow with scheduledFor and timezone.

#Call to action

callToAction adds a button under the post. url must be HTTPS.

{
  "platform": "googlebusiness",
  "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
  "platformSpecificData": {
    "callToAction": { "type": "BOOK", "url": "https://example.com/book" }
  }
}

#Events and offers

topicType picks the post type. EVENT needs an event with a title and a schedule. OFFER takes an offer and an optional event for the offer period.

{
  "platform": "googlebusiness",
  "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
  "platformSpecificData": {
    "topicType": "EVENT",
    "event": {
      "title": "Grand opening weekend",
      "schedule": {
        "startDate": { "year": 2026, "month": 11, "day": 14 },
        "startTime": { "hours": 9, "minutes": 0 },
        "endDate": { "year": 2026, "month": 11, "day": 15 },
        "endTime": { "hours": 17, "minutes": 0 }
      }
    },
    "callToAction": { "type": "LEARN_MORE", "url": "https://example.com/opening" }
  }
}

{
  "platform": "googlebusiness",
  "accountId": "66b2e19d8c3f5a7e9d0b1c2d",
  "platformSpecificData": {
    "topicType": "OFFER",
    "event": {
      "title": "20% off all pastries",
      "schedule": {
        "startDate": { "year": 2026, "month": 11, "day": 1 },
        "endDate": { "year": 2026, "month": 11, "day": 30 }
      }
    },
    "offer": {
      "couponCode": "AUTUMN20",
      "redeemOnlineUrl": "https://example.com/order",
      "termsConditions": "In store and online. One per customer."
    }
  }
}

Dates are { year, month, day } and times are { hours, minutes } in 24-hour time. ISO 8601 strings are also accepted for all four and converted for you. The event title and dates show as the post heading on Google. More detail, including multi-location posting, is on Google Business posts.

#Platform fields

#Several locations

An account that manages several locations can post to the others with locationId. Get the ids with List Google Business Profile locations. Change the account's default location with Update location. See Google Business posts for posting one update to many locations.

#Edit a published post

Edit published post with platform: "googlebusiness" replaces the body text. The image, button, event and offer details stay as published. There is no edit window and no edit limit. The id in the response is Google's post id, not the Pozy post id you put in the path.

A 404 on edit means the post no longer exists on Google: it was deleted in Google's dashboard, or it was an event or offer whose end date passed. Publish a new post instead.

#Media requirements

The URL must be public HTTPS and return the file with no login or redirect. Upload through Media if you are not sure.

#Limits

#Analytics

Google has retired per-post insights, so Business Profile analytics are per location.

Get performance metrics returns daily values and totals for each metric. Pass accountId and a date range (it defaults to the last 30 days), and optionally metrics as a comma-separated list. Google's data runs 2 to 3 days behind.

curl "https://api.pozy.ai/v1/analytics/googlebusiness/performance?accountId=66b2e19d8c3f5a7e9d0b1c2d&startDate=2026-09-01&endDate=2026-09-30" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/analytics/googlebusiness/performance?accountId=66b2e19d8c3f5a7e9d0b1c2d&startDate=2026-09-01&endDate=2026-09-30", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);
console.log(data.metrics.WEBSITE_CLICKS);

resp = requests.get(
    "https://api.pozy.ai/v1/analytics/googlebusiness/performance",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={"accountId": "66b2e19d8c3f5a7e9d0b1c2d", "startDate": "2026-09-01", "endDate": "2026-09-30"},
)
print(resp.json()["metrics"]["WEBSITE_CLICKS"])

Get search keywords returns the searches that showed the listing, aggregated by month (startMonth and endMonth as YYYY-MM, default the last 3 months). Keywords below Google's privacy threshold come back with impressions: 0 and impressionsThreshold set. Each page holds up to 100 keywords; pass nextPageToken back as pageToken for more.

#Inbox

Reviews are the only inbox surface. List them with List reviews and platform=googlebusiness, filter by accountId, minRating, maxRating and hasReply, then answer with Reply to review. The review id is Google's full resource name, so it also identifies the location.

curl "https://api.pozy.ai/v1/inbox/reviews?platform=googlebusiness&accountId=66b2e19d8c3f5a7e9d0b1c2d&hasReply=false" \
  -H "Authorization: Bearer $POZY_API_KEY"

New, edited, removed and restored reviews arrive as webhooks. See Reviews and Google Business reviews.

#Errors you may see

Errors covers the error format.

#Endpoints

#Webhook events