List users for a creator's tracking link
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"handle": "sarah-jones",
"displayName": "Sarah Jones",
"nickname": "SarahK",
"isTopSpender": true,
"avatarUrl": "https://media.fanvue.com/avatars/fan-a.jpg",
"registeredAt": "2024-01-15T00:00:00.000Z",
"subscribedAt": "2023-11-02T00:00:00.000Z",
"currentSubscriptionStartedAt": "2024-01-15T00:00:00.000Z",
"followedAt": null,
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "subscriber"
},
{
"uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"handle": "mike-smith",
"displayName": "Mike Smithly",
"nickname": null,
"isTopSpender": false,
"avatarUrl": null,
"registeredAt": "2024-01-14T00:00:00.000Z",
"subscribedAt": null,
"currentSubscriptionStartedAt": null,
"followedAt": "2024-01-14T00:00:00.000Z",
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "follower"
}
],
"nextCursor": "456"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Creator Tracking Links
List users for a creator's tracking link
List users associated with a tracking link for the specified creator with cursor-based pagination.
Only clicks that could be matched to an account appear here, so this list is a subset of the link’s clicks count. A user who clicked without ever signing in cannot be identified and is omitted.
Users who clicked but never subscribed or followed are included, with status and the conversion dates set to null.
GET
/
v1
/
creators
/
{creatorUserUuid}
/
tracking-links
/
{uuid}
/
users
List users for a creator's tracking link
curl --request GET \
--url https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users"
headers = {
"X-Fanvue-API-Version": "<x-fanvue-api-version>",
"Authorization": "Bearer <token>"
}
response = requests.get(url, headers=headers)
print(response.text)const options = {
method: 'GET',
headers: {
'X-Fanvue-API-Version': '<x-fanvue-api-version>',
Authorization: 'Bearer <token>'
}
};
fetch('https://api.fanvue.com/v1/creators/{creatorUserUuid}/tracking-links/{uuid}/users', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"handle": "sarah-jones",
"displayName": "Sarah Jones",
"nickname": "SarahK",
"isTopSpender": true,
"avatarUrl": "https://media.fanvue.com/avatars/fan-a.jpg",
"registeredAt": "2024-01-15T00:00:00.000Z",
"subscribedAt": "2023-11-02T00:00:00.000Z",
"currentSubscriptionStartedAt": "2024-01-15T00:00:00.000Z",
"followedAt": null,
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "subscriber"
},
{
"uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
"handle": "mike-smith",
"displayName": "Mike Smithly",
"nickname": null,
"isTopSpender": false,
"avatarUrl": null,
"registeredAt": "2024-01-14T00:00:00.000Z",
"subscribedAt": null,
"currentSubscriptionStartedAt": null,
"followedAt": "2024-01-14T00:00:00.000Z",
"clickedAt": "2024-01-14T00:00:00.000Z",
"status": "follower"
}
],
"nextCursor": "456"
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"message": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Required scopes
read:tracking_links— Read tracking links and the users associated with them, including per-user tracking metadata.read:creator— Access creator profiles, content, and creator-specific information.
Authorizations
OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.
Headers
API version to use for the request
Example:
"2025-06-26"
Query Parameters
Number of results to return (default 20)
Cursor for pagination
Was this page helpful?