curl --request GET \
--url https://api.fanvue.com/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/posts"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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": []
}
],
"nextCursor": null,
"total": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Get list of posts (cursor-paginated)
Returns a cursor-paginated list of posts created by the authenticated user. Posts are ordered by pinned status first, then by publication date (newest first).
Cursor-paginated: page with the opaque nextCursor from the previous response. Keyset pagination gives constant-cost pages and, unlike the offset-paginated v0 endpoint, does not shift rows when posts are created or deleted mid-walk.
Posts are ordered on mutable columns, so a post that is pinned, unpinned, or published while you are paging can be returned twice. Treat the walk as at-least-once and de-duplicate on uuid.
The cursor carries the filters it was minted under: when cursor is supplied, includeUnpublished, startDate and endDate are ignored and the walk continues over the same set of posts. Change the filters by starting a new walk without a cursor.
curl --request GET \
--url https://api.fanvue.com/v1/posts \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/posts"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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": []
}
],
"nextCursor": null,
"total": null
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}read:post— Read posts, including post details, comments, likes, and tips.
Authorizations
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
API version to use for the request
"2025-06-26"
Query Parameters
Opaque pagination cursor from a previous response's nextCursor
Number of items to return (1-50, default: 15)
1 <= x <= 50Whether to include unpublished posts (drafts and scheduled posts) in the results. Defaults to true.
true, false Only include posts created on or after this ISO 8601 datetime (e.g., 2024-10-20T00:00:00Z).
Only include posts created before this ISO 8601 datetime (non-inclusive).
Response
Cursor-paginated list of posts
Was this page helpful?