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

---

Quick Start

Run with real data

{
  "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)
proxyConfiguration	object	-	No	Proxy settings for web requests

---

Pricing

This actor uses pay-per-event billing:

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