Creator platform API

OnlyFans API

Get current OnlyFans creator data over a simple REST API: profiles by username, bulk lookups by user ID, posts with sorting, social buttons, a searchable creators catalog and search by face photo — without running browsers, sessions or proxies yourself.

Get an API key View on RapidAPI

Overview

What the OnlyFans API gives you

Endpoints

OnlyFans API endpoints

GET

Get profile by nickname

Returns profile data for a creator by public nickname.

/users/{nickname}
  • nickname — creator username without @
GET

Get users list by IDs

Returns a JSON object keyed by the requested user IDs. Up to 100 IDs per call.

/users/list
  • users — comma-separated user IDs (e.g. 1,2,3)
  • of_ids — JSON array form, repeatable
GET

Get buttons by model ID

Returns social buttons and external links attached to a creator profile.

/buttons/{model_id}
  • model_id — creator identifier
GET

Get posts by model ID

Returns creator posts for a known creator ID.

/posts/{model_id}/{limit}/{order}
  • model_id — creator identifier
  • limit — number of posts to return
  • order — publish_date_desc | publish_date_asc | tips_summ_desc | tips_summ_asc | favorites_count_desc | favorites_count_asc
GET

Browse the creators catalog

Paginated browsing over the Apimirai creators catalog. Page size depends on your plan.

/catalog/{page}/{order}
  • page — integer >= 1
  • order — publish_date_desc | publish_date_asc | username_asc | username_desc
GET

Search the creators catalog

Searches catalog records by username, name, description and location. Page size depends on your plan.

/search/{page}/{order}
  • page — integer >= 1
  • order — relevance_desc | publish_date_desc | publish_date_asc | username_asc | username_desc
  • query — full-text search value
  • fields — optional comma-separated list: username,name,location,about,promotions,username_aliases
POST

Find creators by face photo

Upload a face photo and find the OnlyFans creators who look like that person. Each creator appears once with the best-matching avatar and a similarity score from 0 to 1. The number of matches depends on your plan.

/search/by_image
  • image_base64 — JSON body field: the photo as base64 (JPEG, PNG, WebP or GIF, up to 10 MB, 64x64 to 1000x1000 px)
  • page — optional page number on plans with paginated results

Quick start

Make your first request

Apimirai gateway

Send your account API key in the X-API-Key header, as an Authorization: Bearer token or as the api_key query parameter. Every response is JSON.

curl \
     -H "X-API-Key: <your-api-key>" \
     "https://api.mirai-api.com/onlyfans-api/users/<nickname>"

RapidAPI

Already on RapidAPI? Call the same endpoints with your RapidAPI key and host headers.

curl \
     -H "X-RapidAPI-Key: <your-rapidapi-key>" \
     -H "X-RapidAPI-Host: onlyfans-api5.p.rapidapi.com" \
     "https://onlyfans-api5.p.rapidapi.com/users/<nickname>"

Good to know

Integration notes

Use cases

What teams build with the OnlyFans API

Creator analytics

Track profile stats, pricing and post activity over time for dashboards and market research.

Agency and CRM tools

Enrich your creator records with fresh profile data, posts and social links.

Discovery products

Build search and recommendation features on top of the creators catalog.

Brand protection

Find profiles that reuse a face photo to spot impersonation and stolen images.

FAQ

OnlyFans API questions

Do I need an OnlyFans account to use the API?

No. You call the API with your Apimirai key; all platform access, sessions and proxies are handled on our side.

How do I look up many creators at once?

Use GET /users/list with up to 100 comma-separated user IDs. The response is a JSON object keyed by the requested IDs.

Can I search OnlyFans creators by photo?

Yes. POST /search/by_image accepts a face photo as base64 and returns matching creators, each once, with the best-matching avatar and a similarity score from 0 to 1.

How do I get an API key for the OnlyFans API?

Create an account on mirai-api.com, choose a plan for the OnlyFans API and copy your API key from the Settings page. Send it in the X-API-Key header, as an Authorization: Bearer token or as the api_key query parameter.

Is the OnlyFans API available on RapidAPI?

Yes. The same endpoints are published on RapidAPI, so you can also subscribe there and call them with your RapidAPI key.

More APIs

Creator platform API

Fansly API

Creator profiles, posts, creator search, the monthly leaderboard, a creators catalog and search by face photo.

Overview RapidAPI
Built into 10 APIs

Face photo search

An endpoint in ten of our APIs that finds creators and cam models who look like the person in a photo.

Overview

Start with the OnlyFans API

Create an account to get your API key, documentation with live request examples and direct developer support.

Get an API key Browse all APIs