We just released our native n8n integration!» Try now
OnlyFans API
Promotions

List Promotions

List all promotions for the account.

GET
/api/{account}/promotions
AuthorizationBearer <token>

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

In: header

Path Parameters

accountstring

The Account ID

Query Parameters

limitinteger

The number of promotions to return. Default 10

offsetinteger

The offset used for pagination. Default 0

Response Body

curl -X GET "https://app.onlyfansapi.com/api/string/promotions?limit=10&offset=0"
{
  "data": {
    "hasMore": false,
    "items": [
      {
        "id": 123,
        "message": "Example promotion message",
        "rawMessage": "Example promotion message",
        "hasRelatedPromo": false,
        "price": 0,
        "type": "all",
        "canClaim": true,
        "claimsCount": 0,
        "subscribeCounts": 10,
        "subscribeDays": 7,
        "createdAt": "2025-01-01T00:00:00+00:00",
        "finishedAt": "2025-01-02T00:00:00+00:00",
        "isFinished": false
      }
    ]
  },
  "_meta": {
    "_credits": {
      "used": 1,
      "balance": 999999823,
      "note": "Always"
    },
    "_cache": {
      "is_cached": false,
      "note": "Cache disabled for this endpoint"
    },
    "_rate_limits": {
      "limit_minute": 1000,
      "limit_day": null,
      "remaining_minute": 999,
      "remaining_day": null,
      "notice": "We have decided to remove our daily rate limits. Please remove any references to these in your integrations."
    }
  }
}