ShiSchedule API

v1

Schedule posts, generate content, and read analytics from anywhere.

Authentication

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"

Rate Limits

PlanCalls / month
Free / trial100
Solo500
Starter1,000
Business10,000
Enterprise / AgencyUnlimited

Endpoints

POST
/api/v1/posts

Create 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.

Request body
{
  "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"
}
Response
{ "id": "uuid", "status": "scheduled", "scheduled_at": "...", "account_id": "uuid" }
curl
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" }'
GET
/api/v1/posts

List your posts. Query: status, platform, limit, offset.

Response
{ "posts": [...], "total": 42 }
curl
curl https://shischedule.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY"
DELETE
/api/v1/posts/:id

Cancel a scheduled post.

Response
{ "ok": true }
curl
curl -X DELETE https://shischedule.com/api/v1/posts/POST_ID \
  -H "Authorization: Bearer YOUR_API_KEY"
GET
/api/v1/accounts

List connected social accounts.

Response
{ "accounts": [{ "id":"...", "platform":"instagram", "handle":"@you" }] }
curl
curl https://shischedule.com/api/v1/accounts \
  -H "Authorization: Bearer YOUR_API_KEY"
POST
/api/v1/generate

Generate 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.

Request body
{ "topic": "summer sale", "platform": "instagram", "tone": "playful", "brand_voice": "fun" }
Response
{ "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
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" }'
GET
/api/v1/analytics

Delivery + booking attribution for your posts. Query: platform, from, to (ISO dates), page, limit (max 200). Per-network engagement is not available here.

Response
{ "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
curl https://shischedule.com/api/v1/analytics \
  -H "Authorization: Bearer YOUR_API_KEY"

Ready to build?