Post Labels

List Post Label Filters

Returns the same labels as List Post Labels, but shaped for a filter bar: no preview thumbnails, and the Archive and Private Archive buckets included. One thing to watch — id is a number for the creator's own labels and a word for the two archive buckets, so check its type before treating it as a number. Requires permission api_post_labels_list_filters.

https://public-api.fansmetric.com

GET/v1/{account_id}/post-labels/filters

API keyBearer

Authorization

default

AuthorizationBearer <token>

Send your FansMetric API key as a Bearer token in the Authorization header.

In: header

Path Parameters

account_id*integer
OnlyFans numeric account ID.

Query Parameters

limitinteger
Page size. Default 10. Min 1, max 100.
offsetinteger
Rows to skip. Default 0.
non_emptyboolean
Leave out labels holding no posts. Default true — send false to include empty ones.

Response Fields

data.list[].idinteger | string
Can be either type. A number for the creator's own labels, and the words archived or private_archived for the two archive buckets. Both work as a label value on List Posts, but check the type before doing arithmetic or using it as a numeric key.
data.list[].namestring
Display name for the filter chip, e.g. Private Archive.
data.list[].typestring
custom, archived, or private_archived.
data.list[].postsCountinteger
How many posts are on the label.
data.hasMoreboolean
Whether another page exists.
data.nextOffsetinteger
Offset to request for the next page.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_pagination.next_pagestring
Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.usedinteger
Credits consumed by this request (currently always 1).
_meta._rate_limits.limit_minuteinteger
Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minuteinteger
Remaining requests in the current minute window.
_meta._rate_limits.limit_dayinteger
Maximum requests per day for the organization.
_meta._rate_limits.remaining_dayinteger
Remaining requests in the current day window.

Field	Type	Description
data.list[].id	integer \| string	Can be either type. A number for the creator's own labels, and the words `archived` or `private_archived` for the two archive buckets. Both work as a `label` value on List Posts, but check the type before doing arithmetic or using it as a numeric key.
data.list[].name	string	Display name for the filter chip, e.g. `Private Archive`.
data.list[].type	string	`custom`, `archived`, or `private_archived`.
data.list[].postsCount	integer	How many posts are on the label.
data.hasMore	boolean	Whether another page exists.
data.nextOffset	integer	Offset to request for the next page.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_pagination.next_page	string	Relative URL for the next page, with the cursor or offset already applied. Append it to the API base URL and send it as-is. Omitted entirely on the last page.
_meta._credits.used	integer	Credits consumed by this request (currently always `1`).
_meta._rate_limits.limit_minute	integer	Maximum requests per minute for the organization.
_meta._rate_limits.remaining_minute	integer	Remaining requests in the current minute window.
_meta._rate_limits.limit_day	integer	Maximum requests per day for the organization.
_meta._rate_limits.remaining_day	integer	Remaining requests in the current day window.

curl --request GET "https://public-api.fansmetric.com/v1/100000001/post-labels/filters?limit=20&offset=0&non_empty=sample_non_empty" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[0:{"id":9844743
"name":"Behind the scenes"
"type":"custom"
"isClearInProgress":false
"postsCount":5
}
1:{"id":"private_archived"
"name":"Private Archive"
"type":"private_archived"
"isClearInProgress":false
"postsCount":77
}
]
"order":"asc"
"sort":"custom"
"hasMore":true
"nextOffset":10
"hashSort":"c9113837f826c2b87d503bd5798cb343"
}
"_pagination":{"next_page":"/v1/12345678/post-labels/filters?limit=10&non_empty=true&offset=10"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Post Labels

Get Post Label