curl --request GET \
--url https://api.onlyx.ai/v1/fan-lists \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fan-lists"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/fan-lists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));List fan lists
Lists the creators’ OnlyFans fan lists — system lists such as all subscribers or renew-off, and lists the creator made herself — with how many fans are on each. List ids appear on each fan’s lists. Lists are mirrored from OnlyFans; managing them is not available through the API yet. A creatorId the credential cannot see is 404 CREATOR_NOT_FOUND.
Scope: requires fans:read.
Rate limit: the general limit of 120 requests per 60 seconds per credential.
curl --request GET \
--url https://api.onlyx.ai/v1/fan-lists \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.onlyx.ai/v1/fan-lists"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.onlyx.ai/v1/fan-lists', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Authorizations
An API key (onx_sk_…) created in OnlyX under Settings → API & MCP, or an OAuth access token (onx_at_…) issued to a connected app. Send it as Authorization: Bearer <credential>. API keys may also be sent as X-API-Key: <key>.
Query Parameters
Only this creator's lists.
40Page size, 1-100. Default 25.
1 <= x <= 100Opaque cursor from the previous page's nextCursor. Omit for the first page.
1024