Blog-to-Social Syndication

Monitor your blog for new posts and automatically syndicate them to social channels with AI-generated summaries. Supports Twitter/X, LinkedIn, Facebook, Instagram, Pinterest, Reddit, and Google Business Profile. Uses RSS feeds or sitemap.xml for detection.

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: Your OpenAI API key for GPT-4 summarization. Get one at https://platform.openai.com/api-keys

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,
  "blogUrl": "https://example.com/blog",
  "rssUrl": "https://example.com",
  "sitemapUrl": "https://example.com"
}

Run with real data

{
  "demoMode": false,
  "blogUrl": "https://example.com/blog",
  "rssUrl": "https://example.com",
  "sitemapUrl": "https://example.com",
  "platforms": [
    "twitter",
    "linkedin",
    "facebook"
  ],
  "maxPostsPerRun": 3,
  "delayBetweenPosts": 5,
  "lookbackDays": 7,
  "contentStyle": "professional",
  "includeEmojis": true,
  "includeHashtags": true,
  "maxHashtags": 5,
  "includeLinkInPost": true,
  "useUtmTracking": true,
  "utmMedium": "social",
  "utmCampaign": "blog-syndication",
  "openaiApiKey": "YOUR_API_KEY_HERE",
  "anthropicApiKey": "YOUR_API_KEY_HERE",
  "geminiApiKey": "YOUR_API_KEY_HERE",
  "preferredAiProvider": "auto",
  "twitterCredentials": "YOUR_API_KEY_HERE",
  "linkedinCredentials": "YOUR_API_KEY_HERE",
  "facebookCredentials": "YOUR_API_KEY_HERE",
  "instagramCredentials": "YOUR_API_KEY_HERE",
  "pinterestCredentials": "YOUR_API_KEY_HERE",
  "redditCredentials": "YOUR_API_KEY_HERE",
  "gbpCredentials": "YOUR_API_KEY_HERE",
  "useExternalPosters": false,
  "dryRun": false
}

---

Input Parameters

Parameter	Type	Default	Required	Description
blogUrl	string	-	No	URL of the blog to monitor (we'll auto-detect RSS feed or sitemap.xml)
rssUrl	string	-	No	Direct RSS feed URL if auto-detection fails
sitemapUrl	string	-	No	Sitemap URL to monitor for new posts (fallback if no RSS)
platforms	array	["twitter","linkedin","facebook"]	No	Which social platforms to syndicate to
maxPostsPerRun	integer	3	No	Maximum number of new posts to process per run (prevents spam)
delayBetweenPosts	integer	5	No	Wait time between posting to each platform (avoids looking like a bot)
lookbackDays	integer	7	No	Only process posts published within this many days
contentStyle	string	"professional"	No	Tone of AI-generated summaries
includeEmojis	boolean	true	No	Add relevant emojis to social posts
includeHashtags	boolean	true	No	Auto-generate relevant hashtags
maxHashtags	integer	5	No	Maximum number of hashtags to include
customHashtags	array	-	No	Always include these hashtags (one per line, without #)
includeLinkInPost	boolean	true	No	Append the blog post URL to social posts
useUtmTracking	boolean	true	No	Add UTM parameters to track social traffic
utmSource	string	-	No	Custom UTM source (default: platform name)
utmMedium	string	"social"	No	UTM medium parameter
utmCampaign	string	"blog-syndication"	No	UTM campaign parameter
openaiApiKey	string	-	Yes*	Your OpenAI API key for GPT-4 summarization. Get one at https://platform.openai.com/api-keys
anthropicApiKey	string	-	Yes*	Your Anthropic API key for Claude summarization. Get one at https://console.anthropic.com/
geminiApiKey	string	-	Yes*	Your Google AI API key for Gemini summarization. Get one at https://makersuite.google.com/app/apikey
preferredAiProvider	string	"auto"	No	Which AI to use for summarization (falls back to others if unavailable)
twitterCredentials	string	-	Yes*	JSON with apiKey, apiSecret, accessToken, accessTokenSecret
linkedinCredentials	string	-	Yes*	JSON with accessToken and optionally organizationId for company pages
facebookCredentials	string	-	Yes*	JSON with accessToken and pageId
instagramCredentials	string	-	Yes*	JSON with accessToken and igUserId (requires Facebook Graph API)
pinterestCredentials	string	-	Yes*	JSON with accessToken and boardId
redditCredentials	string	-	Yes*	JSON with clientId, clientSecret, username, password, and subreddit
gbpCredentials	string	-	Yes*	JSON with refreshToken and locationId
useExternalPosters	boolean	false	No	Instead of direct API calls, trigger our existing poster actors (twitter-poster, linkedin-poster, etc.)
webhookUrl	string	-	No	Send results to a webhook (Zapier, Make, n8n). Useful for custom workflows.
slackWebhookUrl	string	-	No	Get notifications in Slack when posts are syndicated
dryRun	boolean	false	No	Generate summaries but don't actually post (for testing)
demoMode	boolean	true	No	Run with sample data to test without real scraping. Returns realistic sample output instantly.
proxyConfiguration	object	-	No	Proxy settings for web requests

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Post Syndicated	Each blog post syndicated to social channels	$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