API Reference

Google Business API

Google Business Profile API requires Google Cloud Console setup, location-level OAuth, and separate endpoints for posts, offers, and events. Zernio handles all of that with one POST that goes straight to Search and Maps.

Quick Start

  1. 1.
    Get API Key
    Sign up for free and get your API key in seconds.
  2. 2.
    Connect Account
    Use our OAuth flow to connect Google Business accounts.
  3. 3.
    Start Posting
    Make API calls to post content to Google Business.
Post to Google Business
JavaScript
const response = await fetch('https://zernio.com/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'New menu items available! Visit us today ๐Ÿฝ๏ธ',
    mediaItems: [{ type: 'image', url: 'https://example.com/menu.jpg' }],
    platforms: [{
      platform: 'googlebusiness',
      accountId: 'loc_abc123'
    }],
    googleBusinessOptions: {
      callToAction: 'LEARN_MORE',
      callToActionUrl: 'https://example.com/menu'
    },
    publishNow: true
  })
});

const post = await response.json();
console.log(post.post._id); // '65f1c0a9e2b5af0012ab34cd'

Google Business Endpoints

POST/v1/posts

Create or schedule a Google Business post with optional CTA

GET/v1/posts/{id}

Get status and details of a Google Business post

DELETE/v1/posts/{id}

Cancel a scheduled Google Business post

GET/v1/profiles

List all connected Google Business locations

Media Requirements

TypeFormatMax SizeNotes
ImageJPEG, PNG5 MB1200x900 px recommended
VideoMP475 MBUp to 30 seconds

Zernio automatically transcodes and optimizes media for Google Business's requirements.

API Limits

Google Business Profile API has quota limits per project. Zernio manages all request pacing and automatic retries.

Zernio handles all rate limiting automatically. We queue and retry requests as needed.

Features

  • โœ“Post updates, offers, and events
  • โœ“Add call-to-action buttons (Book, Order, Learn More)
  • โœ“Schedule posts for optimal times
  • โœ“Multi-location management
  • โœ“Photo and video support
  • โœ“Webhook notifications for post status
  • โœ“Automatic CTA button formatting

Response Example

Response
JSON
{
  "post": {
    "_id": "65f1c0a9e2b5af0012ab34cd",
    "status": "published",
    "content": "New menu items available! Visit us today ๐Ÿฝ๏ธ",
    "platforms": [{
      "platform": "googlebusiness",
      "accountId": { "_id": "loc_abc123", "name": "Your Business Name" },
      "status": "published",
      "platformPostId": "xyz789"
    }],
    "publishedAt": "2025-01-10T10:30:00Z"
  },
  "message": "Post published successfully"
}

Start building with Google Business API

Free tier available ยท No credit card required ยท 99.97% uptime

SOC 2 CompliantGDPR Compliant