List tracking links
curl --request GET \
--url https://api.fanvue.com/v1/tracking-links \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/tracking-links"
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/tracking-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "d4e5f6g7-8h9i-0j1k-2l3m-n4o5p6q7r8s9",
"name": "TikTok Profile",
"linkUrl": "fv-123456",
"externalSocialPlatform": "tiktok",
"createdAt": "2024-01-15T00:00:00.000Z",
"clicks": 342,
"engagement": {
"acquiredSubscribers": 28,
"acquiredFollowers": 15,
"totalSubscribers": 35,
"totalFollowers": 20
},
"earnings": {
"totalGross": 150000,
"totalNet": 120000
}
},
{
"uuid": "e5f6g7h8-9i0j-1k2l-3m4n-o5p6q7r8s9t0",
"name": "Instagram Bio",
"linkUrl": "fv-789012",
"externalSocialPlatform": "instagram",
"createdAt": "2024-01-14T00:00:00.000Z",
"clicks": 156,
"engagement": {
"acquiredSubscribers": 12,
"acquiredFollowers": 8,
"totalSubscribers": 18,
"totalFollowers": 12
},
"earnings": {
"totalGross": 75000,
"totalNet": 60000
}
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI0LTAxLTE0VDAwOjAwOjAwLjAwMFoifQ=="
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Tracking links
List tracking links
List authenticated user’s tracking links with cursor-based pagination.
GET
/
v1
/
tracking-links
List tracking links
curl --request GET \
--url https://api.fanvue.com/v1/tracking-links \
--header 'Authorization: Bearer <token>' \
--header 'X-Fanvue-API-Version: <x-fanvue-api-version>'import requests
url = "https://api.fanvue.com/v1/tracking-links"
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/tracking-links', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"data": [
{
"uuid": "d4e5f6g7-8h9i-0j1k-2l3m-n4o5p6q7r8s9",
"name": "TikTok Profile",
"linkUrl": "fv-123456",
"externalSocialPlatform": "tiktok",
"createdAt": "2024-01-15T00:00:00.000Z",
"clicks": 342,
"engagement": {
"acquiredSubscribers": 28,
"acquiredFollowers": 15,
"totalSubscribers": 35,
"totalFollowers": 20
},
"earnings": {
"totalGross": 150000,
"totalNet": 120000
}
},
{
"uuid": "e5f6g7h8-9i0j-1k2l-3m4n-o5p6q7r8s9t0",
"name": "Instagram Bio",
"linkUrl": "fv-789012",
"externalSocialPlatform": "instagram",
"createdAt": "2024-01-14T00:00:00.000Z",
"clicks": 156,
"engagement": {
"acquiredSubscribers": 12,
"acquiredFollowers": 8,
"totalSubscribers": 18,
"totalFollowers": 12
},
"earnings": {
"totalGross": 75000,
"totalNet": 60000
}
}
],
"nextCursor": "eyJjcmVhdGVkQXQiOiIyMDI0LTAxLTE0VDAwOjAwOjAwLjAwMFoifQ=="
}{
"error": "<string>",
"message": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}{
"error": "<string>",
"message": "<string>",
"nextVersion": "<string>"
}{
"error": "<string>"
}Required scope
read:tracking_links— Read tracking links and the users associated with them, including per-user tracking metadata.
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
Filter links created on or after this ISO datetime
Filter links created before this ISO datetime
Was this page helpful?