NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
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.

GET
/api/fansly/{fanslyAccount}/stories
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."
    }
  }
}