Fanvue fans · Beta
A Fanvue fan data API for your CRM
Know who you are talking to on Fanvue. Rank an account's fans by lifetime spend, page through active or expired subscribers, and open any fan for their subscription, spend by type, the creator's note and the lists they are on.
# Active subscribers, biggest spenders first
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?status=active&sort=spend&limit=100" \
-H "Authorization: Bearer $BFL_KEY"
# The next page, until there is no nextCursor
curl "https://betterfans.link/v1/accounts/$ACCOUNT_ID/fans?status=active&sort=spend&limit=100&cursor=$NEXT_CURSOR" \
-H "Authorization: Bearer $BFL_KEY"Fanvue fan data
What your CRM can read about Fanvue fans
Search and rank
Find fans by username or name, filter active or expired subscriptions and sort by spend, last message or newest subscription.
Subscriptions
Status, start date and whether it renews, for every fan. The price, and the end date of an expired subscription, come on Get fan and in lists sorted by newest subscription.
Lifetime spend
What each fan paid, from Fanvue's own totals, split into subscriptions, tips, messages, posts and other, with net estimated at the usual 80 percent creator share.
Fan lists
The creator's custom lists and Fanvue's smart lists, with their sizes. Add a fan to a custom list or take them off with an action.
Notes
The private note the creator keeps on a fan, on every read.
Online fans
The fans Fanvue shows online right now, with what each one has spent.
FAQ
Frequently asked questions
Can I export Fanvue subscribers through an API?
Yes. GET /v1/accounts/{accountId}/fans pages through a Fanvue account's fans, active, expired or all, up to 100 at a time with a cursor. Each page is read live from Fanvue and counts as one live call.
Can I add Fanvue fans to a list through the API?
Yes, to the creator's custom lists. Create an add_fan_to_list or remove_fan_from_list action with the fan id and the list id. Fanvue's smart lists fill themselves, so they cannot be changed.
Can I see which Fanvue fans are online?
Yes. GET /v1/accounts/{accountId}/online-fans asks Fanvue who is online now, among the account's most recently active chats. Fanvue does not say when a fan came online, so since is null.
Does the API read the notes a creator keeps on a Fanvue fan?
Yes. Get fan returns the creator's private note on a Fanvue fan in notes, on every read. Treat it as private to your team.
Related
Related features
GET STARTED
Build it in test mode today.
Sign up, make a test key and work against sandbox creators. Link a real account when your flow is ready.
Questions first? Write to hello@betterfans.link.