Instant Post

POST /api/v1/instant-post is the paid pack (~2 credits). Same spine as MCP instant_post submit. No extra submit fields. YouTube / LinkedIn / Instagram / TikTok are not a fifth mode. They are mode=from_url (platform video). A website is from_url (webpage).

From a URL

curl -X POST https://api.screencrafter.io/api/v1/instant-post \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: sc_live_YOUR_KEY' \
  -d '{
    "mode": "from_url",
    "from_url": { "url": "https://screencrafter.io" }
  }'

Returns job_id. Studio: https://app.screencrafter.io/result/{job_id}

From an idea

curl -X POST https://api.screencrafter.io/api/v1/instant-post \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: sc_live_YOUR_KEY' \
  -d '{
    "mode": "from_idea",
    "idea": { "prompt": "Weekend sale 20% off coffee. Warm busy café energy." }
  }'

instruction is optional tone (“don’t make it an ad”). Do not put the idea in instruction.

Poll

Cursor has no WebSocket.

curl https://api.screencrafter.io/api/v1/jobs/{job_id} \
  -H 'X-API-Key: sc_live_YOUR_KEY'

When status is completed, clips and stills are on the job. Poll is free.

Zip (on demand)

Do not expect zip bytes on complete.

curl https://api.screencrafter.io/api/v1/instant-post/jobs/{job_id}/zip \
  -H 'X-API-Key: sc_live_YOUR_KEY'

JSON with a CDN zip_url. Same as MCP action: zip.

Get started

REST

From a URL

From an idea

Poll

Zip (on demand)

​From a URL

​From an idea

​Poll

​Zip (on demand)

From a URL

From an idea

Poll

Zip (on demand)