Unified Social Media Hub

Post to Facebook, Instagram, Twitter/X, and LinkedIn with one API call. Schedule content, track analytics, manage replies — all from a single platform built for affiliate marketers.

Facebook Ready
Twitter/X Ready
LinkedIn Ready
Instagram (via FB Graph)
TikTok (Phase 2)
Enter the URL where your Unified Social API is running. Not deployed yet? See the Setup Guide below.
Quick Launch

Overview Dashboard

Stats at a glance — posts published, platforms connected, scheduled queue

Open

Connect Accounts

OAuth connect Facebook, Twitter, LinkedIn, Instagram with one click per platform

Connect

Compose & Post

Write once, publish to all connected platforms. Schedule for later or post instantly

Compose

Scheduled Queue

View, edit, cancel, or retry all scheduled posts. See retry history and failure logs

View Queue

Analytics

Likes, comments, shares, impressions per post. 7-day charts, best-performing content

Analytics

Unified Inbox

Fetch comments & messages across all platforms. Reply from one place

Requires backend
Platform Adapters
Facebook Pages
✓ Full support — post, analytics, inbox
Instagram
✓ Via Facebook Graph API
Twitter / X
✓ Post, analytics, thread support
LinkedIn
✓ Posts, company pages, analytics
TikTok
⏳ Phase 2 (adapter ready to extend)
YouTube
⏳ Phase 2
Unified API Reference

All endpoints are available at your DASHBOARD_URL. Add Authorization: Bearer YOUR_JWT header to all requests.

POST /api/posts Publish to multiple platforms at once 
{
  "content": "🚀 New affiliate offer — 40% commission this week only! [link]",
  "platforms": ["facebook", "twitter", "linkedin"],
  "media": ["https://your-cdn.com/banner.jpg"],
  "scheduled_at": "2026-03-25T09:00:00Z"   // omit to post immediately
}

Response: { post_id, status: "queued"|"published", results: [{platform, status, post_url}] }

GET /api/analytics Fetch normalised performance metrics 
// Query params: ?platform=facebook&post_id=123&date_from=2026-03-01
// Response:
{
  "post_id": "123",
  "platform": "facebook",
  "metrics": {
    "likes": 142,
    "comments": 23,
    "shares": 18,
    "impressions": 4820,
    "clicks": 87,
    "engagement_rate": "3.7%"
  }
}
GET /api/connect/:platform Start OAuth flow for a platform

Platforms: facebook, twitter, linkedin, instagram

// Visit in browser to start OAuth:
GET /api/connect/facebook
// Redirects to Facebook OAuth → callback stores token encrypted in DB
GET /api/inbox Fetch comments and messages across platforms 
// Response:
{
  "items": [
    { "id": "...", "platform": "facebook", "type": "comment", "text": "Great offer!", "author": "Jane D.", "timestamp": "..." },
    { "id": "...", "platform": "twitter", "type": "mention", "text": "@you looks amazing", "author": "john_doe", "timestamp": "..." }
  ]
}

// Reply:
POST /api/inbox/reply
{ "platform": "facebook", "comment_id": "...", "text": "Thanks! Link in bio." }
Deployment Guide
Step 1 · Download
Get the platform package
Download unified-social-api.zip from your kit files. Unzip it on your server or VPS.
Step 2 · Configure
Set up environment variables
Copy .env.example → .env
Fill in: FACEBOOK_APP_ID, FACEBOOK_APP_SECRET, TWITTER_API_KEY, TWITTER_API_SECRET, LINKEDIN_CLIENT_ID, LINKEDIN_CLIENT_SECRET
Set JWT_SECRET (any random string), ENCRYPTION_KEY (32 chars), DATABASE_URL, REDIS_URL
Step 3 · Launch
Start with Docker (one command)
docker-compose up -d
This starts: Node.js app (port 3000) + PostgreSQL 15 + Redis 7
Visit http://your-server:3000/dashboard
Step 4 · Connect this page
Set your URL above
Paste your server URL into the Dashboard URL field at the top of this page. All Quick Launch cards will then link directly to your running instance.
Step 5 · Register OAuth Apps
Create developer apps on each platform
• Facebook/Instagram: developers.facebook.com → Create App → Marketing API
• Twitter/X: developer.twitter.com → Create Project → OAuth 2.0
• LinkedIn: developer.linkedin.com → Create App → Marketing Developer Platform
Set redirect URI to: https://your-server.com/api/connect/callback
Step 6 · Test
Use Mock Mode first
Set MOCK_MODE=true in .env to test the full workflow without hitting real APIs. All responses will be realistic but simulated.
Affiliate OS Planner Tool Stack Builder