Google Business API

Post to Google Business Profile with Late API - Updates, CTAs, and location posts

Quick Start

Create a Google Business Profile post:

curl -X POST https://getlate.dev/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "🎉 We are open this holiday weekend! Stop by for our special seasonal menu.",
    "mediaItems": [
      {"url": "https://example.com/holiday-special.jpg"}
    ],
    "platforms": [
      {"platform": "googlebusiness", "accountId": "YOUR_ACCOUNT_ID"}
    ],
    "publishNow": true
  }'

const response = await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: '🎉 We are open this holiday weekend! Stop by for our special seasonal menu.',
    mediaItems: [
      { url: 'https://example.com/holiday-special.jpg' }
    ],
    platforms: [
      { platform: 'googlebusiness', accountId: 'YOUR_ACCOUNT_ID' }
    ],
    publishNow: true
  })
});

const { post } = await response.json();
console.log('Posted to Google Business!', post._id);

import requests

response = requests.post(
    'https://getlate.dev/api/v1/posts',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'content': '🎉 We are open this holiday weekend! Stop by for our special seasonal menu.',
        'mediaItems': [
            {'url': 'https://example.com/holiday-special.jpg'}
        ],
        'platforms': [
            {'platform': 'googlebusiness', 'accountId': 'YOUR_ACCOUNT_ID'}
        ],
        'publishNow': True
    }
)

post = response.json()
print(f"Posted to Google Business! {post['_id']}")

Overview

Google Business Profile posts support text and a single image. Videos are not supported.

Image Requirements

Property	Requirement
Max Images	1 per post
Formats	JPEG, PNG
Max File Size	5 MB
Min Dimensions	250 × 250 px
Recommended	1200 × 900 px (4:3)

Aspect Ratios

Ratio	Dimensions	Notes
4:3	1200 × 900 px	Recommended
1:1	1080 × 1080 px	Square, good for profile
16:9	1200 × 675 px	Landscape

Note: Google may crop images. Use 4:3 for best results.

Call-to-Action Buttons

Google Business posts can include CTA buttons:

curl -X POST https://getlate.dev/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Book your appointment today! Limited spots available this week.",
    "mediaItems": [
      {"url": "https://example.com/booking.jpg"}
    ],
    "platforms": [{
      "platform": "googlebusiness",
      "accountId": "YOUR_ACCOUNT_ID",
      "platformSpecificData": {
        "callToAction": {
          "type": "BOOK",
          "url": "https://mybusiness.com/book"
        }
      }
    }],
    "publishNow": true
  }'

const response = await fetch('https://getlate.dev/api/v1/posts', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    content: 'Book your appointment today! Limited spots available this week.',
    mediaItems: [
      { url: 'https://example.com/booking.jpg' }
    ],
    platforms: [{
      platform: 'googlebusiness',
      accountId: 'YOUR_ACCOUNT_ID',
      platformSpecificData: {
        callToAction: {
          type: 'BOOK',
          url: 'https://mybusiness.com/book'
        }
      }
    }],
    publishNow: true
  })
});

response = requests.post(
    'https://getlate.dev/api/v1/posts',
    headers={'Authorization': 'Bearer YOUR_API_KEY'},
    json={
        'content': 'Book your appointment today! Limited spots available this week.',
        'mediaItems': [
            {'url': 'https://example.com/booking.jpg'}
        ],
        'platforms': [{
            'platform': 'googlebusiness',
            'accountId': 'YOUR_ACCOUNT_ID',
            'platformSpecificData': {
                'callToAction': {
                    'type': 'BOOK',
                    'url': 'https://mybusiness.com/book'
                }
            }
        }],
        'publishNow': True
    }
)

Available CTA Types

Type	Description	Best For
`LEARN_MORE`	Link to more information	Articles, about pages
`BOOK`	Booking/reservation link	Services, appointments
`ORDER`	Online ordering link	Restaurants, food
`SHOP`	E-commerce link	Retail, products
`SIGN_UP`	Registration link	Events, newsletters
`CALL`	Phone call action	Contact, inquiries

Post Without Image

Text-only posts are supported:

{
  "content": "Happy Friday! 🎉 We're offering 20% off all services this weekend. Mention this post when you visit!",
  "platforms": [
    { "platform": "googlebusiness", "accountId": "acc_123" }
  ]
}

Image URL Requirements

Google Business has strict image requirements:

Requirement	Details
Public URL	Must be publicly accessible
HTTPS	Secure URLs only
No redirects	Direct link to image
No auth required	Can't require login

✅ https://mybucket.s3.amazonaws.com/image.jpg
✅ https://example.com/images/post.png
❌ https://example.com/image?token=abc (auth required)
❌ http://example.com/image.jpg (not HTTPS)