---
title: "Get posts for a creator"
method: GET
path: "/creators/{creatorUserUuid}/posts"
---

# Get posts for a creator

`GET /creators/{creatorUserUuid}/posts`

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

## Path parameters

- `creatorUserUuid` string, uuid, required

## Query parameters

- `page` integer — Page number to retrieve (starts from 1)
- `size` integer — 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.
- `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).

## Headers

- `X-Fanvue-API-Version` string, required

## Response `200`

List of posts for this creator

- object
  - `data` object[], required — Array of posts
    - `uuid` string, uuid, required — Unique identifier of the post
    - `createdAt` string, date-time, required — Date/time when the post was created (ISO 8601 format)
    - `text` string, nullable, required — Text content of the post
    - `price` number, nullable, required — Price in cents for paid posts
    - `mediaPreviewUuid` string, uuid, nullable, required — UUID of free preview media
    - `audience` 'subscribers' | 'followers-and-subscribers', required — Audience that can view the post
    - `publishAt` string, date-time, nullable, required — Future date/time when the post will be published (ISO 8601 format)
    - `publishedAt` string, date-time, nullable, required — Date/time when the post was published (ISO 8601 format)
    - `expiresAt` string, date-time, nullable, required — Date/time when the post expires (ISO 8601 format)
    - `mediaUuids` string[], required — Array of media UUIDs attached to the post
    - `isPinned` boolean, required — Whether the post is pinned to the top of the feed
    - `likesCount` number, required — Number of likes the post has received
    - `commentsCount` number, required — Number of comments on the post
    - `tips` object, required — Tips statistics for this post
      - `count` number, required — Number of paid tips received on this post
      - `totalGross` number, required — Total gross amount of paid tips in cents
      - `totalNet` number, required — Total net amount of paid tips in cents (after platform fees)
    - `collections` object[], required — Content collections this post belongs to
      - `uuid` string, uuid, required — Unique identifier of the collection
      - `label` string, required — Display name of the collection
  - `pagination` object, required — Pagination information
    - `page` number, required — Current page number
    - `size` number, required — Number of records returned in this response
    - `hasMore` boolean, required — Whether there are more items available on subsequent pages

## Other responses

- `400` — Bad Request - API version not supported OR validation failed OR invalid UUID
- `401` — Unauthorized Response
- `403` — Unauthorized Response
- `404` — Not Found Response
- `410` — API version no longer supported (sunset)
- `429` — Too many requests - rate limit exceeded

---

[API](https://skmtc.net/fanvue/apis/fanvue-api.md) · [All operations](https://skmtc.net/fanvue/apis/fanvue-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fanvue/fanvue-api/revisions/c5ddcd5c7e72/schema)