Skip to main content
GET
Placements
Every story, post, bio line, friend pin and mass message the engine published for your pools, newest first. views sync about hourly. A mass message row carries mass_dm with sent (fans reached; empty while OnlyFans is still sending), viewed, purchased for a paid one and can_unsend. link holds the tracking-link totals, shared by every publication of the creative in the pool. Failed rows carry error.code.

Authorizations

X-API-Key
string
header
required

Your API key from the Studio Dashboard

Query Parameters

page
integer
default:1

Page number, 1-indexed.

Required range: x >= 1
page_size
integer
default:50

Items per page. Default 50, max 100.

Required range: 1 <= x <= 100
pool_id
string<uuid>

One pool.

creative_id
string<uuid>

One creative.

format
enum<string>

Filter by format.

Available options:
story,
post,
bio,
friends,
mass_dm
status
enum<string>

Filter by status.

Available options:
posted,
removed,
failed
host_of_account_id
integer

Publications by one publisher.

Required range: x >= 1
target_of_account_id
integer

Publications promoting one model.

Required range: x >= 1
since
string<date-time>

Publications from this moment on.

since_changed_at
integer

Delta-sync filter. Return only rows whose changed_at is at or after this UNIX timestamp. Pair with until_changed_at for a window.

Required range: x >= 0
until_changed_at
integer

Delta-sync filter. Return only rows whose changed_at is strictly before this UNIX timestamp. Useful to lock the upper bound while paginating an open delta range.

Required range: x >= 0
sort
enum<string>
default:posted_at_desc

Sort order.

Available options:
posted_at_desc,
posted_at_asc,
updated_at_desc

Response

Successful response

success
boolean
Example:

true

data
object[]
pagination
object

Page-based pagination, returned by every list endpoint that isn't a cursor feed.