OnlyFans API
Smart Links

List Smart Links

List all Smart Links

GET
/api/smart-links
AuthorizationBearer <token>

Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys

In: header

Query Parameters

limit?integer

The number of Smart Links to return. Default 50

offset?integer

The offset used for pagination. Default 0

name?string

Filter Smart Links by name.

account_ids?string

Comma-separated account prefixed IDs to include.

meta_pixel_ids?string

Comma-separated Meta Pixel IDs to include.

Request Body

application/json

limit?integer

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

offset?integer

Must be at least 0.

name?string|null

Must not be greater than 255 characters.

account_ids?string|null
meta_pixel_ids?string|null

Response Body

application/json

curl -X GET "https://app.onlyfansapi.com/api/smart-links?limit=50&offset=0&name=Instagram&account_ids=acct_abc123%2Cacct_def456&meta_pixel_ids=1%2C2" \  -H "Content-Type: application/json" \  -d '{}'
{
  "data": [
    {
      "id": "01JCZWQJZXQJZXQJZXQJZXQJZX",
      "name": "Instagram Bio Link",
      "link_type": "free_trial",
      "traffic_redirect_url": "https://trk.of-traffic.com/go/01JCZWQJZXQJZXQJZXQJZXQJZX",
      "free_trial_days": 7,
      "clicks_count": 150,
      "conversions_count": 45,
      "subscribers_count": 30,
      "spenders_count": 12,
      "revenue": "1250.00",
      "cost": {
        "inputMode": null,
        "inputValue": null,
        "perSub": null,
        "perClick": null,
        "perPromo": null,
        "subscriberSourceCount": 30,
        "clickSourceCount": 150
      },
      "account": {
        "id": "acct_XXXXXXXX",
        "display_name": "Example Creator",
        "username": "examplecreator"
      },
      "created_at": "2025-01-15T10:30:00+00:00",
      "updated_at": "2025-01-15T10:30:00+00:00"
    },
    {
      "id": "01JCZWQJZXQJZXQJZXQJZXQJZY",
      "name": "Twitter Promo",
      "link_type": "tracking_link",
      "traffic_redirect_url": "https://trk.of-traffic.com/go/01JCZWQJZXQJZXQJZXQJZXQJZY",
      "free_trial_days": null,
      "clicks_count": 320,
      "conversions_count": 89,
      "subscribers_count": 65,
      "spenders_count": 24,
      "revenue": "2450.50",
      "cost": {
        "inputMode": null,
        "inputValue": null,
        "perSub": null,
        "perClick": null,
        "perPromo": null,
        "subscriberSourceCount": 65,
        "clickSourceCount": 320
      },
      "account": {
        "id": "acct_XXXXXXXX",
        "display_name": "Example Creator",
        "username": "examplecreator"
      },
      "created_at": "2025-01-10T08:15:00+00:00",
      "updated_at": "2025-01-10T08:15:00+00:00"
    }
  ],
  "_meta": {
    "_credits": {
      "used": 0,
      "balance": 999999985,
      "note": "Free endpoint"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 10000000,
      "limit_day": 50000,
      "remaining_minute": 9999998,
      "remaining_day": 49988
    }
  }
}