Post Labels

List Post Labels

Returns every label on the account, each with a strip of preview thumbnails. Labels are OnlyFans's name for what the web app calls collections — named buckets a creator drops posts into to organise their feed, which double as filter chips on their public profile. Use a label's id as the label filter on List Posts. Requires permission api_post_labels_list.

https://public-api.fansmetric.com

GET/v1/{account_id}/post-labels

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.

Response Fields

data.list[].idinteger
Label ID. Pass it as label or exclude_label on List Posts.
data.list[].namestring
The name the creator chose. Often contains emoji, so allow for that in your UI.
data.list[].typestring
custom for labels the creator made.
data.list[].postsCountinteger
How many posts are on the label right now.
data.list[].postsarray
Up to 3 preview thumbnails for the label tile. The URLs are signed and expire.
data.list[].isClearInProgressboolean
true while OnlyFans is still emptying the label in the background. Counts will keep moving until it flips back to false.
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	Label ID. Pass it as `label` or `exclude_label` on List Posts.
data.list[].name	string	The name the creator chose. Often contains emoji, so allow for that in your UI.
data.list[].type	string	`custom` for labels the creator made.
data.list[].postsCount	integer	How many posts are on the label right now.
data.list[].posts	array	Up to 3 preview thumbnails for the label tile. The URLs are signed and expire.
data.list[].isClearInProgress	boolean	`true` while OnlyFans is still emptying the label in the background. Counts will keep moving until it flips back to `false`.
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?limit=20&offset=0" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"list":[0:{"id":9844743
"name":"Behind the scenes"
"type":"custom"
"isClearInProgress":false
"postsCount":5
"posts":[0:{"type":"photo"
"canViewMedia":true
"postId":"2676873092"
"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
}
]
}
]
"order":"asc"
"sort":"custom"
"hasMore":true
"nextOffset":10
"hashSort":"c9113837f826c2b87d503bd5798cb343"
}
"_pagination":{"next_page":"/v1/12345678/post-labels?limit=10&offset=10"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Remove Post Bookmark

List Post Label Filters