OnlyFans API
OnlyFansSmart 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. Must be at least 1. Must not be greater than 1000.

offset?integer

The offset used for pagination. Default 0. Must be at least 0.

name?string|null

Filter Smart Links by name. Must not be greater than 255 characters.

account_ids?string|null

Comma-separated account prefixed IDs to include.

pixel_ids?string|null

Comma-separated ad platform Pixel IDs to include.

meta_pixel_ids?string|null

Deprecated alias for pixel_ids. Comma-separated Pixel IDs to include.

filter?object
filter.tags?array<string>

Must not be greater than 50 characters.

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&pixel_ids=1%2C2&meta_pixel_ids=1%2C2&filter=&filter.tags=ossetkjhuotstignjgjlwhbz"
{
  "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
    }
  }
}