Bookmarks

List Bookmark Categories

Returns the creator's saved-item categories, plus an all summary with total saved post and message counts and a preview strip — enough to build category tabs without fetching each bucket. An empty list alongside a non-zero count is normal: it means items are saved but no custom categories exist. Requires permission api_bookmarks_list_categories.

https://public-api.fansmetric.com

GET/v1/{account_id}/bookmarks/categories

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.

Response Fields

data.listarray
Categories the creator has made. Empty when they have not made any — that is not an error.
data.all.postCountinteger
Total saved posts across the whole collection.
data.all.messageCountinteger
Total saved chat messages across the whole collection.
data.all.postsarray
Preview strip across the whole collection, for an "All" tab thumbnail.
data.hasMoreboolean
Whether another page of categories exists.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_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	array	Categories the creator has made. Empty when they have not made any — that is not an error.
data.all.postCount	integer	Total saved posts across the whole collection.
data.all.messageCount	integer	Total saved chat messages across the whole collection.
data.all.posts	array	Preview strip across the whole collection, for an "All" tab thumbnail.
data.hasMore	boolean	Whether another page of categories exists.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_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/categories?limit=20&offset=0" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[]
"hasMore":false
"order":"asc"
"sort":"recent"
"all":{"postCount":0
"messageCount":5
"posts":[0:{"type":"text"
"canViewMedia":true
"postId":"10256279613051"
}
1:{"type":"text"
"canViewMedia":true
"postId":"10260665407480"
}
]
}
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Bookmarks

List Vault Media