API Keys
Connect OnlyFans Account
Media Vault
Media Vault Lists
Payouts
Post Labels
Public Profiles
Statistics / Reach
Statistics / Statements
Tracking Links
Transactions
Users
Media Vault Lists
List Vault Lists
List your Vault lists (categories).
GET
/
api
/
{account}
/
media
/
vault
/
lists
curl --request GET \
--url https://app.onlyfansapi.com/api/{account}/media/vault/lists \
--header 'Authorization: Bearer <token>'
{
"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
}
}
}
Authorizations
You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.
Path Parameters
The Account ID
Query Parameters
Optionally, find a list by its name.
Example:
"My list name"
Number of media to return per page. Default: 24
Example:
24
The offset used for pagination. Default 0
Example:
0
Response
200 - application/json
The response is of type object
.
curl --request GET \
--url https://app.onlyfansapi.com/api/{account}/media/vault/lists \
--header 'Authorization: Bearer <token>'
{
"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
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.