FanslyStories
List Stories
List the active stories of an account — your own by default, or another creator's via accountId. Each story's contentId is an accountMedia ID; the matching media (with its variants, CDN locations, preview, permissions and likeCount) is in aggregationData.accountMedia.
Listing stories does not mark them as viewed. Story createdAt/updatedAt are in milliseconds, while nested media timestamps can be in seconds.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
fanslyAccount*string
The Fansly Account ID
Query Parameters
accountId?string
The Fansly account ID whose stories to list. Defaults to the authenticated account.
Request Body
application/json
accountId?string|null
Must match the regex /^[1-9][0-9]*$/.
Response Body
application/json
curl -X GET "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/stories?accountId=800000000000000001" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"mediaStories": [
{
"id": "979175336988143616",
"accountId": "800000000000000001",
"contentType": 1,
"contentId": "979175336375754752",
"createdAt": 1794947952000,
"updatedAt": 1794947952000
}
],
"aggregationData": {
"accountMedia": [
{
"id": "979175336375754752",
"accountId": "800000000000000001",
"mediaId": "979175276866985984",
"previewId": null,
"permissionFlags": 0,
"price": 0,
"createdAt": 1794947952,
"likeCount": 0,
"permissions": {
"permissionFlags": [],
"accountPermissionFlags": {
"flags": 255,
"metadata": "{}"
}
},
"media": {
"id": "979175276866985984",
"type": 1,
"status": 1,
"accountId": "800000000000000001",
"mimetype": "image/jpeg",
"filename": "story.jpeg",
"width": 1080,
"height": 1920,
"variants": [],
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/800000000000000001/979175276866985984.jpeg"
}
],
"createdAt": 1794947938
}
}
]
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 10055789,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 5000,
"limit_day": null,
"remaining_minute": 4999,
"remaining_day": null,
"notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
}
}
}