API Reference
Introduction
The ShareViral Developer API is a REST interface for publishing and scheduling posts to your connected social accounts from your own apps and automations.
Base URL
All Developer API endpoints are served over HTTPS under /api/v1/developer.
https://shareviral-server-production.up.railway.app/api/v1/developerAuthentication
Authenticate publishing endpoints with an API access token. Pass it in the Authorization header as a Bearer token. Tokens look like sv_….
Authorization: Bearer sv_your_api_tokenCreate, regenerate, or revoke tokens from the dashboard. Token management HTTP endpoints use a Firebase ID token instead—see Authentication.
Content type
Endpoints that accept media use multipart/form-data. Send text fields such as postText, postType, and accounts alongside optional file uploads (up to 10 files).
Response codes
Common HTTP statuses are summarized below. See Errors for the full error shape and partial-success behavior.
- 200 — Request succeeded (check per-platform
resultsfor partial failures). - 400 — Invalid or incomplete request (missing fields, no matching connected accounts).
- 401 / 403 — Missing or invalid token, or plan restriction (for example video posts on a free plan).
- 404 — Resource not found.
- 500 — Unexpected server error.
Rate limit
Treat the API as a low-volume automation interface—prefer scheduling or batching instead of tight publish loops. If you need higher throughput for a production integration, contact support.
FAQ
Which platforms can I target?
Pass a CSV of platform names in accounts (for example facebook,linkedin,tiktok). Only accounts you have connected in ShareViral will be used.
Where do I get started?
Generate a token, then call Make Post with a text post to verify auth and connected accounts. Use Create Scheduled Post for calendar automations.