Skip to main content
GET
/
media
/
bulk
Get bulk media by UUIDs
curl --request GET \
  --url https://api.fanvue.com/media/bulk \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "results": {
    "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a": {
      "uuid": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
      "status": "ready",
      "createdAt": "2024-01-15T00:00:00.000Z",
      "caption": "Sunset at the beach",
      "description": null,
      "name": "beach-sunset.jpg",
      "mediaType": "image",
      "recommendedPrice": null,
      "tags": {
        "description": "Behind-the-scenes shot at sunset on a beach.",
        "tags": [
          "beach",
          "sunset",
          "outdoors"
        ],
        "nsfwCategory": [],
        "sexActs": [],
        "bodyParts": [],
        "people": [
          "solo woman"
        ],
        "sexObjects": [],
        "setting": [
          "beach",
          "sunset"
        ],
        "position": [],
        "skinColor": [],
        "bodyType": [],
        "hairColor": [
          "blonde"
        ],
        "otherTags": [],
        "importantTags": [
          "beach"
        ],
        "isNsfw": false,
        "mediaType": "image"
      },
      "variants": [
        {
          "uuid": "c9d0e1f2-3a4b-5c6d-7e8f-9a0b1c2d3e4f",
          "variantType": "main",
          "displayPosition": 0,
          "url": "https://media.fanvue.com/main/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
          "width": 3840,
          "height": 2160,
          "lengthMs": null
        },
        {
          "uuid": "d0e1f2a3-4b5c-6d7e-8f9a-0b1c2d3e4f5a",
          "variantType": "thumbnail",
          "displayPosition": 1,
          "url": "https://media.fanvue.com/thumb/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
          "width": 320,
          "height": 180,
          "lengthMs": null
        },
        {
          "uuid": "e1f2a3b4-5c6d-7e8f-9a0b-1c2d3e4f5a6b",
          "variantType": "thumbnail_gallery",
          "displayPosition": 2,
          "url": "https://media.fanvue.com/gallery/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
          "width": 400,
          "height": 300,
          "lengthMs": null
        },
        {
          "uuid": "f2a3b4c5-6d7e-8f9a-0b1c-2d3e4f5a6b7c",
          "variantType": "blurred",
          "displayPosition": 3,
          "url": "https://media.fanvue.com/blur/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
          "width": 3840,
          "height": 2160,
          "lengthMs": null
        }
      ]
    },
    "00000000-0000-0000-0000-000000000000": null
  },
  "errors": [
    {
      "mediaUuid": "00000000-0000-0000-0000-000000000000",
      "code": "NOT_FOUND",
      "message": "Media not found"
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Query Parameters

mediaUuids
string
required
variants
string

Response

Bulk media response

results
object
required

Map media UUID -> media payload (null when unavailable)

errors
object[]
required

Per-media errors for unresolved entries