Trial Links

List Trial Links Stats

Returns the per-trial stats table on OF's Trials tab — claim count, click count, and conversion over the requested window, paginated. Requires permission api_trial_links_list_stats.

https://public-api.fansmetric.com

GET/v1/{account_id}/trial-links/stats

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 100.
offsetinteger
Rows to skip. Default 0.
start_datestring
Window start. YYYY-MM-DD HH:MM:SS UTC. Default: 2 years ago.
end_datestring
Window end. Same format. Default: end of today UTC.

Response Fields

data.items[]array
Per-trial stats rows. Note OF returns items here rather than the more common list.
data.hasMoreboolean
Whether more pages remain.
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.items[]	array	Per-trial stats rows. Note OF returns `items` here rather than the more common `list`.
data.hasMore	boolean	Whether more pages remain.
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/stats?limit=20&offset=0&start_date=2026-01-01%2000%3A00%3A00" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"items":[0:{"trialId":100000020
"trialLinkName":"1 MONTH FREE TRIAL"
"claimsCount":37
"clicksCount":412
}
]
"hasMore":false
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Get Trial Links Overview

List Trial Link SharesFM