List Trial Links

Relays the creator's trial links live from OnlyFans — the same payload OF's webapp renders on its Trials tab, wrapped in the FansMetric envelope. For revenue, cost, tags and the search / tag_ids / visibility / status filters, call the FansMetric-backed list instead. Requires permission api_trial_links_list.

https://public-api.fansmetric.com

GET/v1/{account_id}/trial-links

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.

Query Parameters

limitinteger
Page size. Default 10. Min 1, max 200 (values above 200 are clamped).
offsetinteger
Rows to skip. Default 0.
fieldstring
Sort column. One of create_date (default — note the missing d, this matches OF), expire_date, claims_count, clicks_count, subscribe_counts, subscribe_days, shared.
sortstring
desc (default) or asc.

Response Fields

data.list[].idinteger
OnlyFans trial link ID.
data.list[].trialLinkNamestring
Trial link name on OnlyFans.
data.list[].urlstring
Full ready-to-share trial link URL.
data.list[].subscribeDaysinteger
Trial duration in days.
data.list[].subscribeCountsinteger
Subscriber limit (0 = unlimited).
data.list[].claimCountsinteger
All-time claim count.
data.list[].clicksCountsinteger
All-time click count.
data.list[].isFinishedboolean
Whether the trial has expired or been deleted.
data.list[].createdAtstring
Creation timestamp (RFC 3339).
data.list[].expiredAtstring | null
Expiration timestamp (RFC 3339). null if no expiry.
data.list[].userobject
OF user object for the owning creator.
data.list[].sharedWitharray
Other creators this trial has been shared with (may be empty).
data.hasMoreboolean
Whether more pages remain.
_pagination.next_pagestring
Relative URL preserving query params with offset bumped. Omitted on the last page.
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.list[].id	integer	OnlyFans trial link ID.
data.list[].trialLinkName	string	Trial link name on OnlyFans.
data.list[].url	string	Full ready-to-share trial link URL.
data.list[].subscribeDays	integer	Trial duration in days.
data.list[].subscribeCounts	integer	Subscriber limit (0 = unlimited).
data.list[].claimCounts	integer	All-time claim count.
data.list[].clicksCounts	integer	All-time click count.
data.list[].isFinished	boolean	Whether the trial has expired or been deleted.
data.list[].createdAt	string	Creation timestamp (RFC 3339).
data.list[].expiredAt	string \| null	Expiration timestamp (RFC 3339). `null` if no expiry.
data.list[].user	object	OF user object for the owning creator.
data.list[].sharedWith	array	Other creators this trial has been shared with (may be empty).
data.hasMore	boolean	Whether more pages remain.
_pagination.next_page	string	Relative URL preserving query params with `offset` bumped. Omitted on the last page.
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/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
"clicksCounts":412
"isFinished":false
"createdAt":"2026-04-05T17:02:51Z"
"expiredAt":null
"user":{"id":100000001
"username":"creator_XXXXX"
}
"sharedWith":[]
}
]
"hasMore":false
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Shared Tracking Links

List Trial LinksFM