Bookmarks

List Bookmarks

Returns the creator's Saved for later collection. Saved posts and saved chat messages come back in the same feed, so branch on responseType before rendering a row — saved messages carry chat fields that saved posts do not. Narrow to one kind with entity_type. Requires permission api_bookmarks_list.

https://public-api.fansmetric.com

GET/v1/{account_id}/bookmarks

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

limitinteger
Page size. Default 10. Min 1, max 100.
offsetinteger
Rows to skip. Default 0.
categorystring
Media bucket to return: all (default), photos, videos, audios, other, locked. other holds text-only items; locked holds items whose paywall can no longer be opened.
entity_typestring
What to include: posts, messages, or all (default) for both.
filterstring
Restrict by age: date_last_1_week, date_last_1_month, date_last_3_months. Omit for all time.

Response Fields

data.list[].responseTypestring
post or message. Both kinds are mixed together when entity_type=all, so branch on this before reading the rest of the row.
data.list[].idinteger
Post or message ID, depending on responseType.
data.list[].textstring
Caption or message body, as HTML.
data.list[].priceinteger
Price. Saved messages only.
data.list[].chatUserIdinteger
The fan on the other side of the chat. Saved messages only.
data.list[].fromUserobject
Who sent the message. Saved messages only.
data.list[].isAddedToBookmarksboolean
Always true in this feed — every row here is saved by definition.
data.hasMoreboolean
Whether another page exists.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_pagination.next_pagestring
Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.list[].responseType	string	`post` or `message`. Both kinds are mixed together when `entity_type=all`, so branch on this before reading the rest of the row.
data.list[].id	integer	Post or message ID, depending on `responseType`.
data.list[].text	string	Caption or message body, as HTML.
data.list[].price	integer	Price. Saved messages only.
data.list[].chatUserId	integer	The fan on the other side of the chat. Saved messages only.
data.list[].fromUser	object	Who sent the message. Saved messages only.
data.list[].isAddedToBookmarks	boolean	Always `true` in this feed — every row here is saved by definition.
data.hasMore	boolean	Whether another page exists.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_pagination.next_page	string	Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/bookmarks?limit=20&offset=0&category=sample_category" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[0:{"responseType":"message"
"id":10256279613051
"text":"<p>saved this one for later</p>"
"price":0
"isFree":true
"isOpened":true
"isLiked":false
"isPinned":false
"isAddedToBookmarks":true
"mediaCount":0
"isMediaReady":true
"media":[]
"previews":[]
"createdAt":"2026-07-02T09:14:22+00:00"
"changedAt":"2026-07-02T09:14:22+00:00"
"chatUserId":987654321
"fromUser":{"id":987654321
"_view":"c"
}
"canPurchase":false
"canPurchaseReason":"free"
}
]
"hasMore":false
}
"_pagination":{"next_page":null
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Remove Post from Label

List Bookmark Categories