We just released our native n8n integration!» Try now
OnlyFans API
Media Vault

Get Vault Media

Retrieve details about a specific media item in your vault.

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

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

In: header

Path Parameters

accountstring

The Account ID

media_idinteger

The ID of the media item to retrieve.

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/media/vault/0"
{
  "data": {
    "id": 12345678,
    "type": "photo",
    "convertedToVideo": false,
    "canView": true,
    "hasError": false,
    "createdAt": "2025-01-01T00:00:00+00:00",
    "isReady": true,
    "files": {
      "full": {
        "url": "https://cdn2.onlyfans.com/files/1/15/.../....jpg",
        "width": 1280,
        "height": 720,
        "size": 0,
        "sources": []
      },
      "thumb": {
        "url": "https://cdn2.onlyfans.com/files/5/56/.../...jpg",
        "width": 300,
        "height": 300,
        "size": 0
      },
      "preview": {
        "url": "https://cdn2.onlyfans.com/files/7/76/.../...jpg",
        "width": 960,
        "height": 540,
        "size": 0
      },
      "squarePreview": {
        "url": "https://cdn2.onlyfans.com/files/4/48/.../...jpg",
        "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": "Special posts",
        "hasMedia": false,
        "canAddMedia": true
      },
      {
        "id": 123,
        "type": "media_stickers",
        "name": "Uploads",
        "hasMedia": false,
        "canAddMedia": false
      }
    ],
    "hasCustomPreview": false,
    "videoSources": {
      "240": null,
      "720": null
    }
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 563,
      "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": 49991
    }
  }
}