Tracker API
Manage Tracked Accounts
Add, list, and remove Instagram accounts from your tracking list. Each account is monitored for follower/following changes. Account limits depend on your subscription tier.
GET / POST / DELETE
/api/tracker/accountsAuth: X-Api-Key header or Bearer JWTRate limits: Tracker Starter: 1 account max, Growth: 5 accounts, Scale: 10 accounts. Adds limited to 2-10/day depending on tier.
Request Body
json
{
"igUsername": "instagram"
}Response
json
{
"accounts": [
{
"id": "acc_123",
"igUsername": "instagram",
"followers": 680000000,
"following": 75,
"lastPolledAt": "2026-03-04T12:00:00Z"
}
]
}Code Examples
cURL
# List tracked accounts
curl "https://storiesfly.com/api/tracker/accounts" \
-H "X-Api-Key: sf_live_your_key_here"
# Add account to track
curl -X POST https://storiesfly.com/api/tracker/accounts \
-H "X-Api-Key: sf_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{"igUsername": "instagram"}'
# Remove tracked account
curl -X DELETE "https://storiesfly.com/api/tracker/accounts?accountId=acc_123" \
-H "X-Api-Key: sf_live_your_key_here"JavaScript
// Add account
const res = await fetch("https://storiesfly.com/api/tracker/accounts", {
method: "POST",
headers: {
"X-Api-Key": "sf_live_your_key_here",
"Content-Type": "application/json",
},
body: JSON.stringify({ igUsername: "instagram" }),
});
const account = await res.json();Python
import requests
# Add account
response = requests.post(
"https://storiesfly.com/api/tracker/accounts",
headers={"X-Api-Key": "sf_live_your_key_here"},
json={"igUsername": "instagram"}
)
account = response.json()FAQ
How many accounts can I track?
Depends on your plan: Tracker Starter allows 1 account, Growth allows 5, Scale allows 10. Web subscriptions (Basic/Pro/Enterprise) grant 1/10/50 respectively.
What happens when I remove a tracked account?
Tracking stops immediately. Historical activity data is retained but no new events are detected.
Related Endpoints
Last updated: March 4, 2026