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 Highlights

Fetch items from an Instagram highlight reel. Returns media URLs for all items in the highlight. Highlights are permanent story collections that don't expire.

GET/api/highlights

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
id	query	string	Yes	Highlight reel ID

Response

json

{
  "items": [
    {
      "id": "hl_item_1",
      "mediaType": "image",
      "source": "https://cdninstagram.com/..."
    },
    {
      "id": "hl_item_2",
      "mediaType": "video",
      "source": "https://cdninstagram.com/..."
    }
  ]
}

Code Examples

cURL

curl "https://storiesfly.com/api/highlights?id=highlight:12345" \
  -H "X-Api-Key: sf_live_your_key_here"

JavaScript

const res = await fetch(
  "https://storiesfly.com/api/highlights?id=highlight:12345",
  { headers: { "X-Api-Key": "sf_live_your_key_here" } }
);
const { items } = await res.json();
console.log(`Highlight has ${items.length} items`);

Python

import requests

response = requests.get(
    "https://storiesfly.com/api/highlights",
    params={"id": "highlight:12345"},
    headers={"X-Api-Key": "sf_live_your_key_here"}
)
items = response.json()["items"]
print(f"Highlight has {len(items)} items")