Analytics API
Outbound Engagement Analytics
Analyze where a tracked account leaves likes and comments. See which accounts they interact with most, recent engagement activity, and interaction patterns. Requires PRO subscription and Deep Analytics addon.
GET
/api/analytics/outboundAuth: Bearer JWT only — this endpoint does not accept X-Api-KeyRate limits: Requires PRO+ subscription and active Deep Analytics addon ($4/mo per account).
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
| username | query | string | Yes | Tracked Instagram username |
| days | query | integer | No | Days to look back (1-90, default: 30) |
Response
json
{
"username": "example",
"days": 30,
"totalLikes": 156,
"totalComments": 23,
"topTargets": [
{
"username": "close_friend",
"likes": 45,
"comments": 12
},
{
"username": "favorite_brand",
"likes": 28,
"comments": 5
}
],
"recentActivity": [
{
"type": "like",
"targetUsername": "close_friend",
"targetPostId": "post_123",
"detectedAt": "2026-03-04T11:00:00Z"
}
]
}Code Examples
cURL
curl "https://storiesfly.com/api/analytics/outbound?username=example&days=30" \
-H "Authorization: Bearer YOUR_SESSION_JWT"JavaScript
const res = await fetch(
"https://storiesfly.com/api/analytics/outbound?username=example&days=30",
{ headers: { Authorization: "Bearer YOUR_SESSION_JWT" } }
);
const data = await res.json();
console.log(`${data.totalLikes} likes, ${data.totalComments} comments in ${data.days} days`);Python
import requests
response = requests.get(
"https://storiesfly.com/api/analytics/outbound",
params={"username": "example", "days": 30},
headers={"Authorization": "Bearer YOUR_SESSION_JWT"}
)
data = response.json()
print(f"{data['totalLikes']} likes, {data['totalComments']} comments")FAQ
What is outbound engagement?
Outbound engagement shows where a tracked account leaves likes and comments on other users' posts. This reveals who they interact with most and their engagement patterns.
Why does this require Deep Analytics?
Outbound engagement monitoring requires additional data collection (like and comment activity) beyond basic follower tracking. The Deep Analytics addon enables this per tracked account.
Why does my API key return 401 here?
This is the one endpoint that does not accept an API key. It authenticates against a signed-in session, so it needs an Authorization: Bearer header carrying your session JWT. Every other endpoint works with X-Api-Key.
Related Endpoints
Last updated: March 4, 2026