GET
/
api
/
{account}
/
posts
List Posts
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/posts \
  --header 'Authorization: Bearer <token>'
{
  "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
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
query
string

Search query to filter posts

Example:

"Hello"

​
limit
integer

Number of posts to return (default = 10)

Example:

10

​
offset
integer

Number of posts to skip for pagination

Example:

0

​
order
enum<string>

Order the returned posts (default = publish_date)

Available options:
publish_date,
favorites_count,
tips_summ
Example:

"publish_date"

​
sort
enum<string>

Sort the returned posts (default = desc)

Available options:
desc,
asc
Example:

"desc"

​
pinned
boolean

Set to true to only show pinned posts

Example:

true

​
counters
boolean

Set to true to include an array of counters (see example responses)

Example:

true

​
minimumPublishDate
string

Filter posts by minimum publish date

Example:

"2025-06-26"

Response

200 - application/json

Success

The response is of type object.