Vault

Get Vault Media

Returns one vault media item by ID — the same object you see inside List Vault Media. Use it to get fresh media links for an item you already know, without paging the whole vault again. Requires permission api_vault_list_media.

https://public-api.fansmetric.com

GET/v1/{account_id}/vault/media/{media_id}

API keyBearer

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.
media_id*integer
Vault media ID, as returned by List Vault Media.

Query Parameters

refreshstring
Pass any value to skip the cache and ask OnlyFans directly. Use it to renew media links that have expired.

Response Fields

data.idinteger
Vault media ID.
data.typestring
photo, video, gif, or audio.
data.createdAtstring
ISO timestamp when the media was added to the vault.
data.isReadyboolean
true once OnlyFans has finished transcoding the file.
data.countersobject
Lifetime engagement counters across every surface the media has appeared on.
data.filesobject
Per-variant link set: full, thumb, preview, squarePreview. Each url is a FansMetric media link that expires after 2 hours — see Media URLs.
data.durationnumber
Duration in seconds (videos / audio). 0 for photos and GIFs.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.id	integer	Vault media ID.
data.type	string	`photo`, `video`, `gif`, or `audio`.
data.createdAt	string	ISO timestamp when the media was added to the vault.
data.isReady	boolean	`true` once OnlyFans has finished transcoding the file.
data.counters	object	Lifetime engagement counters across every surface the media has appeared on.
data.files	object	Per-variant link set: `full`, `thumb`, `preview`, `squarePreview`. Each `url` is a FansMetric media link that expires after 2 hours — see Media URLs.
data.duration	number	Duration in seconds (videos / audio). `0` for photos and GIFs.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/vault/media/sample_media_id?refresh=sample_refresh" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"id":123456789
"type":"photo"
"createdAt":"2026-05-14T10:30:00+00:00"
"isReady":true
"canView":true
"counters":{"likesCount":12
"tipsSumm":50
}
"files":{"full":{"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
"width":1080
"height":1920
"size":234567
}
"thumb":{"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
"width":300
"height":533
}
}
"duration":0
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Vault Media

List Vault Lists