FMFansMetric API

Posts

Pin Post

Pins a post to the top of the creator's profile, or unpins it. This endpoint is a toggle — a second call reverses the first. The response only confirms success, so read the resulting state back from List Posts with pinned=true. Requires permission api_posts_pin.

https://public-api.fansmetric.com
POST/v1/{account_id}/posts/{post_id}/pin
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.

  • post_id*integer

    The post ID. Numeric.

Response Fields

  • data.successboolean

    Confirms the call went through. It does not tell you whether the post ended up pinned or unpinned — list pinned=true to find out.

  • 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.

curl --request POST "https://public-api.fansmetric.com/v1/100000001/posts/sample_post_id/pin" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200
{
"data":{
"success":true
}
"_meta":{
"_credits":{
"used":1
}
"_rate_limits":{
"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

Previous

Like Post

Next

Archive Post