latestOpenAPI 3.1.02026-08-08243131.9 MB

c5ddcd5c7e72

Get user's media list

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.

Each finalised media item includes a `tags` field containing structured AI
content tags (description, tags, NSFW classification, scene/setting, etc.)
when the owning creator has AI content tagging enabled and the media has
been processed. `tags` is `null` otherwise.
get/media

Query parameters

pageinteger

Page number to retrieve (starts from 1)

Page number to retrieve (starts from 1)

sizeinteger

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

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.

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

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

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.

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 user media