Sign in
Stored Free Trial Links

List Stored Free Trial Links

List all stored free trial links from the OnlyFansAPI Cache. This is a free endpoint that does not call the OnlyFans API.

get/api/{account}/stored/trial-links

Query parameters

limitinteger

The number of trial links to return. Default 10

Example:10

The number of trial links to return. Default 10

offsetinteger

The offset used for pagination. Default 0

The offset used for pagination. Default 0

filter[include_smart_links]boolean

Include trial links created by Smart Links. Default false

Include trial links created by Smart Links. Default false

filter[search]string

Search trial link name or URL.

Example:Instagram

Search trial link name or URL.

filter[tags]string

Filter by one or more tag names or slugs. Accepts CSV or repeated array values (filter[tags][]=...) and matches any tag.

Example:instagram,twitter

Filter by one or more tag names or slugs. Accepts CSV or repeated array values (filter[tags][]=...) and matches any tag.

Request body

limitinteger

Must be at least 1. Must not be greater than 1000.

offsetinteger

Must be at least 0.

Example request

{
  "limit": 9,
  "offset": 60,
  "filter": {
    "search": "luxlydchscuxctdemg",
    "tags": [
      "jir"
    ]
  }
}

Response

Success

Example response

{
  "data": {
    "list": [
      {
        "id": 123,
        "trialLinkName": "Trial link name",
        "url": "https://onlyfans.com/username/trial/abc123",
        "subscribeDays": 30,
        "subscribeCounts": 0,
        "claimCounts": 123,
        "clicksCounts": 182,
        "expiredAt": null,
        "createdAt": "2025-01-01T01:01:01+00:00",
        "isFinished": false,
        "tags": [
          "Instagram",
          "Twitter"
        ],
        "revenue": {
          "total": 123,
          "revenuePerSubscriber": 12,
          "spendersCount": 16,
          "calculatedAt": "2025-01-01T01:01:01+00:00",
          "isLoading": false
        },
        "cost": {
          "inputMode": null,
          "inputValue": null,
          "perSub": null,
          "perClick": null,
          "perPromo": null,
          "subscriberSourceCount": 123,
          "clickSourceCount": 182
        },
        "links": {
          "related": {
            "subscribers": "https://app.onlyfansapi.com/api/acct_abc123/trial-links/123/subscribers",
            "spenders": "https://app.onlyfansapi.com/api/acct_abc123/trial-links/123/spenders"
          }
        }
      }
    ],
    "hasMore": true
  },
  "_pagination": {
    "next_page": "https://app.onlyfansapi.com/api/acct_abc123/stored/trial-links?limit=10&offset=10"
  },
  "_meta": {
    "_credits": {
      "used": 0,
      "balance": 115580,
      "note": "Free endpoint"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": 50000,
      "remaining_minute": 997,
      "remaining_day": 49990
    }
  }
}

Changes