GET /v1/creators/{creatorId}/ai-content (ai:read); build it with the calls in Build the AI content ladder (ai:write).
The building blocks
Levels and prices
Every level has apriceCents:
priceCentsgreater than 0 is a floor: the AI may sell the level for more, never for less.1200means at least $12.00. The price also stays inside OnlyFans’ own limits for paid messages on that account; a floor below OnlyFans’ minimum is raised to it.priceCents: 0makes a free level (free: true). Everything on it is sent free, as preview, and the AI uses it as a gift rather than a sale.
Preview versus paid media
Each media item on a level has a role:
On a free level every item is a preview. Adding media to a free level always stores it as preview.
Free opener and free aftercare
Two free levels are common in a sequential ladder:- A free opener as level 1: a small free gift that starts the ladder and makes the first paid offer feel natural.
- A free aftercare level as the last level: a warm thank-you after the fan bought the top level, which closes the ladder kindly instead of pushing for more.
Ladder modes: sequential or standard
Reorder levels with
PUT .../collections/{collectionId}/order. In a sequential ladder that changes the climb for every fan.
How the AI decides what to offer
When a conversation reaches a moment to sell, the AI:- Considers only active ladders and active levels that are available in paid messages (
availableInPaidMessages: true). - Skips what this fan already bought.
- In a sequential ladder, looks only at the next unbought level; in a standard ladder, at all of them.
- Picks what fits the conversation, using the level’s
tags(matched against what the fan talks about), itsdescription, itshighlight(a one-line hook it can lead with), and the ladder’sdescription. - Sends the preview media free and the paid media locked, at or above the floor price, in the creator’s voice.
Level stats
Each level reportsstats for sales the AI made:
These count the AI’s own offers only; sales your team made by hand are not included.
Vault coverage
The board also reportsvault: {total, assigned, unassigned}: how many items the creator’s vault holds, how many are placed on a level, and how many are not. A large unassigned count is content the AI cannot sell yet.
The board in one response
GET /v1/creators/{creatorId}/ai-content returns the whole board, and every write returns the updated board, so you never have to stitch pieces together.
ContentBoard (shortened)
Rules the API enforces
- Media ids are the vault ids from
GET /v1/creators/{creatorId}/media(strings of digits). Items from an OnlyX media library appear asox:ids. - One item lives on one level. Adding an item to a level moves it from wherever it was.
- A
folderIdmust belong to the same creator, or you get404. - Deleting a folder keeps its ladders (they become unfiled). Deleting a ladder deletes its levels and their media placements. Deleting a level renumbers the ones after it.
- Nothing in AI content is published to OnlyFans. Only the AI’s offers in chats reach fans.
- Creates answer
201, every other write200, always with the whole board. Content writes are limited to 60 per minute per credential.
Related
- Build the AI content ladder: every call, step by step.
- Vault media: find media ids and thumbnails.
- AI persona:
contentMenuandcontentNotesdescribe her content in words.