Fanvue API Documentation

curl https://api.fanvue.com/tracking-links \
     -H "X-Fanvue-API-Version: 2025-06-26" \
     -H "Authorization: Bearer <token>"

{
  "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=="
}

List authenticated user’s tracking links with cursor-based pagination.

Scope required: read:tracking_links

List authenticated user's tracking links with cursor-based pagination. <Info>Scope required: `read:tracking_links`</Info>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

limitintegerOptional

Number of results to return (default 20)

cursorstringOptional

Cursor for pagination

createdAfterstringOptionalformat: "date-time"

Filter links created on or after this ISO datetime

createdBeforestringOptionalformat: "date-time"

Filter links created before this ISO datetime

Response

List of tracking links

datalist of objects

nextCursorstring or null

Cursor for next page

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

410

Gone Error

429

Too Many Requests Error

List tracking links

Authentication

Headers

Query parameters

Response

Errors