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
Bearer

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.

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

Response

200
{
"data":{
"list":[
0:{
"id":9844743
"name":"bg🔥"
"type":"custom"
"isClearInProgress":false
"postsCount":5
"posts":[
0:{
"type":"photo"
"canViewMedia":true
"postId":"2676873092"
"url":"https://cdn2.onlyfans.com/files/..."
}
]
}
]
"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
}
}
}