NewFans API, previously OnlyFans API · A new name. A broader platform.
Fans API
FanslyStories

Add to Story

Publish one photo or video to your story. Send exactly one media reference in mediaFiles — a fansly_media_ ID from the Upload Media endpoint, or a Fansly vault media ID (a mediaId from the List Vault Media endpoint). To post several media, call this endpoint once per media.

The media is registered as a new accountMedia for the story, so posting vault media leaves its existing posts and offers untouched. A story is free by default. Gate it with requirePurchase, requireSubscription and requireFollow (all must be met, as on Send Post), or with audiences — a list of alternative audiences, any one of which unlocks the story (e.g. "subscribed, OR pays $5"). audiences also supports private lists and availability windows. Add a free preview with previews.

Fansly decides how long a story stays active; there is no expiry, scheduling or edit option.

POST
/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

Request Body

application/json

mediaFiles*array<string>

Exactly one media reference: a fansly_media_ upload ID or a Fansly vault media ID.

requirePurchase?boolean

Require the fan to purchase (unlock) the story. Requires price. Cannot be combined with audiences.

price?integer

Unlock price for requirePurchase, in Fansly's smallest unit — 1000 = $1.00.

requireSubscription?boolean

Require the fan to be subscribed. Cannot be combined with audiences.

subscriptionTierId?string

Restrict requireSubscription to one tier (from List Subscription Tiers). Omit for any tier.

requireFollow?boolean

Require the fan to follow the account. Cannot be combined with audiences.

audiences?

Alternative audiences; a fan meeting every requirement of any one audience can view the story. Each audience needs at least one requirement. Cannot be combined with the top-level gating fields.

previews?object

A free preview shown while the story is locked, as a map of the mediaFiles reference to the preview media (a fansly_media_ upload ID or a vault media ID).

Response Body

application/json

curl -X POST "https://app.fansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/stories" \  -H "Content-Type: application/json" \  -d '{    "mediaFiles": [      "fansly_media_01JR1234"    ]  }'
{
  "data": {
    "accountId": "800000000000000001",
    "contentType": 1,
    "contentId": "979175336375754752",
    "id": "979175336988143616"
  },
  "_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."
    }
  }
}