Shi-SocialPilot 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://shi-socialpilot.com/api/v1/posts \
  -H "Authorization: Bearer YOUR_API_KEY"

Rate Limits

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

Endpoints

POST
/api/v1/posts

Create or schedule a post.

Request body
{
  "platform": "instagram",
  "content": "Hello world ✨",
  "scheduled_at": "2026-07-01T15:00:00Z",
  "image_urls": ["https://..."]
}
Response
{ "id": "uuid", "status": "scheduled", "scheduled_at": "..." }
curl
curl -X POST https://shi-socialpilot.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", "image_urls": ["https://..."] }'
GET
/api/v1/posts

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

Response
{ "posts": [...], "total": 42 }
curl
curl https://shi-socialpilot.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://shi-socialpilot.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://shi-socialpilot.com/api/v1/accounts \
  -H "Authorization: Bearer YOUR_API_KEY"
POST
/api/v1/generate

AI-generate post content.

Request body
{ "topic": "summer sale", "platform": "instagram", "tone": "playful", "brand_voice": "fun" }
Response
{ "content": "...", "hashtags": ["#sale","#summer"] }
curl
curl -X POST https://shi-socialpilot.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

Performance data. Query: platform, from, to (ISO dates).

Response
{ "posts": [...], "summary": { "total_posts": 12, "likes": 340, ... } }
curl
curl https://shi-socialpilot.com/api/v1/analytics \
  -H "Authorization: Bearer YOUR_API_KEY"
GET
/api/v1/admin/users
admin only

List all users.

Response
{ "users": [...], "total": N }
curl
curl https://shi-socialpilot.com/api/v1/admin/users \
  -H "Authorization: Bearer YOUR_API_KEY"
POST
/api/v1/admin/users/:id/plan
admin only

Change a user's plan.

Request body
{ "plan": "business" }
Response
{ "ok": true }
curl
curl -X POST https://shi-socialpilot.com/api/v1/admin/users/POST_ID/plan \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "plan": "business" }'
POST
/api/v1/admin/users/:id/credits
admin only

Grant credits.

Request body
{ "amount": 500, "reason": "promo" }
Response
{ "ok": true }
curl
curl -X POST https://shi-socialpilot.com/api/v1/admin/users/POST_ID/credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "amount": 500, "reason": "promo" }'
GET
/api/v1/admin/stats
admin only

Platform stats and estimated MRR.

Response
{ "users": 0, "estimated_mrr_usd": 0, ... }
curl
curl https://shi-socialpilot.com/api/v1/admin/stats \
  -H "Authorization: Bearer YOUR_API_KEY"

Ready to build?