All requests require a Bearer token in the Authorization header. Get yours in Settings → API Keys.
curl https://shischedule.com/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY"| Plan | Calls / month |
|---|---|
| Free / trial | 100 |
| Solo | 500 |
| Starter | 1,000 |
| Business | 10,000 |
| Enterprise / Agency | Unlimited |
/api/v1/postsCreate or schedule a post. scheduled_at is required (UTC ISO 8601) unless you send publish_now: true to publish immediately. If you have more than one account on the platform, account_id (from GET /api/v1/accounts) is required — the API never guesses. Send post_type: "story" (Instagram/Facebook only, with a 9:16 image in image_urls) to publish a Story instead of a feed post.
{
"platform": "instagram",
"content": "Hello world",
"scheduled_at": "2026-07-01T15:00:00Z",
"publish_now": false,
"account_id": "uuid — optional, from GET /api/v1/accounts",
"image_urls": ["https://..."],
"post_type": "feed — or "story" for an Instagram/Facebook Story"
}{ "id": "uuid", "status": "scheduled", "scheduled_at": "...", "account_id": "uuid" }curl -X POST https://shischedule.com/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "platform": "instagram", "content": "Hello world", "scheduled_at": "2026-07-01T15:00:00Z", "publish_now": false, "account_id": "uuid — optional, from GET /api/v1/accounts", "image_urls": ["https://..."], "post_type": "feed — or "story" for an Instagram/Facebook Story" }'/api/v1/postsList your posts. Query: status, platform, limit, offset.
{ "posts": [...], "total": 42 }curl https://shischedule.com/api/v1/posts \
-H "Authorization: Bearer YOUR_API_KEY"/api/v1/posts/:idCancel a scheduled post.
{ "ok": true }curl -X DELETE https://shischedule.com/api/v1/posts/POST_ID \
-H "Authorization: Bearer YOUR_API_KEY"/api/v1/accountsList connected social accounts.
{ "accounts": [{ "id":"...", "platform":"instagram", "handle":"@you" }] }curl https://shischedule.com/api/v1/accounts \
-H "Authorization: Bearer YOUR_API_KEY"/api/v1/generateGenerate post content. Uses the same monthly photo and clip allowance as the in-app generator. The response includes allowance.photos, allowance.cinematic, and allowance.premium (used, allowance, and remaining). Admin and agency plans report unlimited: true and null remaining. Returns 402 when the monthly photo allowance is used up, and 429 after 30 calls in a minute per API key.
{ "topic": "summer sale", "platform": "instagram", "tone": "playful", "brand_voice": "fun" }{ "content": "...", "hashtags": ["#sale","#summer"], "allowance": { "plan": "starter", "unlimited": false, "photos": { "used": 12, "allowance": 150, "remaining": 138 }, "cinematic": { "used": 1, "allowance": 10, "remaining": 9 }, "premium": { "used": 0, "allowance": 2, "remaining": 2 } } }curl -X POST https://shischedule.com/api/v1/generate \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "topic": "summer sale", "platform": "instagram", "tone": "playful", "brand_voice": "fun" }'/api/v1/analyticsDelivery + booking attribution for your posts. Query: platform, from, to (ISO dates), page, limit (max 200). Per-network engagement is not available here.
{ "posts": [...], "summary": { "total_posts": 12, "published": 9, "bookings": 3, "booking_revenue_cents_by_currency": { "usd": 24000 }, "engagement": { "available": false, "reason": "..." } }, "page": { "page": 1, "limit": 50, "total": 12 } }curl https://shischedule.com/api/v1/analytics \
-H "Authorization: Bearer YOUR_API_KEY"Ready to build?