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

---

Quick Start

Run with real data

{
  "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
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"}

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Post Created	Each GBP post created	$0.05

---

Troubleshooting

"API key is required"

• 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?

---

Built by John Rippy | Actor Arsenal

Running without credentials

If you run this actor without credentials, it returns clearly labeled sample data instead of posting. Each sample item includes demo: true and a notice field. Nothing is posted to Google Business Profile and no task events are charged. Provide your own credentials in the input to post for real. Setting demoMode to true behaves the same way.