The Only API docs
Stories

List story viewers

Returns the list of viewers for a story, with pagination; a variant filters to only viewers who tipped. OnlyFans only — Fansly accounts are rejected on /api2/v2/.

GET
/api2/v2/stories/{story_id}/viewers

Returns the list of viewers for a story, with pagination; a variant filters to only viewers who tipped. OnlyFans only — Fansly accounts are rejected on /api2/v2/*.

Guide: The two surfaces

Authorization

apiKey
X-API-Key<token>

Your CRM panel API key

In: header

Path Parameters

story_id*string

Id of the story

Query Parameters

limit?string

Page size

offset?string

Pagination offset

onlyWithTips?string

Return only viewers who tipped (used by one variant)

Header Parameters

user-id*string

Creator account ID of the account to act as (e.g. 509955039). Required — omitting it returns 400 user-id header is required. Use GET /accounts to list your connected accounts. On /api2/v2/* the account must be an OnlyFans account; Fansly accounts are rejected there.

X-Proxy?string

Proxy URL — HTTP or SOCKS5 (e.g. http://user:pass@host:port or socks5://user:pass@host:port). Optional on post-connection routes, where it overrides the proxy saved at login time. Required on the connection routes (POST /accounts/login, POST /accounts/login/cookies, POST /accounts/login/verify-otp) for OnlyFans accounts; optional for Fansly.

Response Body

application/json

curl -X GET "https://example.com/api2/v2/stories/string/viewers" \  -H "user-id: 509955039"
{  "success": true,  "status_code": 0,  "data": null,  "relogin": true}

Unlike a story DELETE

Removes a like from the specified story. Paired with a POST on the same path to like it. OnlyFans only — Fansly accounts are rejected on /api2/v2/.

Mark story as watched PUT

Marks a story as watched/seen by the current user. OnlyFans only — Fansly accounts are rejected on /api2/v2/.