/usageGet current plan and quota usage
curl -X GET "https://postsocials.dev/api/v1/usage" \
-H "Authorization: Bearer ps_live_your_key_here"Unified social media publishing API. Publish videos, Reels, Shorts, photos, carousels, and text across 14 social networks with one HTTP call.
Authenticate all REST API requests with a scoped API key generated in Dashboard → Developers. Keys are hashed with SHA-256 at rest and prefixed with ps_live_.
Every response includes sliding-window rate limit headers: X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset.
| Plan | API Throughput | Monthly Uploads |
|---|---|---|
| Free | 30 req/min | 30 / month |
| Basic | 120 req/min | Unlimited |
| Professional | 300 req/min | Unlimited |
| Advanced | 600 req/min | Unlimited |
| Business | 1,200 req/min | Unlimited |
Errors always return a structured JSON envelope: { "error": { "code", "message", "details?" } }.
| HTTP | Error Code | Description |
|---|---|---|
| 400 | BAD_REQUEST | Malformed JSON or invalid parameter. |
| 401 | UNAUTHORIZED | Missing, invalid, or revoked Bearer API key. |
| 402 | QUOTA_EXCEEDED | Free plan 30 uploads/month quota reached. |
| 403 | PLAN_UPGRADE_REQUIRED | Feature or network (e.g. TikTok, Whitelabel) requires a higher plan. |
| 404 | NOT_FOUND | Profile or upload job ID does not exist. |
| 422 | VALIDATION_ERROR | Schema or platform media/caption constraint failed. |
| 429 | RATE_LIMITED | Per-minute API rate limit exceeded. Respect Retry-After. |
Verify the X-PostSocials-Signature: t=...,v1=... header against the raw request body using your webhook signing secret.
import crypto from "node:crypto";
export function verifyPostSocialsWebhook(rawBody, signatureHeader, secret) {
const parts = Object.fromEntries(
signatureHeader.split(",").map((pair) => pair.split("="))
);
if (!parts.t || !parts.v1) return false;
// Reject signatures older than 5 minutes
const ageSeconds = Math.abs(Math.floor(Date.now() / 1000) - Number(parts.t));
if (ageSeconds > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(`${parts.t}.${rawBody}`, "utf8")
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(parts.v1, "utf8"),
Buffer.from(expected, "utf8")
);
}/usagecurl -X GET "https://postsocials.dev/api/v1/usage" \
-H "Authorization: Bearer ps_live_your_key_here"/profilescurl -X GET "https://postsocials.dev/api/v1/profiles" \
-H "Authorization: Bearer ps_live_your_key_here"/profilescurl -X POST "https://postsocials.dev/api/v1/profiles" \
-H "Authorization: Bearer ps_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "name": "Acme Brand", "description": "Primary social channels" }'/profiles/{id}/connect-urlGenerates a single-use hosted OAuth Connect link styled with your workspace whitelabel settings. Requires the Professional plan or higher.
idin pathcurl -X POST "https://postsocials.dev/api/v1/profiles/prof_acme_main/connect-url" \
-H "Authorization: Bearer ps_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{ "redirectUrl": "https://yourapp.com/settings/social", "expiresInMinutes": 60 }'/uploadslimitin querycursorin queryprofileIdin querystatusin querycurl -X GET "https://postsocials.dev/api/v1/uploads" \
-H "Authorization: Bearer ps_live_your_key_here"/uploadscurl -X POST "https://postsocials.dev/api/v1/uploads" \
-H "Authorization: Bearer ps_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"profileId": "prof_acme_main",
"mediaType": "video",
"mediaItems": [{
"url": "https://cdn.example.com/clip.mp4",
"mimeType": "video/mp4",
"sizeBytes": 12450000
}],
"title": "Release Demo",
"caption": "Shipping v1.4 today.",
"targetPlatforms": ["youtube", "instagram", "x"],
"platformConfig": {
"youtube": { "privacyStatus": "public", "isShort": true },
"instagram": { "placement": "reels" }
}
}'/uploads/{id}idin pathcurl -X GET "https://postsocials.dev/api/v1/uploads/prof_acme_main" \
-H "Authorization: Bearer ps_live_your_key_here"/uploads/{id}idin pathcurl -X DELETE "https://postsocials.dev/api/v1/uploads/upl_7f21d0c9a841" \
-H "Authorization: Bearer ps_live_your_key_here"/analyticsprofileIdin queryplatformin queryfromin querytoin querycurl -X GET "https://postsocials.dev/api/v1/analytics" \
-H "Authorization: Bearer ps_live_your_key_here"