Get list of posts

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

get/posts

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/posts
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:post

Query parameters

pageinteger

Page number to retrieve (starts from 1)

sizeinteger

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

includeUnpublished'true' | 'false'

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

startDatestring date-time

Only include posts created on or after this ISO 8601 datetime (e.g., 2024-10-20T00:00:00Z).

endDatestring date-time

Only include posts created before this ISO 8601 datetime (non-inclusive).

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

List of posts

Changes

No recorded changes to this operation across all 8 revisions of this API.