OnlyFans API
Users

Get User Details

Get OnlyFans Profile details for a given username. User details are retrieved using the current current `{account}` so fields like `subscribedOnData` which include potential subscription details will be included.

GET
/api/{account}/users/{username}
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

accountstring

The Account ID

usernamestring

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/users/string"
{
  "data": {
    "view": "f",
    "avatar": "https://public.onlyfans.com/files/i/i2/i25/.../123/avatar.jpg",
    "avatarThumbs": {
      "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/i/i2/i25/.../123/avatar.jpg",
      "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/i/i2/i25/.../123/avatar.jpg"
    },
    "header": "https://public.onlyfans.com/files/c/cs/cse/.../123/header_image.jpg",
    "headerSize": {
      "width": 4386,
      "height": 1224
    },
    "headerThumbs": {
      "w480": "https://thumbs.onlyfans.com/public/files/thumbs/w480/c/cs/cse/.../123/header_image.jpg",
      "w760": "https://thumbs.onlyfans.com/public/files/thumbs/w760/c/cs/cse/.../123/header_image.jpg"
    },
    "id": 123,
    "name": "name",
    "username": "username",
    "canLookStory": true,
    "canCommentStory": true,
    "hasNotViewedStory": true,
    "isVerified": true,
    "canPayInternal": true,
    "hasScheduledStream": false,
    "hasStream": false,
    "hasStories": true,
    "tipsEnabled": true,
    "tipsTextEnabled": true,
    "tipsMin": 5,
    "tipsMinInternal": 1,
    "tipsMax": 200,
    "canEarn": true,
    "canAddSubscriber": true,
    "subscribePrice": 12.99,
    "subscriptionBundles": [
      {
        "id": 123,
        "discount": 50,
        "duration": 3,
        "price": 19.49,
        "canBuy": true
      }
    ],
    "displayName": "",
    "notice": "",
    "isPaywallRequired": true,
    "isRestricted": false,
    "canRestrict": true,
    "subscribedBy": true,
    "subscribedByExpire": false,
    "subscribedByExpireDate": "2025-01-01T01:01:01+00:00",
    "subscribedByAutoprolong": false,
    "subscribedIsExpiredNow": false,
    "currentSubscribePrice": 0,
    "subscribedOn": null,
    "subscribedOnExpiredNow": true,
    "subscribedOnDuration": "7 days",
    "listsStates": [
      {
        "id": "following",
        "type": "following",
        "name": "Following",
        "hasUser": true,
        "canAddUser": false,
        "cannotAddUserReason": "ALREADY_EXISTS"
      },
      {
        "id": "fans",
        "type": "fans",
        "name": "Fans",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": null
      },
      {
        "id": "recent",
        "type": "recent",
        "name": "Recent (last 24 hours)",
        "hasUser": false,
        "canAddUser": false,
        "cannotAddUserReason": "SYSTEM_LIST"
      },
      {
        "id": "tagged",
        "type": "tagged",
        "name": "Tagged",
        "hasUser": true,
        "canAddUser": false,
        "cannotAddUserReason": "ALREADY_EXISTS"
      },
      {
        "id": "friends",
        "type": "friends",
        "name": "Friends",
        "hasUser": false,
        "canAddUser": true,
        "cannotAddUserReason": null
      },
      {
        "id": "muted",
        "type": "muted",
        "name": "Muted",
        "hasUser": false,
        "canAddUser": true,
        "cannotAddUserReason": null
      }
    ],
    "joinDate": "2025-01-01T01:01:01+00:00",
    "isReferrerAllowed": true,
    "about": "About",
    "isMarkdownDisabledForAbout": true,
    "website": null,
    "wishlist": null,
    "location": "location",
    "postsCount": 123,
    "archivedPostsCount": 1,
    "privateArchivedPostsCount": 123,
    "photosCount": 123,
    "videosCount": 63,
    "audiosCount": 0,
    "mediasCount": 123,
    "lastSeen": "2025-01-01T01:01:01+00:00",
    "favoritesCount": 123,
    "favoritedCount": 123,
    "showPostsInFeed": true,
    "canReceiveChatMessage": true,
    "isPerformer": true,
    "isRealPerformer": true,
    "isSpotifyConnected": false,
    "subscribersCount": null,
    "hasPinnedPosts": true,
    "hasLabels": true,
    "canChat": true,
    "avatarHeaderConverterUpload": true,
    "isPrivateRestriction": false,
    "showSubscribersCount": false,
    "showMediaCount": true,
    "subscribedByData": {
      "price": 0,
      "newPrice": 0,
      "regularPrice": 12.99,
      "subscribePrice": 12.99,
      "discountPercent": 0,
      "discountPeriod": 1,
      "subscribeAt": "2025-01-01T01:01:01+00:00",
      "expiredAt": "2025-01-01T01:01:01+00:00",
      "renewedAt": null,
      "discountFinishedAt": null,
      "discountStartedAt": null,
      "status": "Set to Expire",
      "isMuted": false,
      "unsubscribeReason": "No reason given",
      "duration": "2 months",
      "showPostsInFeed": true,
      "subscribes": [
        {
          "id": 123,
          "userId": 123,
          "subscriberId": 123,
          "date": "2025-01-01T01:01:01+00:00",
          "duration": 360,
          "startDate": "2025-01-01T01:01:01+00:00",
          "expireDate": "2025-01-01T01:01:01+00:00",
          "cancelDate": null,
          "price": 0,
          "regularPrice": 12.99,
          "discount": 0,
          "earningId": 0,
          "action": "subscribe",
          "type": "trial",
          "offerStart": "2025-01-01T01:01:01+00:00",
          "offerEnd": null,
          "isCurrent": true
        }
      ],
      "hasActivePaidSubscriptions": false
    },
    "subscribedOnData": {
      "price": 0,
      "newPrice": 0,
      "regularPrice": 0,
      "subscribePrice": 0,
      "discountPercent": 0,
      "discountPeriod": 1,
      "subscribeAt": "2025-01-01T01:01:01+00:00",
      "expiredAt": "2025-01-01T01:01:01+00:00",
      "renewedAt": null,
      "discountFinishedAt": null,
      "discountStartedAt": null,
      "status": null,
      "isMuted": false,
      "unsubscribeReason": "No reason given",
      "duration": "7 days",
      "tipsSumm": 0,
      "subscribesSumm": 0,
      "messagesSumm": 0,
      "postsSumm": 0,
      "streamsSumm": 0,
      "totalSumm": 0,
      "subscribes": [],
      "hasActivePaidSubscriptions": false
    },
    "canCreatePromotion": true,
    "canCreateTrial": true,
    "isAdultContent": false,
    "canTrialSend": false,
    "hasLinks": false,
    "hasFriends": false,
    "finishedStreamsCount": 0,
    "shouldShowFinishedStreams": false,
    "hasSavedStreams": false,
    "firstPublishedPostDate": "2025-01-01T01:01:01+00:00",
    "isSpringConnected": false,
    "isFriend": false,
    "isBlocked": false,
    "canReport": true,
    "canUnsubscribe": true,
    "isPendingAutoprolong": false
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999834,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 10000000,
      "limit_day": 50000,
      "remaining_minute": 9999999,
      "remaining_day": 49992
    }
  }
}