Skip to main content
GET
Get posts for a creator (cursor-paginated)
Required scopes
  • read:post — Read posts, including post details, comments, likes, and tips.
  • read:creator — Access creator profiles, content, and creator-specific information.

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"

Path Parameters

creatorUserUuid
string<uuid>
required

Query Parameters

cursor
string

Opaque pagination cursor from a previous response's nextCursor. It carries the includeUnpublished flag and date range the first page was cut under, so later pages need nothing but the cursor. Resending those filters is allowed while they match it; a value that contradicts the cursor is rejected.

size
number
default:15

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

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

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

Available options:
true,
false
startDate
string<date-time>

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

endDate
string<date-time>

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

Response

Cursor-paginated list of posts for this creator

data
object[]
required

Array of posts, pinned first then most recently published

nextCursor
string | null
required

Opaque cursor for the next page, or null when there are no more results

total
number | null
required

Total number of items, or null when a count is not computed for this list