API Reference

The Sphot REST API lets you create reels, retrieve data, and receive events via webhooks — all programmatically.

Quickstart

Base URL

https://sphot.one/api

Authentication

All requests require a Bearer token in the Authorization header. Retrieve your token from Settings → Developer.

Authorization: Bearer <your_access_token>

Example request

List your reels (cURL)

curl -X GET "https://sphot.one/api/reels" \
  -H "Authorization: Bearer <your_access_token>" \
  -H "Content-Type: application/json"

List your reels (JavaScript)

const res = await fetch("https://sphot.one/api/reels", {
  headers: {
    Authorization: `Bearer ${YOUR_TOKEN}`,
    "Content-Type": "application/json",
  },
});
const { items } = await res.json();
console.log(items);

Rate limits

Standard tier

60 requests per minute per token. Reel creation endpoints are further capped at 10 per hour.

Rate-limited responses

When exceeded, the API returns 429 Too Many Requests with a Retry-After header.

Webhooks

Sphot can push events to your server when a reel is created, published, or fails. Configure your webhook endpoint in Settings → Developer → Webhooks.

Event types

reel.createdA new reel has been queued for production.

reel.approvedReel passed QC and is ready to post.

reel.publishedReel was published to Instagram or YouTube.

reel.failedProduction or publishing encountered an error.

run.startedA new Production Run has begun processing.

run.completedA Production Run finished all 19 stages.

Example payload

{
  "event": "reel.published",
  "reel_id": "r_abc12345",
  "title": "Summer hiking tips",
  "published_at": "2026-06-17T10:32:00Z",
  "ig_permalink": "https://www.instagram.com/reel/..."
}