Post Labels

Add Posts to Label

Adds one or more posts to a label in a single call. Re-adding a post that is already on the label is harmless, and a post can carry several labels at once — so you do not need to check membership first. Requires permission api_post_labels_add_posts.

https://public-api.fansmetric.com

POST/v1/{account_id}/post-labels/{label_id}/posts

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 to add to. Numeric.

Request Body

application/json

post_ids*array
Array of post IDs to add. Must contain at least one entry.

Response Fields

data.labelobject
The label after the change, including its refreshed postsCount and preview strip — enough to update a label tile without a second call.
data.successboolean
Confirms the call went through.
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.label	object	The label after the change, including its refreshed `postsCount` and preview strip — enough to update a label tile without a second call.
data.success	boolean	Confirms the call went through.
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 POST "https://public-api.fansmetric.com/v1/100000001/post-labels/sample_label_id/posts" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --data '{
  "post_ids": [2676873092, 2661473796]
}'

Response

200

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

Get Post Label

Remove Post from Label