Fans
Get Fan Details by IDs
Batch lookup for fans by OnlyFans user ID. Returns a keyed object mapping each ID to the full fan detail object. Requires permission api_fans_read.
https://public-api.buffmetrics.comGET/v1/{account_id}/fans
Bearer
Authorization
defaultAuthorizationBearer <token>Send your FansMetric API key as a Bearer token in the Authorization header.
In: header
Path Parameters
account_id*integerOnlyFans numeric account ID.
Query Parameters
ids*arrayComma-separated OF user IDs, e.g.
123,456,789.
curl --request GET "https://public-api.buffmetrics.com/v1/acct_XXXXX/fans?ids=sample_ids" \
--header "Authorization: Bearer YOUR_API_KEY"Response
200{
"data":{
"1000000039":{
"id":1000000039
"name":"Fan XX"
"username":"fan_XXXXX"
"avatar":"..."
"subscribedOnData":{
"totalSumm":150
"tipsSumm":50
"duration":"11 months"
"expiredAt":"2026-06-14T00:00:00+00:00"
}
"notice":"VIP customer"
"displayName":"Custom Name"
"lastSeen":"2026-05-18T10:00:00+00:00"
}
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":989
"limit_day":50000
"remaining_day":49989
}
}
}