Creator platform API
Read Fansly creator data without running your own collector: profiles by username or in bulk by account ID, posts, full-text creator search, the current monthly leaderboard, a searchable creators catalog and search by face photo.
Overview
Endpoints
Returns the full creator profile (account object) for a single username. profileSocials is normalized to {type, url} for Twitter/X, Instagram and TikTok.
/users/{nickname}
Returns multiple creator profiles looked up by numeric account IDs — handy for resolving leaderboard accountIds in one call. Up to 50 IDs per request; invalid and duplicate IDs are dropped.
/users/list
Returns post data for the given numeric post IDs. Up to 20 IDs per request; invalid and duplicate IDs are dropped.
/posts
Full-text search over creators by username, display name, location and bio. Returns up to 25 matches.
/search
Returns the current monthly leaderboard: contest metadata, the prize-slot structure and the ranked accounts with their prizes.
/leaderboard
Paginated browsing over the Apimirai Fansly creators catalog. Page size depends on your plan.
/catalog/{page}/{order}
Full-text search over the creators catalog by username, name, location and bio. Page size depends on your plan.
/catalog/search/{page}/{order}
Upload a face photo and find the Fansly creators who look like that person. Each creator appears once with the best-matching image and a similarity score from 0 to 1. The number of matches depends on your plan.
/search/by_image
Quick start
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/fansly-api/users/<nickname>"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: fansly-api.p.rapidapi.com" \
"https://fansly-api.p.rapidapi.com/users/<nickname>"Good to know
Use cases
Follow profile stats, posts and leaderboard positions for dashboards and research.
Resolve the monthly leaderboard into full creator profiles with a single bulk call.
Power creator search and recommendations with the catalog and full-text search.
Match a face photo against creator images to spot impersonation and reused photos.
FAQ
No. You call the API with your Apimirai key; all platform access, sessions and proxies are handled on our side.
As integers in thousandths of USD: divide by 1000 to get dollars (29990 = $29.99).
Yes. POST /search/by_image accepts a face photo as base64 and returns matching creators with the best-matching image and a similarity score from 0 to 1.
Create an account on mirai-api.com, choose a plan for the Fansly 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.
Yes. The same endpoints are published on RapidAPI, so you can also subscribe there and call them with your RapidAPI key.
More APIs
Creator profiles, bulk lookups, posts, social links, a searchable creators catalog and search by face photo.
Boosty creator profiles, posts and paginated media by public nickname.
The full OnlyFans creator catalog as regularly refreshed, gzip-compressed JSON Lines files.
An endpoint in ten of our APIs that finds creators and cam models who look like the person in a photo.
Create an account to get your API key, documentation with live request examples and direct developer support.