GBP Post Scheduler v1.0

Schedule and automatically publish posts to Google Business Profile. Perfect for content calendars and automated local SEO.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Email for Google account with GBP access

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true,
  "businessUrl": "https://example.com",
  "posts": [
    {
      "content": "Welcome to our business! We're excited to serve you.",
      "postType": "update",
      "callToAction": {
        "type": "LEARN_MORE",
        "url": "https://example.com"
      }
    }
  ],
  "mediaItems": []
}

Run with real data

{
  "demoMode": false,
  "googleEmail": "YOUR_API_KEY_HERE",
  "googlePassword": "YOUR_API_KEY_HERE",
  "businessUrl": "https://example.com",
  "posts": [
    {
      "content": "Welcome to our business! We're excited to serve you.",
      "postType": "update",
      "callToAction": {
        "type": "LEARN_MORE",
        "url": "https://example.com"
      }
    }
  ],
  "mediaMode": "posts_only",
  "mediaItems": [],
  "defaultMediaCategory": "ADDITIONAL",
  "publishImmediately": true,
  "retryOnFailure": true,
  "maxRetries": 2,
  "webhookPlatform": "custom",
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}

---

Input Parameters

Parameter	Type	Default	Required	Description
googleEmail	string	-	Yes*	Email for Google account with GBP access
googlePassword	string	-	Yes*	Password for Google account
businessName	string	-	No	Name of the business on GBP
businessUrl	string	-	No	Direct URL to your GBP dashboard if you have multiple businesses
posts	array	-	No	Array of posts to publish. Each post can include text, images, videos, and CTAs.
mediaMode	string	"posts_only"	No	How to handle media uploads (photos/videos)
mediaItems	array	-	No	Photos and videos to upload to GBP (separate from posts)
defaultMediaCategory	string	"ADDITIONAL"	No	Default category for uploaded media
publishImmediately	boolean	true	No	Publish posts right away (unless they have a scheduledTime)
retryOnFailure	boolean	true	No	Automatically retry failed posts
maxRetries	integer	2	No	Maximum retry attempts per post
webhookUrl	string	-	No	URL to POST results when complete (Zapier, Make, n8n, custom)
webhookPlatform	string	"custom"	No	Target platform for webhook payload formatting
proxy	object	{"useApifyProxy":true,"apifyProxyGroups":["RESIDENTIAL"]}	No	Proxy settings for scraping
demoMode	boolean	false	No	Run in demo mode without real credentials. Returns mock success response for testing.

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Post Scheduled	Each GBP post scheduled or published	$0.05

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal