OnlyFans API
User list collections

Get User List

Get a user list

GET
/api/{account}/user-lists/{userListId}
AuthorizationBearer <token>

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

In: header

Path Parameters

accountstring

The Account ID

userListIdinteger

OnlyFans User List ID, or a default list name like tagged

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/user-lists/0"
{
  "data": {
    "id": 123,
    "type": "custom",
    "name": "List name",
    "usersCount": 123,
    "postsCount": 123,
    "order": "default",
    "direction": "asc",
    "canUpdate": true,
    "canDelete": true,
    "canManageUsers": true,
    "canAddUsers": true,
    "canPinnedToFeed": true,
    "isPinnedToFeed": false,
    "canPinnedToChat": true,
    "isPinnedToChat": false,
    "sortList": [],
    "users": [
      {
        "view": "t",
        "id": 123,
        "name": "Name",
        "username": "username",
        "isVerified": true,
        "avatar": "https://public.onlyfans.com/files/m/mk/mka/.../avatar.jpg",
        "avatarThumbs": {
          "c50": "https://thumbs.onlyfans.com/public/files/thumbs/c50/m/mk/mka/.../avatar.jpg",
          "c144": "https://thumbs.onlyfans.com/public/files/thumbs/c144/m/mk/mka/.../avatar.jpg"
        }
      }
    ]
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999974,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 997,
      "remaining_day": 49986
    }
  }
}