Get creator's media list | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/creators/creatorUserUuid/media"
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "uuid": "d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a",
      "status": "ready",
      "createdAt": "2024-01-15T00:00:00.000Z",
      "caption": "Check out my latest video!",
      "description": "Behind the scenes of my photoshoot",
      "name": "photoshoot-video.mp4",
      "mediaType": "video",
      "recommendedPrice": 500,
      "variants": [
        {
          "uuid": "e5f6a7b8-9c0d-1e2f-3a4b-5c6d7e8f9a0b",
          "variantType": "main",
          "displayPosition": 0,
          "url": "https://media.fanvue.com/main/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.mp4",
          "width": 1920,
          "height": 1080,
          "lengthMs": 45000
        },
        {
          "uuid": "f6a7b8c9-0d1e-2f3a-4b5c-6d7e8f9a0b1c",
          "variantType": "thumbnail",
          "displayPosition": 1,
          "url": "https://media.fanvue.com/thumb/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.jpg",
          "width": 320,
          "height": 180
        },
        {
          "uuid": "a7b8c9d0-1e2f-3a4b-5c6d-7e8f9a0b1c2d",
          "variantType": "blurred",
          "displayPosition": 2,
          "url": "https://media.fanvue.com/blur/d4e5f6a7-8b9c-0d1e-2f3a-4b5c6d7e8f9a.mp4",
          "width": 1920,
          "height": 1080,
          "lengthMs": 45000
        }
      ]
    },
    {
      "uuid": "b8c9d0e1-2f3a-4b5c-6d7e-8f9a0b1c2d3e",
      "status": "processing"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": true
  }
}

Returns a paginated list of media items for the specified creator.

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

Scopes required: read:creator, read:media

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

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

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:

purchasedBystringOptionalformat: "uuid"

UUID of the user to check media purchases against. When provided, each media item will include a purchasedByFan boolean indicating if that user has purchased it.

statuslist of enumsOptional

Allowed values:

variantslist of enumsOptional

Allowed values:

Response

List of creator media

datalist of objects

Array of media items

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

Authentication

Path parameters

Headers

Query parameters

Response

Errors