GET
Get the catalog download list
Returns the catalog copies available on your plan, newest first. Each entry includes id, title, plan, catalogDate, modelsCount, sizeBytes, format, a signed downloadUrl and expiresAt.
/list
Dataset API
OnlyFans Catalog API
Get the whole OnlyFans creator catalog as a dataset instead of collecting it profile by profile. Each copy is a single gzip-compressed JSON Lines file with one creator per line, delivered through signed download links.
Overview
What the OnlyFans Catalog API gives you
- The full creator catalog in one .jsonl.gz file per copy
- Regularly refreshed copies; the latest copies stay available for download
- Complete creator profiles with our fetch timestamp
- Former usernames and promotion history (prices, messages, start and end dates), depending on your plan
- Avatar and header images mirrored on our CDN, with the history of previous images, depending on your plan
- Sample files of every format to check the data before subscribing
Endpoints
OnlyFans Catalog API endpoints
GET
Get sample files
Returns sample files of every format (100 creators each, plain .jsonl) so you can compare them before subscribing. Each entry has the same fields as /list.
/example
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-catalog-api/list"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-catalog.p.rapidapi.com" \
"https://onlyfans-catalog.p.rapidapi.com/list"Good to know
Integration notes
- Each call returns fresh signed download URLs; a previously returned URL stops working once it expires (about one hour after the call).
- Catalog files are large. Download from the signed downloadUrl directly — no API key is needed on the download URL itself.
Use cases
What teams build with the OnlyFans Catalog API
Market research
Analyse the whole creator market at once: categories, pricing, promotions and growth.
Data warehouses
Load complete creator profiles into your own database or analytics stack in one import.
Agency lead generation
Filter the full catalog by location, bio or pricing to find creators to work with.
Historical tracking
Compare copies to follow username changes, promotions and profile images over time.
FAQ
OnlyFans Catalog API questions
What is inside a catalog copy?
One gzip-compressed JSON Lines file with one creator profile per line. Depending on your plan it also carries former usernames, promotion history and mirrored avatar and header images with their history.
How do downloads work?
GET /list returns signed, time-limited download URLs. Follow the downloadUrl with any HTTP client — no API key is needed on the download itself. The URLs expire about an hour after the call.
Can I see the data before subscribing?
Yes. GET /example returns sample files of every format, 100 creators each.
How do I get an API key for the OnlyFans Catalog API?
Create an account on mirai-api.com, choose a plan for the OnlyFans Catalog 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 Catalog 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
Related APIs
Creator platform API
OnlyFans API
Creator profiles, bulk lookups, posts, social links, a searchable creators catalog and search by face photo.
Request signing API
OnlyFans Signer
Signed sign, x-bc, x-of-rev, x-hash and time headers for direct OnlyFans API requests.
Creator platform API
Fansly API
Creator profiles, posts, creator search, the monthly leaderboard, a creators catalog and search by face photo.
Start with the OnlyFans Catalog API
Create an account to get your API key, documentation with live request examples and direct developer support.