Fanvue API Documentation

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

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-01-01T12:00:00.000Z",
      "text": "Check out my latest content!",
      "price": null,
      "mediaPreviewUuid": null,
      "audience": "subscribers",
      "publishAt": null,
      "publishedAt": "2025-01-01T12:00:00.000Z",
      "expiresAt": null,
      "mediaUuids": [
        "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
      ],
      "isPinned": true,
      "likesCount": 42,
      "commentsCount": 15,
      "tips": {
        "count": 8,
        "totalGross": 5000,
        "totalNet": 4250
      },
      "collections": [
        {
          "uuid": "d1e2f3a4-b5c6-7890-abcd-ef1234567890",
          "label": "Behind the Scenes"
        }
      ]
    },
    {
      "uuid": "223e4567-e89b-12d3-a456-426614174001",
      "createdAt": "2024-12-31T18:00:00.000Z",
      "text": "Happy New Year everyone!",
      "price": 500,
      "mediaPreviewUuid": "f1e2d3c4-b5a6-4789-8123-456789abcdef",
      "audience": "followers-and-subscribers",
      "publishAt": null,
      "publishedAt": "2024-12-31T18:00:00.000Z",
      "expiresAt": null,
      "mediaUuids": [
        "b2c3d4e5-6f7g-8h9i-0j1k-l2m3n4o5p6q7",
        "c3d4e5f6-7g8h-9i0j-1k2l-m3n4o5p6q7r8"
      ],
      "isPinned": false,
      "likesCount": 103,
      "commentsCount": 27,
      "tips": {
        "count": 0,
        "totalGross": 0,
        "totalNet": 0
      },
      "collections": []
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": false
  }
}

Returns a paginated list of posts created by the authenticated user. Posts are ordered by pinned status first, then by publication date (newest first).

Scope required: read:post

Returns a paginated list of posts created by the authenticated user. Posts are ordered by pinned status first, then by publication date (newest first). <Info>Scope required: `read:post`</Info>

Authentication

AuthorizationBearer

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

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)

includeUnpublishedenumOptionalDefaults to true

Whether to include unpublished posts (drafts and scheduled posts) in the results. Defaults to true.

Allowed values:

Response

List of posts

datalist of objects

Array of posts

paginationobject

Pagination information

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

410

Gone Error

429

Too Many Requests Error