FanslyUsers
Get User Details
Get Fansly profile details for one or more users. Look them up by username in the URL path, or by Fansly account id via the ids query parameter. Either way you can pass a single value or a comma-separated list to fetch multiple profiles in a single call — bulk requests still only cost one API credit.
Authorization
default 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
usernames*string
Optional parameter. A Fansly username, or a comma-separated list of usernames. Optional when the ids query parameter is supplied instead.
Query Parameters
ids?string
A Fansly account id, or a comma-separated list of ids, to look up instead of usernames. Takes precedence over the URL path when provided.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/users/?ids=285552020591489024%2C833499506455629824"{
"data": [
{
"id": "100000000000000001",
"username": "exampleuser",
"displayName": null,
"flags": 18,
"version": 3,
"followCount": 1000,
"subscriberCount": 0,
"permissions": {
"accountPermissionFlags": {
"flags": 2
}
},
"timelineStats": {
"accountId": "100000000000000001",
"imageCount": 200,
"videoCount": 100,
"bundleCount": 10,
"bundleImageCount": 50,
"bundleVideoCount": 0,
"fetchedAt": 1700000000000
},
"mediaStoryState": {
"accountId": "100000000000000001",
"status": 2,
"storyCount": 0,
"version": 1,
"createdAt": 1700000000000,
"updatedAt": 1700000000000,
"hasActiveStories": false
},
"statusId": 1,
"lastSeenAt": 1700000000000,
"profileAccessFlags": 0,
"profileFlags": 0,
"about": "About text",
"location": "",
"profileSocials": [],
"profileBadges": [],
"following": true,
"accountMediaLikes": 1000,
"hasMainWall": true,
"walls": [
{
"id": "200000000000000001",
"accountId": "100000000000000001",
"pos": 0,
"name": "Posts",
"description": "",
"private": 0,
"metadata": "",
"defaultWall": true,
"mainWall": true
}
],
"avatar": {
"id": "300000000000000001",
"type": 1,
"status": 1,
"accountId": "100000000000000001",
"mimetype": "image/jpeg",
"flags": 0,
"location": "/100000000000000001/300000000000000001.jpeg",
"width": 1080,
"height": 1440,
"metadata": "{\"resolutionMode\":2}",
"updatedAt": 1700000000,
"createdAt": 1700000000,
"variants": [
{
"id": "300000000000000002",
"type": 1,
"status": 1,
"mimetype": "image/jpeg",
"flags": 0,
"location": "/100000000000000001/300000000000000002.jpeg",
"width": 720,
"height": 960,
"metadata": "{\"resolutionMode\":2}",
"updatedAt": 1700000000,
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/100000000000000001/300000000000000002.jpeg"
}
]
}
],
"variantHash": {},
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/100000000000000001/300000000000000001.jpeg"
}
]
},
"banner": {
"id": "400000000000000001",
"type": 1,
"status": 1,
"accountId": "100000000000000001",
"mimetype": "image/jpeg",
"flags": 0,
"location": "/100000000000000001/400000000000000001.jpeg",
"width": 1920,
"height": 1080,
"metadata": "{\"resolutionMode\":1}",
"updatedAt": 1700000000,
"createdAt": 1700000000,
"variants": [],
"variantHash": {},
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/100000000000000001/400000000000000001.jpeg"
}
]
},
"streaming": {
"accountId": "100000000000000001",
"channel": null,
"enabled": true
},
"postLikes": 100,
"subscriptionTiers": [
{
"id": "500000000000000001",
"accountId": "100000000000000001",
"name": "Subscription",
"color": "#444444",
"pos": 0,
"price": 5000,
"maxSubscribers": 0,
"subscriptionBenefits": [
"Benefit one",
"Benefit two"
],
"includedTierIds": [],
"plans": [
{
"id": "500000000000000002",
"status": 1,
"billingCycle": 30,
"price": 10000,
"useAmounts": 0,
"promos": [],
"uses": 0
}
]
}
],
"profileAccess": true
}
],
"_meta": {
"_credits": {
"used": 1,
"balance": 10055812,
"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."
}
}
}