Get bulk media by UUIDs

Changed on

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

<Note>Maximum 20 media UUIDs per request.</Note>

get/media/bulk

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/media/bulk
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:media

Query parameters

mediaUuidsstring required
variantsstring

Headers

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

API version to use for the request

Response

Bulk media response

resultsobject required

Map media UUID -> media payload (null when unavailable)

Changes

    • breaking

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