Posts

Get Post

Returns one post in full — caption, attached media, like count, expiry, and which parts can still be edited. Use it behind a post detail view: List Posts returns the same shape but leaves out favoritesCount and the edit flags. Requires permission api_posts_read.

https://public-api.fansmetric.com

GET/v1/{account_id}/posts/{post_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.
post_id*integer
The post ID. Numeric.

Response Fields

data.idinteger
OnlyFans post ID.
data.favoritesCountinteger
Total likes. Detail view only — the list view leaves this out.
data.expiredAtstring | null
When the post expires, if an expiry was set. null otherwise.
data.canEditTextboolean
Whether the caption can still be changed — use it to enable or disable an edit button.
data.canEditMediaboolean
Whether attachments can still be changed.
data.canEditExpireboolean
Whether the expiry can still be changed.
data.media[].videoSourcesobject
Playback sources. Present on video media only.
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	OnlyFans post ID.
data.favoritesCount	integer	Total likes. Detail view only — the list view leaves this out.
data.expiredAt	string \| null	When the post expires, if an expiry was set. `null` otherwise.
data.canEditText	boolean	Whether the caption can still be changed — use it to enable or disable an edit button.
data.canEditMedia	boolean	Whether attachments can still be changed.
data.canEditExpire	boolean	Whether the expiry can still be changed.
data.media[].videoSources	object	Playback sources. Present on video media only.
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/posts/sample_post_id" \
  --header "Authorization: Bearer YOUR_API_KEY"

Response

200

{"data":{"id":2676873092
"postedAt":"2026-08-15T12:04:11+00:00"
"postedAtPrecise":"1786872300.000000"
"text":"<p>Hello, fans!</p>"
"rawText":"Hello, fans!"
"author":{"id":12345678
"_view":"a"
}
"favoritesCount":42
"mediaCount":3
"isMediaReady":true
"canDelete":true
"canEdit":true
"canEditText":true
"canEditMedia":false
"tipsAmount":"$0"
}
"_meta":{"_credits":{"used":1
}
"_rate_limits":{"limit_minute":1000
"remaining_minute":999
"limit_day":50000
"remaining_day":49999
}
}
}

List Posts

Get Post Statistics