OnlyFans Vault & Media API
Content automation is media-first. The ofapis OnlyFans vault media API lets you read what already sits in a creator's vault and push new photos or videos into it programmatically. Every uploaded asset returns a stable media reference — the same id you attach to a scheduled post or a mass DM, so you upload once and reuse everywhere.
What you can do
- List vault media items, globally (first active account) or scoped to a specific linked account.
- Upload a photo or video to a creator's OnlyFans vault.
- Reuse the returned media id in posts, messages, and mailings.
Endpoints
GET /api/public/v1/vault/media
GET /api/public/v1/accounts/{accountId}/vault/media
POST /api/public/v1/accounts/{accountId}/media
Uploads are always account-scoped — you have to tell ofapis which linked account owns the file. Listing has both a global and a scoped form.
Upload media
Send the file as multipart form data. No Content-Type header is needed; curl sets the multipart boundary for you.
curl -X POST \
https://api.ofapis.com/api/public/v1/accounts/42/media \
-H "Authorization: Bearer ofapis_sk_..." \
-F "[email protected]"
A successful upload debits one credit and returns a vault media reference. Hold onto that id — it is what the scheduling API and mass DM API expect.
List the vault
curl "https://api.ofapis.com/api/public/v1/accounts/42/vault/media?limit=50" \
-H "Authorization: Bearer ofapis_sk_..."
Page through with the returned cursor to build a media picker or to de-duplicate before uploading.
Use cases
- Scheduled campaigns. Upload the week's assets in a batch, store the returned ids, then feed them to the scheduler so a post goes out with the right photo attached — no manual re-upload per post.
- Media picker UI. List the vault to render a thumbnail grid inside your own agency tool, letting a chatter pick an existing asset instead of leaving the app.
- PPV libraries. Keep a catalog of pay-per-view sets in the vault and reference them by id from message flows built on the messaging API.
Gotchas
- Uploads are large and slow. Video files take real time to transfer and for OnlyFans to process. Use generous client timeouts and expect the media to be usable a moment after the response, not always instantly.
- Billing. One successful call is one credit — both a successful upload and a successful list page. A failed upload (expired session, upstream error) is not charged.
- Rate limits follow your plan's requests-per-minute; batch uploads should respect it rather than firing in parallel. See pricing.
- Multi-account. Files uploaded under account
42live in that creator's vault only; there is no shared cross-account pool.
FAQ
What media types can I upload?
Common image and video formats accepted by OnlyFans itself — the API passes the file through to the creator's vault, so the same format rules apply.
Can I reuse an uploaded asset across many posts?
Yes. Uploading returns a media reference you can attach to any number of posts, messages, or mailings without re-uploading the bytes.
Does listing the vault cost a credit?
Yes — each successful list page debits one credit, like any other successful call. Failed calls are free.
Do I need the account id to upload?
Yes. The upload route is POST /accounts/{accountId}/media; it always targets one linked account's vault explicitly.