Documentation
Introduction
unifeed is a unified social API that handles OAuth, token lifecycle, publishing, analytics, and webhooks for Facebook, Instagram, and X.
What unifeed does
Your application integrates with unifeed over HTTPS. unifeed stores encrypted platform tokens, runs OAuth connect flows, publishes content asynchronously, and notifies your app via signed webhooks.
- Connect social accounts via hosted OAuth
- Publish photos and text to multiple platforms in one request
- Schedule posts and receive delivery status via webhooks
- Fetch analytics and post comments per connected account
Architecture
Your app ──Bearer API key──▶ unifeed /api/v1
├── OAuth ──▶ Meta / X
├── Publish jobs ──▶ QStash ──▶ Platform APIs
└── Webhooks ──▶ Your endpoint (HMAC signed)
Getting started
- Sign in and create an API key
- Read Authentication
- Follow the OAuth guide to connect accounts
- Publish your first post via Posts
Response format
Successful responses include success: true and a data payload. Errors return success: false with an error message and appropriate HTTP status.
{
"success": true,
"data": { ... }
}