OnlyFans API
FanslyUsers

Get User Details

Get Fansly profile details for one or more usernames. Pass a single username or a comma-separated list to fetch multiple profiles in a single call — bulk requests still only cost one API credit.

GET
/api/fansly/{fanslyAccount}/users/{usernames}
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

A Fansly username, or a comma-separated list of usernames.

Response Body

application/json

curl -X GET "https://app.onlyfansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/users/exampleuser"
{
  "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."
    }
  }
}