Content API
Get Instagram Stories
Fetch Instagram stories for any public account anonymously. Returns story items with media URLs, thumbnails, and timestamps. Stories are available for 24 hours after posting.
POST
/api/storiesAuth: X-Api-Key header or Bearer JWTRate limits: Free: 25/day, Starter: 500/day, Growth: 5K/day, Scale: 50K/day. Burst: 60/min.
Request Body
json
{
"username": "instagram"
}Response
json
{
"username": "instagram",
"items": [
{
"id": "story_3291847",
"mediaType": "image",
"source": "https://cdninstagram.com/...",
"thumbnail": "https://cdninstagram.com/...",
"takenAt": "2026-03-04T10:30:00Z"
},
{
"id": "story_3291848",
"mediaType": "video",
"source": "https://cdninstagram.com/...",
"thumbnail": "https://cdninstagram.com/...",
"takenAt": "2026-03-04T11:15:00Z"
}
]
}Code Examples
cURL
curl -X POST https://storiesfly.com/api/stories \
-H "X-Api-Key: sf_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"username": "instagram"}'JavaScript
const res = await fetch("https://storiesfly.com/api/stories", {
method: "POST",
headers: {
"X-Api-Key": "sf_live_your_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({ username: "instagram" }),
});
const { items } = await res.json();
console.log(`Found ${items.length} stories`);Python
import requests
response = requests.post(
"https://storiesfly.com/api/stories",
headers={"X-Api-Key": "sf_live_your_key_here"},
json={"username": "instagram"}
)
stories = response.json()["items"]
print(f"Found {len(stories)} stories")FAQ
Can I fetch stories for private accounts?
No, the Stories API only works with public Instagram accounts. Private accounts require the user to be logged in, which is not supported via API.
How long are stories available?
Instagram stories expire after 24 hours. The API returns currently active stories only. Use the Tracker API to get notified when an account posts new stories.
What media formats are returned?
Stories can be images (JPEG) or videos (MP4). The mediaType field indicates the type. Both source URL and thumbnail URL are provided.
Related Endpoints
Last updated: March 4, 2026