Post Labels

Get Post Label

Returns one label with its post count and a short strip of preview thumbnails. The strip is a preview, not the full membership — to page through everything on a label, use List Posts with label={label_id}. Requires permission api_post_labels_read.

https://public-api.fansmetric.com

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

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.
label_id*integer
The label ID. Numeric — only the creator's own labels can be fetched here, not the archive buckets.

Response Fields

data.idinteger
Label ID.
data.namestring
The name the creator chose.
data.typestring
custom for labels the creator made.
data.postsCountinteger
How many posts are on the label. This can exceed the length of posts — that array is only a preview.
data.postsarray
A short preview strip of thumbnails, capped by OnlyFans regardless of postsCount.
data.isClearInProgressboolean
true while OnlyFans is still emptying the label in the background.
dataobject | array
Endpoint-specific payload. See the fields below for this route.
_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.id	integer	Label ID.
data.name	string	The name the creator chose.
data.type	string	`custom` for labels the creator made.
data.postsCount	integer	How many posts are on the label. This can exceed the length of `posts` — that array is only a preview.
data.posts	array	A short preview strip of thumbnails, capped by OnlyFans regardless of `postsCount`.
data.isClearInProgress	boolean	`true` while OnlyFans is still emptying the label in the background.
data	object \| array	Endpoint-specific payload. See the fields below for this route.
_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/sample_label_id" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"id":9895427
"name":"Photo sets"
"type":"custom"
"isClearInProgress":false
"postsCount":2
"posts":[0:{"type":"photo"
"canViewMedia":true
"postId":"2676873092"
"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
}
1:{"type":"photo"
"canViewMedia":true
"postId":"2661473796"
"url":"https://public-api.fansmetric.com/media-proxy?url=...&exp=...&sig=..."
}
]
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Post Label Filters

Add Posts to Label