LinkedIn Poster v2.1 - Automated Social Media Publishing

Post to LinkedIn Company Pages or personal profiles using browser automation. Supports text posts, link shares, image attachments (coming soon), and AI-generated alt text. Enterprise-grade stability with session persistence, captcha solving, and residential proxy support.

Perfect for: Social media managers, marketing agencies, B2B content distribution, thought leadership campaigns, and multi-account management.

---

Key Features

Core Posting Features

• Company Page Posts - Post as your business page with admin access
• Personal Feed Posts - Post to individual profiles
• Link Sharing - Share URLs with auto-preview cards
• UTM Tracking - Auto-append analytics parameters to links
• AI Alt Text - Claude Vision-generated accessibility descriptions
• 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
• Debug Screenshots - Automatic screenshots on errors

---

Quick Start Examples

Post to Personal Feed

{
  "cookies": "[your exported cookies JSON]",
  "message": "Excited to share our latest insights on AI adoption in enterprise!",
  "demoMode": false
}

Post to Company Page

{
  "cookies": "[your exported cookies JSON]",
  "companyPageUrl": "https://linkedin.com/company/your-company",
  "message": "We're hiring! Check out our open positions.",
  "linkUrl": "https://yourcompany.com/careers",
  "demoMode": false
}

Share Link with UTM Tracking

{
  "cookies": "[your exported cookies JSON]",
  "message": "Great article on marketing automation:",
  "linkUrl": "https://yoursite.com/blog/marketing-automation",
  "utmTracking": {
    "enabled": true,
    "source": "linkedin",
    "medium": "social",
    "campaign": "thought_leadership"
  },
  "demoMode": false
}

Production Setup with All Stability Features

{
  "cookies": "[your exported cookies JSON]",
  "companyPageUrl": "https://linkedin.com/company/your-company",
  "message": "Professional automated posting with enterprise stability!",
  "linkUrl": "https://yoursite.com/article",
  "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*	LinkedIn email
password	string	No*	LinkedIn password
cookies	string	No*	Exported cookies JSON (recommended)

*One authentication method required: cookies OR email+password

Content

Parameter	Type	Required	Description
companyPageUrl	string	No	Company page URL (omit for personal feed)
message	string	Yes**	Post text content
linkUrl	string	No	URL to share in the post
imageUrls	array	No	Image URLs (feature in development)

**At least message, linkUrl, or imageUrls is 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)

UTM Tracking

Parameter	Type	Description
utmTracking.enabled	boolean	Enable UTM parameters on links
utmTracking.source	string	utm_source value (default: "linkedin")
utmTracking.medium	string	utm_medium value (default: "social")
utmTracking.campaign	string	utm_campaign value
utmTracking.content	string	utm_content value
utmTracking.term	string	utm_term value

Image Options

Parameter	Type	Description
imageOptions.generateAltText	boolean	Generate AI alt text
imageOptions.companyName	string	Company name for context
imageOptions.industry	string	Industry for alt text context

Integrations

Parameter	Type	Description
webhookUrl	string	URL for POST notifications
indexNowKey	string	IndexNow API key for SEO
demoMode	boolean	Test mode (no real posting)

---

Output Format

Successful Post

{
  "success": true,
  "postUrl": "https://linkedin.com/feed/update/urn:li:share:1234567890",
  "postId": "linkedin-post-1234567890"
}

Error Response

{
  "success": false,
  "error": "Not logged in. Please check credentials or 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

LinkedIn 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 LinkedIn
• 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 LinkedIn in your browser
3. Click the extension icon
4. Export all cookies as JSON
5. Paste the JSON into the cookies field

Key Cookies to Include:

• li_at - Primary session cookie
• JSESSIONID - Session identifier
• lidc - Data center cookie

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.com",
  "password": "your_password"
}

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

---

Posting to Company Pages

To post as your company (not as yourself):

1. Ensure you have admin access to the company page
2. Provide the company page URL in companyPageUrl
3. The actor will switch to company context before posting

{
  "cookies": "[...]",
  "companyPageUrl": "https://linkedin.com/company/your-company-name",
  "message": "Company announcement!"
}

Requirements:

• You must be a Page Admin or Content Admin
• The URL should be the company page URL (not admin URL)

---

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: Verification required. Please use cookies instead.

• Cause: LinkedIn triggered 2FA or verification
• Fix:
  1. Use cookie-based authentication
  2. Add 2Captcha API key
  3. Use residential proxy

Posting Errors

Error: Could not find post composer

• Cause: LinkedIn UI changed or not fully loaded
• Fix: Increase timeout, try again

Error: Could not find or click Post button

• Cause: Post button disabled or UI issue
• Fix: Ensure message content is valid, try again

Security Challenges

Error: Security challenge detected but could not be solved

• Cause: LinkedIn triggered a captcha
• Fix: Add 2Captcha API key or use cookie-based auth

Error: Phone verification required

• Cause: LinkedIn requires phone verification
• Fix: Verify your account manually, then use cookie auth

---

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
• Arkose/FunCaptcha 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 LinkedIn
5. Post at Human Pace - Reasonable delays between posts

For Professional Networking

1. Quality Content - Focus on valuable, professional content
2. Consistent Posting - Regular schedule builds engagement
3. Engagement Tracking - Use UTM parameters for analytics
4. Monitor Performance - Check webhook responses

Content Guidelines

1. Professional Tone - LinkedIn is a business platform
2. Add Value - Educational or insightful content performs best
3. Use Links Wisely - Include relevant resources
4. Respect Limits - Don't spam; quality over quantity

---

UTM Tracking Best Practices

Default UTM parameters when enabled:

• utm_source: "linkedin"
• utm_medium: "social"
• utm_campaign: "linkedin_post_YYYYMMDD"

Custom campaign example:

{
  "utmTracking": {
    "enabled": true,
    "source": "linkedin",
    "medium": "company_page",
    "campaign": "q1_product_launch",
    "content": "announcement_post"
  }
}

---

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

v2.0.0

• Complete rewrite with PlaywrightCrawler
• Added company page support
• Added UTM tracking
• Added AI alt text generation
• Improved anti-detection

v1.0.0

• Initial release
• Basic text posting
• Cookie authentication

---

Built by John Rippy | LinkedIn | Actor Arsenal

Keywords: LinkedIn automation, LinkedIn poster, social media automation, LinkedIn marketing, automated posting, LinkedIn scheduler, Apify LinkedIn actor, LinkedIn bot, company page posting, B2B marketing