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?
Tracked accounts are polled every 15-60 minutes depending on account size and your plan tier. Larger accounts are polled less frequently to stay within Instagram's rate limits.
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