Facebook Page Poster v2.1 - Automated Social Media Publishing

Post to Facebook Business Pages using browser automation. Supports text posts, image attachments, and link shares. Enterprise-grade stability with session persistence, captcha solving, and residential proxy support.

Perfect for: Social media managers, marketing agencies, brand automation, content scheduling, and multi-account management.

---

Key Features

Core Posting Features

• Text Posts - Status updates with custom messages
• Link Shares - Share URLs with custom text and previews
• Image Attachments - Upload photos with captions
• UTM Tracking - Automatic UTM parameters for analytics
• IndexNow Integration - Instant search engine indexing

Enterprise Stability Features (v2.1+)

• Session Persistence - Cookies saved to Apify KV Store, reducing login frequency
• 2Captcha Integration - Automatic security challenge solving
• Sticky Proxy Sessions - Consistent IP assignment for better stability
• Browser Fingerprint Protection - Advanced anti-bot evasion
• Auto-Retry Logic - Smart error handling and recovery

Developer Features

• Webhook Integration - POST notifications for Zapier, Make, n8n workflows
• Demo Mode - Test without credentials (no charges)
• Detailed Logging - Full visibility into posting process

---

Quick Start Examples

Post a Simple Update

{
  "cookies": "[your exported cookies JSON]",
  "pageUrl": "https://facebook.com/yourbusiness",
  "message": "Hello Facebook! This is my automated post.",
  "demoMode": false
}

Post with Link Share

{
  "cookies": "[your exported cookies JSON]",
  "pageUrl": "https://facebook.com/yourbusiness",
  "message": "Check out our latest blog post!",
  "linkUrl": "https://yourbusiness.com/blog/latest",
  "demoMode": false
}

Production Setup with All Stability Features

{
  "cookies": "[your exported cookies JSON]",
  "pageUrl": "https://facebook.com/yourbusiness",
  "message": "Professional automated posting!",
  "reuseSession": true,
  "twoCaptchaApiKey": "your-2captcha-key",
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  },
  "webhookUrl": "https://hooks.zapier.com/hooks/catch/...",
  "timeout": 120,
  "demoMode": false
}

---

Input Parameters Reference

Authentication

Parameter	Type	Required	Description
email	string	No*	Facebook email for login
password	string	No*	Facebook password
cookies	string	No*	Exported cookies JSON (recommended)

*One authentication method required: cookies OR email+password

Content

Parameter	Type	Required	Description
pageUrl	string	Yes	URL of Facebook page to post to
message	string	No**	Post text content
imageUrls	array	No	Image URLs to attach
linkUrl	string	No	URL to share in the post

**At least one of message, linkUrl, or imageUrls required

Session & Stability (NEW in v2.1)

Parameter	Type	Default	Description
reuseSession	boolean	true	Save/reuse authenticated sessions
twoCaptchaApiKey	string	-	API key for captcha solving
proxy	object	Residential US	Proxy configuration
timeout	integer	120	Max operation time (seconds)

Integrations

Parameter	Type	Description
webhookUrl	string	URL for POST notifications
indexNowKey	string	IndexNow API key for SEO
demoMode	boolean	Test mode (no real posting)
utmTracking	object	UTM parameters for link tracking

---

Output Format

Successful Post

{
  "success": true,
  "postUrl": "https://facebook.com/yourbusiness/posts/123456789",
  "postId": "123456789"
}

Error Response

{
  "success": false,
  "error": "Authentication failed - invalid cookies",
  "screenshotUrl": "https://api.apify.com/v2/key-value-stores/.../error-screenshot.png"
}

---

Stability Features Explained

Session Persistence

Sessions are automatically saved to Apify's KV Store and reused across runs:

• Session Key: Generated from your credentials (hashed for security)
• Storage: Encrypted cookies in Apify KV Store
• Expiry: 24 hours (then re-authenticates)
• Benefit: Reduces login frequency by ~90%, avoids security triggers

2Captcha Integration

Facebook uses various challenge types for bot detection. When enabled:

1. Challenge is detected automatically
2. Captcha is sent to 2Captcha service
3. Solution is injected into the page
4. Process continues automatically

