Google Business management

A Google Business Profile listing is what people see when they search for a business on Google Search and Maps: the hours, the photos, the reviews, the "Order" and "Book" buttons. Pozy lets you manage all of it through the API, for one shop or a chain of locations, with the same account you use to publish posts there.

#What you can do

Connection details, character limits and media rules for posting are on the Google Business Profile platform page.

#How accounts map to locations

You connect Google Business Profile with Google sign-in on a profile. The person picks a location, and that location becomes one Pozy account (platform: "googlebusiness").

• One account, one selected location. Every /v1/accounts/{accountId}/gmb-* endpoint acts on the account's selected location.
• Other locations under the same Google login. Pass locationId as a query parameter to target any other location the login manages, without connecting it separately.
• Several locations at connect time. In a headless connect, POST /v1/connect/googlebusiness/select-location accepts a locations array and creates one account per location. Any that could not be connected come back in failed.

#Work with many locations

curl "https://api.pozy.ai/v1/accounts/6713b0e5d1f4c69a2b8e3f75/gmb-locations?search=lisbon" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/accounts/6713b0e5d1f4c69a2b8e3f75/gmb-locations?search=lisbon", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error);

for (const loc of data.locations) console.log(loc.id, loc.name, loc.address);

import os
import requests

H = {"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"}
resp = requests.get(
    "https://api.pozy.ai/v1/accounts/6713b0e5d1f4c69a2b8e3f75/gmb-locations",
    headers=H,
    params={"search": "lisbon"},
    timeout=30,
)
for loc in resp.json()["locations"]:
    print(loc["id"], loc["name"], loc["address"])

{
  "locations": [
    { "id": "4821930576104832190", "name": "Padaria Rosa Chiado", "accountId": "accounts/118273645509", "accountName": "Padaria Rosa", "address": "Rua Garrett 12, Lisboa", "category": "Bakery" },
    { "id": "5930184726391058277", "name": "Padaria Rosa Alfama", "accountId": "accounts/118273645509", "accountName": "Padaria Rosa", "address": "Rua dos Remédios 40, Lisboa", "category": "Bakery" }
  ],
  "hasMore": false,
  "selectedLocationId": "4821930576104832190",
  "cached": true
}

curl -X POST https://api.pozy.ai/v1/accounts/6713b0e5d1f4c69a2b8e3f75/gmb-locations/assign \
  -H "Authorization: Bearer $POZY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profileId": "6717f4c9b5d8a03e6f2c7d19",
    "selectedLocationId": "locations/5930184726391058277",
    "googleAccountId": "accounts/118273645509"
  }'

#Verified locations only

Google only shows reviews, accepts most edits and returns full listing data for locations that are verified and matched to a published Maps place. Google calls this Voice of Merchant. Before you build anything on a location, read GET /v1/accounts/{accountId}/gmb-verifications and check voiceOfMerchantState.hasVoiceOfMerchant. If it is false, start with Verification.

#Errors you will see everywhere

Every gmb-* endpoint passes Google's own complaint through when Google rejects a request.

#Endpoints

#Webhook events