Tracker API
Track Instagram Followers
Monitor follower and following changes for Instagram accounts in real-time. Detects new followers, unfollowers, new follows, and unfollows. Returns a chronological activity feed.
GET
/api/trackerAuth: X-Api-Key header or Bearer JWTRate limits: Tracker Starter: 100/day (1 account), Growth: 500/day (5 accounts), Scale: 5K/day (10 accounts).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| page | query | integer | No | Page number (default: 1) |
| limit | query | integer | No | Items per page (default: 200) |
Response
json
{
"accounts": [
{
"igUsername": "target_account",
"followers": 15420,
"following": 892,
"lastPolledAt": "2026-03-04T12:00:00Z"
}
],
"activities": [
{
"type": "FOLLOW",
"igUsername": "target_account",
"targetUsername": "new_friend",
"detectedAt": "2026-03-04T11:30:00Z"
},
{
"type": "FOLLOWER_REMOVED",
"igUsername": "target_account",
"targetUsername": "former_fan",
"detectedAt": "2026-03-04T10:15:00Z"
}
]
}Code Examples
cURL
curl "https://storiesfly.com/api/tracker?page=1&limit=50" \
-H "X-Api-Key: sf_live_your_key_here"JavaScript
const res = await fetch(
"https://storiesfly.com/api/tracker?page=1&limit=50",
{ headers: { "X-Api-Key": "sf_live_your_key_here" } }
);
const { accounts, activities } = await res.json();
activities.forEach(a => console.log(`${a.type}: ${a.targetUsername}`));Python
import requests
response = requests.get(
"https://storiesfly.com/api/tracker",
params={"page": 1, "limit": 50},
headers={"X-Api-Key": "sf_live_your_key_here"}
)
data = response.json()
for activity in data["activities"]:
print(f"{activity['type']}: {activity['targetUsername']}")FAQ
How often are tracked accounts polled?
Polling is interval-based, not real-time. A tracked account becomes eligible for its next poll 60 minutes after the previous one on any tracker API plan (Starter, Growth, Scale), and 120 minutes after the previous one for BASIC web subscribers. Tracking requires a paid plan, so there is no free polling tier. These are minimum ages rather than a guaranteed schedule: every cycle is bounded by Instagram's rate limits, and accounts with very large follower or following lists fall back to a lighter count-only check between full list diffs.
Can I track private accounts?
No, only public Instagram accounts can be tracked. The tracker monitors publicly available follower and following lists.
What activity types are detected?
FOLLOW (target followed someone), UNFOLLOW (target unfollowed someone), FOLLOWER_ADDED (someone started following target), FOLLOWER_REMOVED (someone unfollowed target), STORY_POST (target posted a story).
Related Endpoints
Last updated: March 4, 2026