Posts
List Posts
Get posts from your OnlyFans account.
get/api/{account}/posts
Query parameters
querystring
Search query to filter posts
Example:Hello
Search query to filter posts
limitinteger
Number of posts to return (default = 10)
Example:10
Number of posts to return (default = 10)
offsetinteger
Number of posts to skip for pagination
Number of posts to skip for pagination
order'publish_date' | 'favorites_count' | 'tips_summ'
Order the returned posts (default = publish_date)
Example:publish_date
Order the returned posts (default = publish_date)
sort'desc' | 'asc'
Sort the returned posts (default = desc)
Example:desc
Sort the returned posts (default = desc)
pinnedboolean
Set to true to only show pinned posts
Example:true
Set to true to only show pinned posts
countersboolean
Set to true to include an array of counters (see example responses)
Example:true
Set to true to include an array of counters (see example responses)
minimumPublishDatestring
Filter posts by minimum publish date
Example:2025-06-26
Filter posts by minimum publish date
Response
Success
Example response
{
"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
}
}
}