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"
}
]
}Media
Get bulk media by UUIDs
Returns multiple media items in a single request.
Each finalised media item includes a tags field containing structured AI
content tags when the owning creator has AI content tagging enabled and the
media has been processed (null otherwise).
Scope required: read:media
Note: Maximum 20 media UUIDs per request.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
API version to use for the request
Example:
"2025-06-26"
Was this page helpful?
⌘I