Skip to main content
GET
/
posts
Get list of posts
curl --request GET \
  --url https://api.example.com/posts \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Fanvue-API-Version: <x-fanvue-api-version>'
{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "createdAt": "2025-01-01T12:00:00.000Z",
      "text": "Check out my latest content!",
      "price": null,
      "audience": "subscribers",
      "publishAt": null,
      "publishedAt": "2025-01-01T12:00:00.000Z",
      "expiresAt": null,
      "mediaUuids": [
        "a1b2c3d4-5e6f-7g8h-9i0j-k1l2m3n4o5p6"
      ],
      "mediaPreviewUuid": null,
      "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,
      "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"
      ],
      "mediaPreviewUuid": "f1e2d3c4-b5a6-4789-8123-456789abcdef",
      "isPinned": false,
      "likesCount": 103,
      "commentsCount": 27,
      "tips": {
        "count": 0,
        "totalGross": 0,
        "totalNet": 0
      },
      "collections": []
    }
  ],
  "pagination": {
    "page": 1,
    "size": 20,
    "hasMore": false
  }
}
Required scope
  • read:post — Read posts, including post details, comments, likes, and tips.

Authorizations

​
Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

​
X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Query Parameters

​
page
number
default:1

Page number to retrieve (starts from 1)

Required range: x >= 1
​
size
number
default:15

Number of items to return per page (1-50, default: 15)

Required range: 1 <= x <= 50
​
includeUnpublished
enum<string>
default:true

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

Available options:
true,
false

Response

List of posts

​
data
object[]
required

Array of posts

​
pagination
object
required

Pagination information