Get list of posts | Fanvue API Documentation

import requests
url = "https://api.fanvue.com/posts"
headers = {
    "X-Fanvue-API-Version": "2025-06-26",
    "Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.json())

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-01-01T12:00:00.000Z",
      "text": "Check out my latest content!",
      "price": 1.1,
      "mediaPreviewUuid": "string",
      "audience": "subscribers",
      "publishAt": "2024-01-15T09:30:00Z",
      "publishedAt": "2025-01-01T12:00:00.000Z",
      "expiresAt": "2024-01-15T09:30:00Z",
      "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": "2024-01-15T09:30:00Z",
      "publishedAt": "2024-12-31T18:00:00.000Z",
      "expiresAt": "2024-01-15T09:30:00Z",
      "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

Authentication

Headers

Query parameters

Response

Errors