FAfanvue

Get creator's media list

Changed on

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.
get/creators/{creatorUserUuid}/media

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/creators/{creatorUserUuid}/media
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:creator, read:media

Path parameters

creatorUserUuidstring uuid required

Query parameters

pageinteger

Page number to retrieve (starts from 1)

sizeinteger

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

mediaType'image' | 'video' | 'audio' | 'document'
folderNamestring
usage'subscribers' | 'followers' | 'ppv' | 'mass_messages'
namestring

Case-insensitive substring match on the media name.

startDatestring date-time

Filter to media created on or after this ISO 8601 datetime (with optional timezone offset, e.g. 2024-10-20T00:00:00Z).

endDatestring date-time

Filter to media created before this ISO 8601 datetime (non-inclusive, with optional timezone offset).

purchasedBystring 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.

statusMediaStatus[]

Comma-separated list of media status values

variantsMediaVariantType[]

Comma-separated list of media variant types

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

List of creator media

Changes

  • 4d08f36ad6c8Revision changes
    • breaking

      the ///// response's property format changed from uuid to no format for status