We just released our native n8n integration!» Try now
OnlyFans API
Stories

List Active Stories

Retrieve a list of your currently active stories.

GET
/api/{account}/stories
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

accountstring

The Account ID

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/stories"
{
  "data": [
    {
      "id": 123,
      "userId": 123,
      "isReady": true,
      "hasPost": false,
      "isWatched": true,
      "media": [
        {
          "id": 123,
          "type": "photo",
          "convertedToVideo": false,
          "canView": true,
          "hasError": false,
          "createdAt": "2025-01-01T01:01:01+00:00",
          "isReady": true,
          "files": {
            "full": {
              "url": "https://cdn2.onlyfans.com/files/...",
              "width": 600,
              "height": 400,
              "size": 0,
              "sources": []
            },
            "thumb": {
              "url": "https://cdn2.onlyfans.com/files/...",
              "width": 300,
              "height": 300,
              "size": 0
            },
            "preview": {
              "url": "https://cdn2.onlyfans.com/files/...",
              "width": 600,
              "height": 400,
              "size": 0,
              "sources": {
                "w150": "https://cdn2.onlyfans.com/files/..."
              }
            },
            "squarePreview": {
              "url": "https://cdn2.onlyfans.com/files/...",
              "width": 960,
              "height": 960,
              "size": 0,
              "sources": {
                "w150": "https://thumbs.onlyfans.com/...",
                "w480": "https://thumbs.onlyfans.com/..."
              }
            }
          },
          "duration": 0,
          "hasCustomPreview": false,
          "videoSources": {
            "240": null,
            "720": null
          }
        }
      ],
      "createdAt": "2025-01-01T01:01:01+00:00",
      "question": null,
      "viewersCount": 0,
      "viewers": [],
      "commentsCount": 0,
      "canDelete": true,
      "isHighlightCover": false,
      "isLastInHighlight": false,
      "tipsAmount": "$0",
      "tipsAmountRaw": 0,
      "tipsCount": 0,
      "likesCount": 0,
      "releaseForms": []
    }
  ],
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 1000999770,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 5000,
      "limit_day": null,
      "remaining_minute": 4996,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}