Media Vault
List Vault Media
List media items stored in your vault. See how many likes and how much tips did they get.
get/api/{account}/media/vault
Query parameters
querystring nullable
Optionally, search for a text query.
Example:Hi
Optionally, search for a text query.
field'recent' | 'most-liked' | 'highest-tips'
Sort the results by a field. Default recent
Example:recent
Sort the results by a field. Default recent
type'photo' | 'gif' | 'video' | 'audio'
Filter the results by a media type. Keep empty to show all media.
Example:photo
Filter the results by a media type. Keep empty to show all media.
listinteger
Only show media items from a specific list (category). Refer to our Media Vault Lists endpoints.
Only show media items from a specific list (category). Refer to our Media Vault Lists endpoints.
sort'desc' | 'asc'
Sort the results. Default desc
Example:desc
Sort the results. Default desc
limitinteger
Number of media to return per page (10 - 100). Default: 24
Example:24
Number of media to return per page (10 - 100). Default: 24
offsetinteger
The offset used for pagination. Default 0
The offset used for pagination. Default 0
Response
Example response
{
"data": {
"list": [
{
"id": 123,
"type": "audio",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 0,
"height": 0,
"size": 0,
"sources": []
},
"thumb": null,
"preview": null,
"squarePreview": null
},
"duration": 3,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "audio",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 0,
"height": 0,
"size": 0,
"sources": []
},
"thumb": null,
"preview": null,
"squarePreview": null
},
"duration": 3,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 2048,
"height": 1360,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 638,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 2048,
"height": 1360,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 638,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 1629,
"height": 1629,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 1629,
"height": 1629,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 1629,
"height": 1629,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 1629,
"height": 1629,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 500,
"height": 500,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 500,
"height": 500,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
},
{
"id": 123,
"type": "photo",
"convertedToVideo": false,
"canView": true,
"hasError": false,
"createdAt": "2025-01-01T00:00:00+00:00",
"isReady": true,
"counters": {
"likesCount": 0,
"tipsSumm": 0
},
"files": {
"full": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 1280,
"height": 720,
"size": 0,
"sources": []
},
"thumb": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 300,
"height": 300,
"size": 0
},
"preview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 540,
"size": 0
},
"squarePreview": {
"url": "https://cdn2.onlyfans.com/files/...",
"width": 960,
"height": 960,
"size": 0
}
},
"duration": 0,
"hasPosts": false,
"listStates": [
{
"id": 123,
"type": "posts",
"name": "Posts",
"hasMedia": true,
"canAddMedia": false
},
{
"id": 123,
"type": "stories",
"name": "Stories",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "messages",
"name": "Messages",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "streams",
"name": "Streams",
"hasMedia": false,
"canAddMedia": false
},
{
"id": 123,
"type": "custom",
"name": "custom category",
"hasMedia": false,
"canAddMedia": true
},
{
"id": 123,
"type": "media_stickers",
"name": "Uploads",
"hasMedia": false,
"canAddMedia": false
}
],
"releaseForms": [],
"hasCustomPreview": false,
"videoSources": {
"240": null,
"720": null
}
}
],
"hasMore": false
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999960,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 999,
"remaining_day": 49989
}
}
}