FMFansMetric API

Referrals

List Referred Users

Returns users the creator has referred onto the platform. Toggle only_performers between referred creators (with per-creator earnings) and all referred users (creators + fans). Requires permission api_referrals_list_users.

https://public-api.fansmetric.com
GET/v1/{account_id}/referrals
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

  • start_datestring

    Lower bound on joinDate. Default 2 years ago, UTC.

  • end_datestring

    Upper bound on joinDate. Default end of today, UTC.

  • offsetinteger

    Rows to skip. Page size is set by OnlyFans.

  • only_performersstring

    1 (default) = referred creators only (rows include earnings). 0 = every referred user (creators + fans).

curl --request GET "https://public-api.fansmetric.com/v1/acct_XXXXX/referrals?start_date=sample_start_date&end_date=sample_end_date&offset=0" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"list":[
0:{
"id":540115405
"name":"Kady"
"username":"kadyrivers"
"displayName":""
"isVerified":true
"isActive":true
"subscribePrice":0
"currentSubscribePrice":0
"subscribedBy":true
"subscribedOn":true
"subscribedOnDuration":"4 months"
"subscribedByExpire":false
"subscribedByExpireDate":"2036-01-13T11:09:15+00:00"
"subscribedByAutoprolong":true
"joinDate":"2025-12-18T15:17:18+00:00"
"earnings":4106.273
"canEarn":true
"view":"ref"
"listsStates":[]
}
]
"hasMore":false
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

List Promotion Subscribers

Next

Get Referral Balance