The Only API docs
Misc

Get top stories stats

Retrieves top-performing story statistics over a date range. OnlyFans only — Fansly accounts are rejected on /api2/v2/.

GET
/api2/v2/users/me/stats/top/story

Retrieves top-performing story statistics over a date range. OnlyFans only — Fansly accounts are rejected on /api2/v2/*.

✓ Verified live against a real OnlyFans account (2026-07-30); the data schema below is the real response shape.

Guide: The two surfaces

Authorization

apiKey
X-API-Key<token>

Your CRM panel API key

In: header

Query Parameters

startDate*string

Start of date range

endDate*string

End of date range

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/users/me/stats/top/story?startDate=string&endDate=string" \  -H "user-id: 509955039"
{  "success": true,  "status_code": 0,  "data": {    "tips": null,    "views": {      "id": 0,      "userId": 0,      "isReady": true,      "hasPost": true,      "isWatched": true,      "media": [        {}      ],      "createdAt": "string",      "canvasHeight": 0,      "canvasWidth": 0,      "question": {        "entity": {},        "type": "string",        "positions": {}      },      "viewersCount": 0,      "viewers": [        {}      ],      "commentsCount": 0,      "canDelete": true,      "isHighlightCover": true,      "isLastInHighlight": true,      "tipsAmount": "string",      "tipsAmountRaw": 0,      "tipsCount": 0,      "likesCount": 0,      "releaseForms": []    },    "likes": {      "id": 0,      "userId": 0,      "isReady": true,      "hasPost": true,      "isWatched": true,      "media": [        {}      ],      "createdAt": "string",      "canvasHeight": 0,      "canvasWidth": 0,      "question": {        "entity": {},        "type": "string",        "positions": {}      },      "viewersCount": 0,      "viewers": [        {}      ],      "commentsCount": 0,      "canDelete": true,      "isHighlightCover": true,      "isLastInHighlight": true,      "tipsAmount": "string",      "tipsAmountRaw": 0,      "tipsCount": 0,      "likesCount": 0,      "releaseForms": []    },    "comments": {      "id": 0,      "userId": 0,      "isReady": true,      "hasPost": true,      "isWatched": true,      "media": [        {}      ],      "createdAt": "string",      "canvasHeight": 0,      "canvasWidth": 0,      "question": {        "entity": {},        "type": "string",        "positions": {}      },      "viewersCount": 0,      "viewers": [        {}      ],      "commentsCount": 0,      "canDelete": true,      "isHighlightCover": true,      "isLastInHighlight": true,      "tipsAmount": "string",      "tipsAmountRaw": 0,      "tipsCount": 0,      "likesCount": 0,      "releaseForms": []    }  }}

Get top posts statistics GET

Returns the current user's top-performing posts statistics for a date range. Sibling calls fetch top story/stream/stream stats. OnlyFans only — Fansly accounts are rejected…

Get top streams stats GET

Returns the current user's top-performing streams statistics for a date range. The dynamic suffix in path_raw is the querystring. OnlyFans only — Fansly accounts are…