---
title: "List Profile Posts"
method: GET
path: "/api/{account}/users/{user_id}/posts"
tags: ["Profile Content"]
---

# List Profile Posts

`GET /api/{account}/users/{user_id}/posts`

## Request

- Base URL: `https://app.onlyfansapi.com`
- URL: `https://app.onlyfansapi.com/api/{account}/users/{user_id}/posts`
- Auth: HTTP bearer

Retrieve posts from another user's profile using your connected account's access. Follow _pagination.next_page for more results. Publication-date descending order uses a precise timestamp cursor; other ordering or an explicit offset uses offset pagination. Subscription and purchase requirements still apply.

## Query parameters

- `limit` integer: Number of posts, from 1 to 100. Default: 10.
- `offset` integer: Number of posts to skip. Use beforePublishTime for publication-time cursor pagination.
- `order` 'publish_date' | 'favorites_count' | 'tips_summ': Order posts by this field. Default: publish_date.
- `sort` 'desc' | 'asc': Sort direction. Default: desc.
- `beforePublishTime` string: Publication timestamp cursor for older posts. Preserve decimal precision.
- `query` string: Search posts by text.
- `pinned` boolean: Set to true to request pinned posts.
- `counters` boolean: Include post counters. Default: false.
- `minimumPublishDate` string: Only include posts after this date.

## Response `200`

Anonymized captured response with another page available

- object
  - `data` object
    - `list` object[]
      - `author` object
        - `id` integer
        - `_view` string
      - `responseType` string
      - `id` integer
      - `postedAt` string
      - `postedAtPrecise` string
      - `text` string
      - `isMarkdownDisabled` boolean
      - `canReport` boolean
      - `canComment` boolean
      - `favoritesCount` integer
      - `mediaCount` integer
      - `isMediaReady` boolean
      - `isOpened` boolean
      - `canToggleFavorite` boolean
      - `commentsCount` integer
      - `tipsAmount` string
      - `media` object[]
        - `id` integer
        - `type` string
        - `convertedToVideo` boolean
        - `canView` boolean
        - `hasError` boolean
        - `createdAt` string, nullable
        - `isReady` boolean
        - `files` object
          - `full` object
            - `url` string
            - `width` integer
            - `height` integer
            - `size` integer
            - `sources` unknown[]
              - …
          - `thumb` object
            - `url` string
            - `width` integer
            - `height` integer
            - `size` integer
          - `preview` object
            - `url` string
            - `width` integer
            - `height` integer
            - `size` integer
          - `squarePreview` object
            - `url` string
            - `width` integer
            - `height` integer
            - `size` integer
        - `duration` integer
        - `hasCustomPreview` boolean
        - `videoSources` object
          - `240` string, nullable
          - `720` string, nullable
      - `canViewMedia` boolean
    - `hasMore` boolean
    - `headMarker` string
    - `tailMarker` string
    - `counters` object
      - `audiosCount` integer
      - `photosCount` integer
      - `videosCount` integer
      - `mediasCount` integer
      - `postsCount` integer
      - `streamsCount` integer
      - `archivedPostsCount` integer
  - `_pagination` object
    - `next_page` string
  - `_meta` object
    - `_credits` object
      - `used` integer
      - `balance` integer
      - `note` string
    - `_cache` object
      - `is_cached` boolean
      - `note` string
    - `_rate_limits` object
      - `limit_minute` integer
      - `limit_day` string, nullable
      - `remaining_minute` integer
      - `remaining_day` string, nullable
      - `notice` string

## Changes

- **2026-10-17** `b3968f1bc1f0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/changes/api/:account/users/:user_id/posts/get.md)

---

[API](https://skmtc.dev/onlyfansapi/apis/onlyfans-api.md) - [All operations](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onlyfansapi/apis/onlyfans-api/revisions/122c36386896?raw)