FMFansMetric API

Trial Links

FansMetric data

List Trial Links

Lists the account's trial links from the FansMetric database, each with revenue, cost, and tags attached. Same resource and same permission as the OnlyFans-relayed list — this one adds FansMetric attribution and filters, at the cost of scraper-bounded freshness (~2 h). Requires permission api_trial_links_list.

https://public-api.buffmetrics.com
GET/v1/{account_id}/fm/trial-links
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 10, max 25.

  • offsetinteger

    Rows to skip. Default 0.

  • fieldstring

    Sort column. One of create_date (default), expire_date, claims_count, subscribe_counts, subscribe_days, name.

  • sortstring

    desc (default) or asc.

  • searchstring

    Match trial link name or custom name (case-insensitive).

  • tag_idsarray

    Comma-separated tag IDs. Returns trials matching any of them.

  • include_hiddenstring

    Include hidden trials. Default false.

  • start_datestring

    Window start for revenue and claim counts. Absent → all-time.

  • end_datestring

    Window end. Absent → all-time.

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

Response

200
{
"data":{
"list":[
0:{
"id":100000020
"trialLinkName":"1 MONTH FREE TRIAL"
"url":"https://onlyfans.com/creator_XXXXX/trial/XXXXXXXXXXXXXXXXXXXXXXXXX"
"subscribeDays":30
"subscribeCounts":0
"claimCounts":37
"allClaimCounts":45
"isFinished":false
"createdAt":"2026-04-05T17:02:51Z"
"expiredAt":null
"customName":"Instagram bio"
"customSourceUrl":"https://instagram.com/creator_XXXXX"
"note":null
"isHidden":false
"isRevenueShared":false
"lastScannedAt":"2026-08-05T02:11:30Z"
"user":{
"username":"creator_XXXXX"
}
"tags":[
0:{
"id":2
"name":"Instagram"
"color":"#E4405F"
"created_at":"2026-02-04T16:02:10Z"
}
]
"revenue":{
"total":"245.50"
"spendersCount":6
"revenuePerSubscriber":"6.6351"
"conversionToSpender":"0.16216"
}
"cost":{
"perPromo":"20.00"
"perSub":"0.5405"
"profit":"225.50"
"roi":"1127.5"
}
"links":{
"related":{
"subscribers":"/v1/100000001/trial-links/100000020/subscribers"
}
}
}
]
"hasMore":false
"totalCount":1
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

List Trial LinksOF

Next

Get Trial Link