Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440001",
      "text": "Great content! Thanks for sharing!",
      "user": {
        "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "handle": "sarah",
        "displayName": "Sarah Johnson",
        "nickname": null,
        "isTopSpender": true
      },
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440002",
      "text": "Love this post!",
      "user": {
        "uuid": "b2c3d4e5-f678-90ab-cdef-123456789012",
        "handle": "mike",
        "displayName": "Mike Smith",
        "nickname": null,
        "isTopSpender": false
      },
      "createdAt": "2024-01-15T09:15:00.000Z",
      "updatedAt": "2024-01-15T09:15:00.000Z"
    },
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440003",
      "text": "[Comment from deleted user]",
      "user": null,
      "createdAt": "2024-01-14T18:00:00.000Z",
      "updatedAt": "2024-01-14T18:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "size": 2,
    "hasMore": false
  }
}

Returns a paginated list of comments on a specific post on behalf of a creator. The creator must own the post.

Scopes required: read:post, read:creator

Returns a paginated list of comments on a specific post on behalf of a creator. The creator must own the post. <Info>Scopes required: `read:post`, `read:creator`</Info>

Authentication

AuthorizationBearer

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

Path parameters

creatorUserUuidstringRequiredformat: "uuid"

uuidstringRequiredformat: "uuid"

UUID of the post to retrieve comments for

Headers

X-Fanvue-API-VersionstringRequiredDefaults to 2025-06-26

API version to use for the request

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)

Response

List of comments on this post

datalist of objects

Array of comments on this post

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

410

Gone Error

429

Too Many Requests Error