Storrito API: Schedule Instagram Stories Programmatically

The Storrito API lets you schedule Instagram Stories programmatically. Upload images or videos, add native Instagram stickers (hashtags, mentions, links, polls, and more), and queue Stories for posting — all from your own code.

What you can do with the API

• Schedule Stories with images or videos
• Add native Instagram stickers to your Stories: hashtags, mentions, locations, polls, links, and more
• Schedule for later or post immediately
• List connected Instagram accounts to find the username you want to post to
• Cancel scheduled Stories before they go live
• Check the status of any Story you've queued

The API is HTTP-based and accepts JSON, so any HTTP client (curl, fetch, requests, etc.) works. You don't need a special SDK.

Authentication

The API uses Bearer tokens. To get one:

1. Open your Storrito account and go to API Credentials
2. Create a new credential — your Bearer token is shown once, so copy it somewhere safe
3. Include the token in the Authorization header of every request

The same screen shows your API base URL, which is unique to your account.

Quick example

List your connected Instagram accounts:

curl -X POST https://YOUR-BASE-URL/api/v1/list-instagram-users \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

You'll get back a JSON list of all the Instagram accounts connected to your Storrito workspace, with their instagramUsername values to use in schedule-instagram-story.

Story Components

Stories can be built using HTML and a small set of <insta-story> web components. Drop a <insta-hashtag>, <insta-mention>, <insta-link>, or other sticker component into your HTML and the API will extract it as a native Instagram sticker. This means your Stories can be designed in any way HTML allows — gradients, custom fonts, images, layouts — and Storrito handles the conversion to a real Instagram Story.

Works with AI coding agents

The Storrito API works well with AI coding agents like Claude Code, Cursor, and GitHub Copilot. You can paste a short prompt describing what you want, point the agent at the API documentation, and have a working integration in minutes. We've designed the API to be predictable and self-documenting so agents can use it without much hand-holding.

Limits to know

• Storrito quota: 60 API requests per minute, and 100 Story posts per Instagram account per 24 hours.
• Instagram limits: Instagram itself allows roughly 15–25 Stories per account per day. Exceeding this can trigger temporary cooldowns. Space your Stories out and avoid posting the same design repeatedly — Instagram's spam detection flags duplicate content.
• Video format: Stories must be H.264, 1080×1920, between 0.5 and 60 seconds, and under 30 Mbps. See How To Convert Video Into A Compatible Format if you need to re-encode a video.

Full documentation

The complete API reference — including every procedure, request and response schemas, and example code — is available at storrito.com/documentation/api/v1. Your Bearer token and personal base URL are in your Storrito account under API Credentials, which also links the same documentation.

If you have questions or run into issues, reach out to support — we're happy to help with your integration.