FanslyMedia
Get Account Media
Fetch one or more registered accountMedia by ID (e.g. an id returned when attaching media to a message). Each item includes the full media object with variants and CDN locations. For video, poll this until media.status is 1 (transcode complete) — the playable variants and locations populate once processing finishes. Pass a single ID or a comma-separated list; bulk requests still cost one API credit.
Authorization
default AuthorizationBearer <token>
Get your API Key from OnlyFansAPI Console - https://app.onlyfansapi.com/api-keys
In: header
Path Parameters
fanslyAccount*string
The Fansly Account ID
ids*string
An accountMedia ID, or a comma-separated list of IDs.
Response Body
application/json
curl -X GET "https://app.onlyfansapi.com/api/fansly/fansly_acct_XXXXXXXXXXXXXXX/account-media/925889499706191874"{
"success": true,
"response": [
{
"id": "925889499706191874",
"accountId": "800000000000000001",
"mediaId": "925889471688232961",
"previewId": null,
"permissionFlags": 8,
"price": 0,
"createdAt": 1782243618,
"deletedAt": null,
"deleted": false,
"permissions": {
"permissionFlags": [
{
"id": "925889499710373888",
"accountMediaId": "925889499706191874",
"type": 0,
"flags": 8,
"price": 0,
"metadata": "",
"validAfter": null,
"validBefore": null,
"verificationFlags": 8,
"verificationMetadata": "{}"
}
],
"accountPermissionFlags": {
"flags": 255,
"metadata": "{}"
}
},
"likeCount": 0,
"media": {
"id": "925889471688232961",
"type": 2,
"status": 1,
"accountId": "800000000000000001",
"mimetype": "video/mp4",
"flags": 0,
"filename": "clip.mp4",
"location": "/800000000000000001/925889471688232961.mp4",
"width": 1280,
"height": 720,
"metadata": "{\"originalHeight\":720,\"originalWidth\":1280,\"duration\":3000,\"resolutionMode\":1,\"frameRate\":30}",
"updatedAt": 1782244060,
"createdAt": 1782243612,
"variants": [
{
"id": "925889471688232962",
"type": 1,
"status": 1,
"mimetype": "image/jpeg",
"flags": 0,
"filename": "clip_frame.jpeg",
"location": "/800000000000000001/925889471688232962.jpeg",
"width": 854,
"height": 480,
"metadata": "{\"resolutionMode\":1}",
"updatedAt": 1782243645,
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/800000000000000001/925889471688232962.jpeg?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE"
}
]
},
{
"id": "925889474821378050",
"type": 302,
"status": 1,
"mimetype": "application/vnd.apple.mpegurl",
"flags": 0,
"filename": "925889474821378050.m3u8",
"location": "/800000000000000001/925889474821378050.m3u8",
"width": 1280,
"height": 720,
"metadata": "{\"originalHeight\":720,\"originalWidth\":1280,\"duration\":3000,\"variants\":[{\"w\":1280,\"h\":720},{\"w\":854,\"h\":480},{\"w\":640,\"h\":360}]}",
"updatedAt": 1782244060,
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/800000000000000001/925889474821378050.m3u8?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE"
}
]
}
],
"variantHash": {},
"locations": [
{
"locationId": "1",
"location": "https://cdn3.fansly.com/800000000000000001/925889471688232961.mp4?ngsw-bypass=true&Policy=EXAMPLE_POLICY&Key-Pair-Id=EXAMPLE_KEY&Signature=EXAMPLE_SIGNATURE"
}
]
},
"whitelist": [
{
"accountId": "800000000000000002",
"permissionFlags": 0
}
],
"purchased": true,
"whitelisted": true,
"accountPermissionFlags": 255,
"access": true
}
]
}