OnlyFans API
Chats

List Chat Media (Gallery)

List media files shared in a specific chat.

GET
/api/{account}/chats/{chat_id}/media
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Path Parameters

accountstring

The Account ID

chat_idstring

The ID of the chat to get media from, usually a fan's OnlyFans User ID

Query Parameters

type?string | null

Filter by specific media types. Keep empty to return all.

Value in"photos" | "videos" | "audios"
limit?string

Number of medias to return. Default = 20

offset?string

Number of medias to skip for pagination

skip_users?string

Whether to skip user details in response (all or none). Default = all

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/chats/string/media?type=claims&limit=20&offset=0&skip_users=all"
{
  "data": {
    "list": [
      {
        "responseType": "message",
        "text": "Text message!",
        "giphyId": null,
        "lockedText": true,
        "isFree": true,
        "price": 0,
        "isMediaReady": true,
        "mediaCount": 1,
        "media": [
          {
            "id": 123,
            "type": "photo",
            "convertedToVideo": false,
            "canView": true,
            "hasError": false,
            "createdAt": "2025-01-01T00:00:00+00:00",
            "isReady": true,
            "files": {
              "full": {
                "url": "https://cdn2.onlyfans.com/files/...",
                "width": 2048,
                "height": 1360,
                "size": 0,
                "sources": []
              },
              "thumb": {
                "url": "https://cdn2.onlyfans.com/files/...",
                "width": 300,
                "height": 300,
                "size": 0
              },
              "preview": {
                "url": "https://cdn2.onlyfans.com/files/...",
                "width": 960,
                "height": 638,
                "size": 0
              },
              "squarePreview": {
                "url": "https://cdn2.onlyfans.com/files/...",
                "width": 960,
                "height": 960,
                "size": 0
              }
            },
            "duration": 0,
            "hasCustomPreview": false,
            "videoSources": {
              "240": null,
              "720": null
            }
          }
        ],
        "previews": [],
        "isTip": false,
        "isReportedByMe": false,
        "isCouplePeopleMedia": false,
        "queueId": 123,
        "isMarkdownDisabled": true,
        "releaseForms": [],
        "fromUser": {
          "id": 123,
          "_view": "t"
        },
        "isFromQueue": false,
        "id": 123,
        "isOpened": false,
        "isNew": false,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "changedAt": "2025-01-01T00:00:00+00:00",
        "cancelSeconds": 0,
        "isLiked": false,
        "canPurchase": false,
        "canPurchaseReason": "free",
        "canReport": false,
        "canBePinned": true,
        "isPinned": false
      }
    ],
    "hasMore": false,
    "nextLastId": "123"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999964345,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49985
    }
  }
}