Posts
List Posts
Get posts from your OnlyFans account.
AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
accountstring
The Account ID
Query Parameters
query?string
Search query to filter posts
limit?integer
Number of posts to return (default = 10)
offset?integer
Number of posts to skip for pagination
order?string
Order the returned posts (default = publish_date)
Value in
"publish_date" | "favorites_count" | "tips_summ"sort?string
Sort the returned posts (default = desc)
Value in
"desc" | "asc"pinned?boolean
Set to true to only show pinned posts
counters?boolean
Set to true to include an array of counters (see example responses)
minimumPublishDate?string
Filter posts by minimum publish date
Response Body
curl -X GET "https://app.onlyfansapi.com/api/string/posts?query=Hello&limit=10&offset=0&order=publish_date&sort=desc&pinned=true&counters=true&minimumPublishDate=2025-06-26"{
"data": {
"list": [
{
"author": {
"id": 123,
"_view": "a"
},
"responseType": "post",
"id": 123,
"postedAt": "2025-01-01T01:01:01+00:00",
"postedAtPrecise": "1234567890.000000",
"text": "<p>Text</p>",
"isMarkdownDisabled": true,
"canDelete": true,
"canComment": true,
"canEdit": true,
"isMediaReady": true,
"isOpened": true,
"canToggleFavorite": true,
"tipsAmount": "$0",
"rawText": "Text",
"canViewMedia": true
}
],
"hasMore": false,
"headMarker": "1234567890.000000",
"tailMarker": "1234567890.000000",
"counters": {
"audiosCount": 123,
"photosCount": 123,
"videosCount": 123,
"mediasCount": 123,
"postsCount": 123,
"streamsCount": 123,
"archivedPostsCount": 123,
"privateArchivedPostsCount": 123
}
},
"_meta": {
"_credits": {
"used": 1,
"balance": 999999886,
"note": "Always"
},
"_cache": {
"is_cached": false,
"note": "Cache disabled for this endpoint"
},
"_rate_limits": {
"limit_minute": 1000,
"limit_day": 50000,
"remaining_minute": 998,
"remaining_day": 49896
}
}
}