Setup:

1. Create account at 2captcha.com
2. Add funds ($3 minimum recommended)
3. Copy your API key
4. Add to twoCaptchaApiKey input

Sticky Proxy Sessions

Residential proxies with consistent IP assignment:

{
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}

Why It Matters:

• Same IP across session = less suspicious
• Residential IPs are trusted by Facebook
• Country targeting for geo-relevant content

---

Authentication Guide

Method 1: Cookie-Based (Recommended)

Cookie authentication is the most stable method with the highest success rate.

How to Export Cookies:

1. Install a browser extension like "Cookie-Editor" or "EditThisCookie"
2. Log into Facebook in your browser
3. Click the extension icon
4. Export all cookies as JSON
5. Paste the JSON into the cookies field

Benefits:

• No login process (faster, more reliable)
• Avoids most security challenges
• Sessions last 24+ hours
• Works with 2FA-enabled accounts

Method 2: Email/Password

Direct login with credentials. May trigger security challenges.

{
  "email": "your_email@example.com",
  "password": "your_password"
}

Note: If you have 2FA enabled, cookie-based auth is required.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
apify-actor-start	Base cost per run	$0.10
post_created	Per post created	$0.05

Example Costs:

Action	Calculation	Total
Single post	$0.10 + $0.05	$0.15
100 posts/month	100 x $0.15	$15.00

---

Troubleshooting Common Issues

Authentication Errors

Error: Not logged in. Please check credentials or cookies.

• Cause: Cookies expired or were invalidated
• Fix: Export fresh cookies from your browser

Error: Security challenge detected

• Cause: Facebook detected unusual activity
• Fix:
  1. Add 2Captcha API key
  2. Use residential proxy
  3. Try cookie-based auth instead

Posting Errors

Error: Could not find post composer

• Cause: Page layout changed or not a business page
• Fix: Verify the pageUrl is a valid Facebook Business Page

Error: Post button is disabled

• Cause: No content to post or Facebook detected an issue
• Fix: Ensure message or linkUrl is provided

---

What's New in v2.1

Session Persistence System

• Cookies automatically saved to Apify KV Store
• Sessions reused across runs (24-hour validity)
• Reduces login frequency by 90%
• Sticky proxy sessions for consistent IP

2Captcha Integration

• Automatic security challenge detection
• Seamless challenge solving
• Timeout handling (5 minutes max)

Enhanced Stability

• Improved error handling and retry logic
• Better fingerprint randomization
• Smarter wait times between actions
• Detailed logging for debugging

---

Best Practices

For Maximum Stability

1. Use Cookie Authentication - Most reliable method
2. Enable Session Reuse - Reduces login frequency
3. Add 2Captcha Key - Handles challenges automatically
4. Use Residential Proxies - Better trust with Facebook
5. Post at Human Pace - Reasonable delays between posts

For Brand Safety

1. Review Content - Avoid automated content that could be controversial
2. Monitor Results - Check webhook responses for failures
3. Maintain Backups - Keep cookie exports updated
4. Follow ToS - Stay within Facebook's acceptable use policies

---

Support & Resources

• Issues: Report bugs via Apify console feedback
• Documentation: Apify Actor Documentation
• 2Captcha Setup: 2captcha.com
• Cookie Export Guide: Search "Cookie-Editor Chrome extension"

---

Changelog

v2.1.0 (Latest)

• Added session persistence system
• Added 2Captcha integration for security challenges
• Added sticky proxy sessions
• Improved fingerprint randomization
• Enhanced error handling
• Added webhook support
• Added IndexNow integration
• Added UTM tracking

v2.0.0

• Complete rewrite with PlaywrightCrawler
• Added image attachments
• Added link shares
• Improved anti-detection

v1.0.0

• Initial release
• Basic text posting
• Cookie authentication

---

Built by John Rippy | LinkedIn | Actor Arsenal

Keywords: Facebook automation, Facebook poster, social media automation, Facebook page management, automated posting, Facebook marketing, social media marketing, Apify Facebook actor, Facebook scheduler