What is the StoriesFly API?

StoriesFly API is a REST API for Instagram stories, profiles, highlights, media, follower tracking, and shadow ban detection. Developers authenticate with X-Api-Key header. Free tier: 25 requests/day. Paid plans: 500 to 50,000 requests/day.

How do I get an API key?

Sign up at storiesfly.com/developers, click Create Key, name it (e.g. Production), and copy the key. It is shown only once. Include it as X-Api-Key header in all requests.

What endpoints does the API offer?

Content: POST /api/stories (fetch stories), GET /api/profile (profile data), GET /api/highlights (highlight items), POST /api/media (post/reel URLs), GET /api/download (CDN proxy). Analytics: GET /api/analytics/shadowban (7-signal shadow ban check). Tracker: GET/POST/DELETE /api/tracker/accounts, GET /api/tracker (activity feed), GET /api/tracker/quota.

How much does the StoriesFly API cost?

Free tier: 25 requests/day, no credit card. Paid content API: Starter $9.99/mo (500/day), Growth $29.99/mo (5k/day), Scale $99/mo (50k/day). Tracker API: Starter $4.99/mo (1 account), Growth $14.99/mo (5 accounts), Scale $49/mo (10 accounts).

Does the API support real-time follower tracking?

Yes. The Tracker API monitors follower/following changes in real-time. Add accounts via POST /api/tracker/accounts, then poll GET /api/tracker for follow/unfollow events. Requires a paid Tracker plan or web subscription (Basic/Pro/Enterprise).

Content API

Get Instagram Profile

Get cached Instagram profile data including follower count, following count, post count, bio, profile picture, and privacy status. Data is refreshed periodically for frequently queried accounts.

GET/api/profile

Auth: X-Api-Key header or Bearer JWTRate limits: Free: 25/day, Starter: 500/day, Growth: 5K/day, Scale: 50K/day. Burst: 60/min.

Parameters

Name	In	Type	Required	Description
username	query	string	Yes	Instagram username (without @)

Response

json

{
  "username": "instagram",
  "fullName": "Instagram",
  "profilePicUrl": "https://cdninstagram.com/...",
  "bio": "Bringing you closer to the people and things you love.",
  "posts": 7503,
  "followers": 680000000,
  "following": 75,
  "isPrivate": false
}

Code Examples

cURL

curl "https://storiesfly.com/api/profile?username=instagram" \
  -H "X-Api-Key: sf_live_your_key_here"

JavaScript

const res = await fetch(
  "https://storiesfly.com/api/profile?username=instagram",
  { headers: { "X-Api-Key": "sf_live_your_key_here" } }
);
const profile = await res.json();
console.log(`${profile.fullName}: ${profile.followers} followers`);

Python

import requests

response = requests.get(
    "https://storiesfly.com/api/profile",
    params={"username": "instagram"},
    headers={"X-Api-Key": "sf_live_your_key_here"}
)
profile = response.json()
print(f"{profile['fullName']}: {profile['followers']} followers")