Get media from a creator's chat | Fanvue API Documentation

curl https://api.fanvue.com/creators/creatorUserUuid/chats/userUuid/media \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "data": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "messageUuid": "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6",
      "mediaType": "image",
      "created_at": "2024-01-15T00:00:00.000Z",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "ownerUuid": "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8",
      "name": "Beach Sunset",
      "variants": [
        {
          "variantType": "main",
          "displayPosition": 0,
          "width": 1920,
          "height": 1440,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/main/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        },
        {
          "variantType": "thumbnail_gallery",
          "displayPosition": 0,
          "width": 400,
          "height": 300,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/gallery/a1b2c3d4-e5f6-7890-abcd-ef1234567890.jpg"
        }
      ]
    },
    {
      "uuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "messageUuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "mediaType": "video",
      "created_at": "2024-01-14T00:00:00.000Z",
      "sentAt": "2024-01-15T00:00:00.000Z",
      "ownerUuid": "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
      "name": "Cooking Tutorial",
      "variants": [
        {
          "variantType": "main",
          "displayPosition": 0,
          "width": 1920,
          "height": 1080,
          "lengthMs": 45000,
          "url": "https://media.fanvue.com/main/b2c3d4e5-f6a7-8901-bcde-f12345678901.mp4"
        },
        {
          "variantType": "thumbnail",
          "displayPosition": 0,
          "width": 1920,
          "height": 1080,
          "lengthMs": 1.1,
          "url": "https://media.fanvue.com/thumb/b2c3d4e5-f6a7-8901-bcde-f12345678901.jpg"
        }
      ]
    }
  ],
  "nextCursor": "eyJzZW50QmVmb3JlIjoiMjAyNC0wMS0wOVQxMjowMDowMC4wMDBaIiwicmVjZWl2ZWRCZWZvcmUiOiIyMDI0LTAxLTA5VDExOjU4OjAwLjAwMFoifQ=="
}

Returns a cursor-paginated list of media items shared between the specified creator and user. Media is extracted from chat messages and ordered by date (newest first).

Pagination Flow:

First request: Omit the cursor parameter, returns first 20 media items (or specified limit)
Subsequent requests: Use the nextCursor from the previous response
End of results: nextCursor will be null

1 {
2   "data": [...media items...],
3   "nextCursor": "..." // Pass this to the next request to get the following page
4 }

Scopes required: read:creator, read:chat

Returns a cursor-paginated list of media items shared between the specified creator and user. Media is extracted from chat messages and ordered by date (newest first). **Pagination Flow:** - First request: Omit the `cursor` parameter, returns first 20 media items (or specified limit) - Subsequent requests: Use the `nextCursor` from the previous response - End of results: `nextCursor` will be `null` ```json { "data": [...media items...], "nextCursor": "..." // Pass this to the next request to get the following page } ``` <Info>Scopes required: `read:creator`, `read:chat`</Info>

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

userUuidstringRequiredformat: "uuid"

Query parameters

cursorstringOptional

Cursor for fetching the next page of media

mediaTypeenumOptional

Filter by media type (image, video, audio, document)

Allowed values:

limitdoubleOptional1-50Defaults to 20

Number of media items to return (1-50, default: 20)

Response

Cursor-paginated list of media items

datalist of objects

nextCursorstring or null

Cursor for fetching the next page, null if no more results

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

1	{
2	"data": [...media items...],
3	"nextCursor": "..." // Pass this to the next request to get the following page
4	}