FMFansMetric API

Vault

List Vault Media

Returns media items stored in the creator's vault — the personal library used to compose posts, stories, and chat messages. Includes uploaded photos, videos, GIFs, and audio along with engagement counters and per-item state across the post/story/message/stream/uploads lists. Requires permission api_vault_list_media.

https://public-api.fansmetric.com
GET/v1/{account_id}/vault/media
Bearer

Authorization

default
AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

  • account_id*integer

    OnlyFans numeric account ID.

Query Parameters

  • limitinteger

    Page size. Default 24. Min 1, max 100.

  • offsetinteger

    Rows to skip. Default 0.

  • fieldstring

    Sort key. One of recent, most-liked, highest-tips. Default recent.

  • sortstring

    Sort direction. desc (default) or asc.

  • liststring

    Restrict to a vault list (category). Use all (default) for everything, or pass a list id from [List Vault Lists](/api-reference/vault/list-vault-lists).

  • typestring

    Filter by media type: photo, gif, video, audio. Omit for all.

  • querystring

    Text search across media metadata.

  • before_publish_datestring

    ISO timestamp; only return media added before this date. Useful for backfilling.

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/vault/media?limit=20&offset=0&field=sample_field" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":123456789
"type":"photo"
"createdAt":"2026-05-14T10:30:00+00:00"
"isReady":true
"canView":true
"hasError":false
"counters":{
"likesCount":12
"tipsSumm":50
}
"files":{
"full":{
"url":"https://cdn2.onlyfans.com/files/..."
"width":1080
"height":1920
"size":234567
}
"thumb":{
"url":"..."
"width":300
"height":533
}
"preview":{
"url":"..."
"width":1080
"height":1920
}
"squarePreview":{
"url":"..."
"width":600
"height":600
}
}
"duration":0
"hasPosts":true
"listStates":[
0:{
"id":1
"type":"posts"
"name":"Posts"
"hasMedia":true
"canAddMedia":false
}
1:{
"id":2
"type":"stories"
"name":"Stories"
"hasMedia":false
"canAddMedia":true
}
2:{
"id":3
"type":"messages"
"name":"Messages"
"hasMedia":false
"canAddMedia":true
}
]
}
]
"hasMore":true
}
"_pagination":{
"next_page":"/v1/12345678/vault/media?limit=24&offset=24"
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Delete Post

Next

List Vault Lists