Skip to main content
GET
/
api
/
{account}
/
tracking-links
List Tracking Links
curl --request GET \
  --url https://app.onlyfansapi.com/api/{account}/tracking-links \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "list": [
      {
        "id": 1521764,
        "campaignCode": 68,
        "campaignName": "Example Campaign - IG Bio SFS",
        "campaignUrl": "https://onlyfans.com/USERNAME/c68",
        "subscribersCount": 0,
        "clicksCount": 0,
        "createdAt": "2025-02-04T12:44:54+00:00",
        "endDate": null,
        "revenue": {
          "total": 0,
          "revenuePerSubscriber": 0,
          "revenuePerClick": 0,
          "calculatedAt": "2025-02-10T12:45:03+00:00",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXX/tracking-links/1521764/subscribers"
          }
        }
      },
      {
        "id": 1485830,
        "campaignCode": 67,
        "campaignName": "Example Campaign - Reddit",
        "campaignUrl": "https://onlyfans.com/USERNAME/c67",
        "subscribersCount": 8,
        "clicksCount": 298,
        "createdAt": "2025-01-19T20:53:39+00:00",
        "endDate": null,
        "revenue": {
          "total": 103.92,
          "revenuePerSubscriber": 12.99,
          "revenuePerClick": 0.3487248322,
          "calculatedAt": "2025-02-10T12:45:03+00:00",
          "isLoading": false
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXX/tracking-links/1485830/subscribers"
          }
        }
      },
      {
        "id": 1478101,
        "campaignCode": 66,
        "campaignName": "Example Campaign - Revenue isn't calculated yet",
        "campaignUrl": "https://onlyfans.com/USERNAME/c66",
        "subscribersCount": 1,
        "clicksCount": 28,
        "createdAt": "2025-01-15T20:19:43+00:00",
        "endDate": null,
        "revenue": {
          "total": null,
          "revenuePerSubscriber": null,
          "revenuePerClick": null,
          "calculatedAt": null,
          "isLoading": true
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_XXXXXXX/tracking-links/1478101/subscribers"
          }
        }
      }
    ],
    "hasMore": true
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_XXXXXXXXXXX/tracking-links?offset=3&limit=3"
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 9529,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 999,
      "remaining_day": 49999
    }
  }
}

Authorizations

​
Authorization
string
header
required

You can retrieve your token by visiting the OnlyFansAPI Console and clicking API Keys -> Create API Key.

Path Parameters

​
account
string
required

The Account ID

Query Parameters

​
startDate
string | null

The start date for Tracking Links. Keep empty to get all.

Example:

"2025-01-01 00:00:00, -30days"

​
endDate
string | null

The end date for Tracking Links. Keep empty to get all.

Example:

"2025-01-01 00:00:00, now"

​
with_deleted
boolean | null

Whether or not to include deleted tracking links in the response. Default false

Example:

false

​
sortby
enum<string> | null

Sort by subscriber count (claims), or creation date

Available options:
claims,
created_date
Example:

"claims"

​
sort
enum<string> | null

Sort the results. Default desc

Available options:
desc,
asc
Example:

"desc"

​
limit
integer | null

The number of tracking links to return. Default 3

Example:

3

​
offset
integer | null

The offset used for pagination. Default 0

Example:

0

​
synchronous
boolean | null

Wait for the revenue data to finish processing, instead of processing in the background. Will result in longer response times, use with caution. Default false

Example:

false

Response

200 - application/json

Success

​
data
object
​
_pagination
object
​
_meta
object