Get user's media list

1 import requests 2 3 url = "https://api.fanvue.com/media" 4 5 headers = { 6 "X-Fanvue-API-Version": "2025-06-26", 7 "Authorization": "Bearer <token>" 8 } 9 10 response = requests.get(url, headers=headers) 11 12 print(response.json())

1 { 2 "data": [ 3 { 4 "uuid": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a", 5 "status": "ready", 6 "createdAt": "2024-01-15T00:00:00.000Z", 7 "url": "https://media.fanvue.com/main/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.mp4", 8 "caption": "Check out my latest video!", 9 "description": "Behind the scenes of my photoshoot", 10 "name": "photoshoot-video.mp4", 11 "variants": [ 12 { 13 "uuid": "e5f6a7b8-9c0d-1e2f-3a4b-5c6d7e8f9a0b", 14 "variantType": "main", 15 "displayPosition": 0, 16 "url": "https://media.fanvue.com/main/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.mp4", 17 "width": 1920, 18 "height": 1080, 19 "lengthMs": 45000 20 }, 21 { 22 "uuid": "f6a7b8c9-0d1e-2f3a-4b5c-6d7e8f9a0b1c", 23 "variantType": "thumbnail", 24 "displayPosition": 1, 25 "url": "https://media.fanvue.com/thumb/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg", 26 "width": 320, 27 "height": 180, 28 "lengthMs": null 29 }, 30 { 31 "uuid": "a7b8c9d0-1e2f-3a4b-5c6d-7e8f9a0b1c2d", 32 "variantType": "blurred", 33 "displayPosition": 2, 34 "url": "https://media.fanvue.com/blur/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.mp4", 35 "width": 1920, 36 "height": 1080, 37 "lengthMs": 45000 38 } 39 ] 40 }, 41 { 42 "uuid": "b8c9d0e1-2f3a-4b5c-6d7e-8f9a0b1c2d3e", 43 "status": "processing" 44 } 45 ], 46 "pagination": { 47 "page": 1, 48 "size": 2, 49 "hasMore": true 50 } 51 }

Returns a paginated list of media items for the authenticated user.

For media with status other than FINALISED, only uuid and status are returned. For FINALISED media, all details including variants are included.

Scope required: read:media

Returns a paginated list of media items for the authenticated user. For media with status other than FINALISED, only uuid and status are returned. For FINALISED media, all details including variants are included. <Info>Scope required: `read:media`</Info>

Authentication

AuthorizationBearer

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

Query Parameters

pagedoubleOptional>=1Defaults to 1

Page number to retrieve (starts from 1)

sizedoubleOptional1-50Defaults to 15

Number of items to return per page (1-50, default: 15)

mediaTypeenumOptional

Allowed values:

folderNamestringOptional

usageenumOptional

Allowed values:

statuslist of enumsOptional

Allowed values:

variantslist of enumsOptional

Allowed values:

Response

List of user media

datalist of objects

Array of media items

paginationobject

Pagination information

Authentication

Headers

Query Parameters

Response

Errors