OnlyFans API
Media vault lists

List Vault Lists

List your Vault lists (categories).

GET
/api/{account}/media/vault/lists
AuthorizationBearer <token>

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

In: header

Path Parameters

accountstring

The Account ID

Query Parameters

query?string

Optionally, find a list by its name.

limit?integer

Number of media to return per page. Default: 24

offset?integer

The offset used for pagination. Default 0

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/media/vault/lists?query=My+list+name&limit=24&offset=0"
{
  "data": {
    "list": [
      {
        "id": 123,
        "type": "stories",
        "name": "Stories",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "streams",
        "name": "Streams",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "media_stickers",
        "name": "Uploads",
        "hasMedia": false,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "posts",
        "name": "Posts",
        "hasMedia": true,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 0,
        "photosCount": 5,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": [
          {
            "type": "photo",
            "url": "https://cdn2.onlyfans.com/files/..."
          }
        ]
      },
      {
        "id": 123,
        "type": "custom",
        "name": "custom category",
        "hasMedia": false,
        "canUpdate": true,
        "canDelete": true,
        "videosCount": 0,
        "photosCount": 0,
        "gifsCount": 0,
        "audiosCount": 0,
        "medias": []
      },
      {
        "id": 123,
        "type": "messages",
        "name": "Messages",
        "hasMedia": true,
        "canUpdate": false,
        "canDelete": false,
        "videosCount": 1,
        "photosCount": 4,
        "gifsCount": 0,
        "audiosCount": 2,
        "medias": [
          {
            "type": "photo",
            "url": "https://cdn2.onlyfans.com/files/..."
          }
        ]
      }
    ],
    "all": {
      "videosCount": 1,
      "photosCount": 9,
      "gifsCount": 0,
      "audiosCount": 2,
      "medias": [
        {
          "type": "photo",
          "url": "https://cdn2.onlyfans.com/files/..."
        }
      ]
    },
    "hasMore": false,
    "canCreateVaultLists": true,
    "order": "asc",
    "sort": "default"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999945,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 998,
      "remaining_day": 49968
    }
  }
}