Google Business Profile Poster

Google Business Profile Automation - Post updates, events, and offers to GBP/GMB automatically. Schedule local business content, attach images, add CTA buttons (Book, Order, Learn More). Perfect for local SEO, multi-location management, and marketing agencies.

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: Google account password

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",
  "imageUrl": "https://example.com",
  "ctaUrl": "https://example.com"
}

Run with real data

{
  "demoMode": false,
  "password": "YOUR_API_KEY_HERE",
  "cookies": "YOUR_API_KEY_HERE",
  "businessUrl": "https://example.com",
  "postType": "update",
  "imageUrl": "https://example.com",
  "ctaUrl": "https://example.com",
  "timeout": 120,
  "utmTracking": {
    "enabled": true
  }
}

---

Input Parameters

Parameter	Type	Default	Required	Description
demoMode	boolean	true	No	Run in demo mode - returns mock success without actually posting. Enable to test the actor without Google credentials.
email	string	-	No	Google account email (use cookies instead if 2FA enabled)
password	string	-	Yes*	Google account password
cookies	string	-	Yes*	Exported cookies from logged-in session (recommended for 2FA accounts)
businessUrl	string	-	No	GBP URL or business name to find
postType	string	"update"	No	Type of post to create
message	string	-	No	The text content of your post
imageUrl	string	-	No	URL of image to attach (optional)
ctaType	string	-	No	Type of CTA button (optional)
ctaUrl	string	-	No	URL for the call-to-action button
eventTitle	string	-	No	Title for event posts
eventStart	string	-	No	Start date/time (ISO format)
eventEnd	string	-	No	End date/time (ISO format)
offerCode	string	-	No	Promo/coupon code for offer posts
offerTerms	string	-	No	Terms and conditions for the offer
timeout	integer	120	No	Maximum time to wait for operations
webhookUrl	string	-	No	URL to receive a POST request when the actor run finishes. Useful for integrations with Zapier, Make, n8n, or custom automation workflows.
indexNowKey	string	-	No	Your IndexNow API key for instant indexing. When provided, the published post URL will be submitted to Bing, Yandex, and Seznam for faster indexing.
utmTracking	object	{"enabled":true}	No	Enable UTM tracking parameters on CTA URLs. Format: {"enabled": true, "source": "google_business", "medium": "organic", "campaign": "your_campaign"}

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Post Created	Each GBP post created	$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