Vault

Lookup Vault Media by Hash

Checks whether the creator already has a vault media item matching the given MD5 hash + size. Returns the existing vault media object when there is a match, 404 otherwise. Call this before requesting signed upload URLs to skip re-uploading a duplicate file. Requires permission api_media_hash_lookup.

https://public-api.buffmetrics.com
GET/v1/{account_id}/vault/media/hash
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

  • h*string

    Lower-case MD5 hex of the file. For multipart files, use MD5(concatenation of part MD5 binaries) + "-" + partCount — the S3 multipart ETag format.

  • size*string

    File size in bytes.

curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/vault/media/hash?h=sample_h&size=sample_size" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"id":1234567890
"type":"photo"
"createdAt":"2026-04-12T08:00:00+00:00"
"isReady":true
"files":{
"full":{
"url":"https://cdn2.onlyfans.com/..."
"width":1080
"height":1920
"size":234567
}
"thumb":{
"url":"..."
"width":300
"height":533
}
}
"duration":0
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}