FAfanvue

List clicks on a tracking link

Changed on

Every click on the link, newest first, with cursor-based pagination. Unlike the tracking-link users endpoint this includes clicks never matched to an account, which have a null userUuid, so a partner can reconcile click-level data without one request per fan.

Only allowlisted tracking parameters are returned in metadata; see the field description for the list.

Pass the previous response's nextCursor as cursor to fetch the next page; it is null on the last page. A cursor is only valid for the link it was issued for.

get/tracking-links/{uuid}/impressions

Request

  • Base URL
    https://api.fanvue.com
  • URL
    https://api.fanvue.com/tracking-links/{uuid}/impressions
  • Auth
    OAuth 2
    Authorization code: https://auth.fanvue.com/oauth2/auth
    Token URL: https://auth.fanvue.com/oauth2/token scopes: read:tracking_links

Path parameters

uuidstring uuid required

Tracking link UUID

Query parameters

cursorstring

Opaque pagination cursor from a previous response's nextCursor

sizeinteger

Number of items to return (1-50, default: 15)

Headers

X-Fanvue-API-Versionstring required
Example:2025-06-26

API version to use for the request

Response

Clicks on the tracking link

nextCursorstring nullable required

Opaque cursor for the next page, or null when there are no more results

totalnumber nullable required

Total number of items, or null when a count is not computed for this list

Changes