Update time. We tried to keep it short. We failed. Auto-cached media, a native iOS app to beat Face ID, two official SDKs, team roles, and a long tail of endpoints and fixes — here's everything we shipped across April and May.
⚡ TL;DR
- 🚀 Auto Media CDN — all OF media auto-cached to our CDN. Faster, no timeouts, fewer API calls.
- 📱 Auth+ iOS App — native app for Face ID verification. No more stuck logins.
- 📦 Official SDKs — TypeScript + PHP released. Python & Ruby coming.
- 🔐 Team Roles & Permissions — Owner, Admin, Developer, Viewer, Custom roles.
- 🔗 Smart Links upgrades — cost-per-click tracking, auto-add fans to lists, postback improvements.
- ⚙️ New Settings endpoints — subscription price + welcome message management via API.
- 📡 Online/Offline webhooks — real-time fan presence tracking.
- 🔄 Shared Tracking & Trial Links — 10 new endpoints for shared links.
- 🌍 Dashboard Timezones — everything respects your timezone now.
- 🚫 Blocked Countries endpoints — manage via API.
- 📋 Custom Smart Lists — segment fans by spend + subscription days.
- 🔧 More improvements — GIFs, auto top-up, rate limits, export upgrades, and more.
🚀 Auto Media CDN
This is the big one. We now automatically scrape and cache all OF media files to our own CDN (cdn.fansapi.com). Every API response that contains an OF CDN URL gets rewritten to point to our cached version.
What this means for you:
- ⚡ Faster downloads — cached files redirect instantly instead of streaming through our server.
- ✅ No more timeouts — downloads moved to a dedicated service with no size or time limits.
- 🧹 Less work — you can start phasing out separate
/media/downloadcalls. If the file is already cached, the URL in the API response is a direct download link. - 🛡️ More reliable — large file downloads no longer compete with API requests for server resources.
Still using /media/download? It still works, and cached files get redirected automatically. No code changes needed.
👉 Docs: https://docs.onlyfansapi.com/api-reference/media/download-media-from-the-only-fans-cdn
📱 Auth+ iOS App
OnlyFans rolled out new Face ID verification that was breaking automatic logins. So we did what any reasonable team would do — we built an entire iOS app to fix it. 🫠
Open the app, scan your face, done. No more stuck verifications. No more "why is my account not connecting" messages to support.
It's on TestFlight now, and we've submitted it to the App Store for official distribution.
👉 Connect your account guide: https://docs.onlyfansapi.com/introduction/guides/connect-onlyfans-account
📦 Official SDKs
We released our first two official SDKs:
- 🔹 TypeScript —
@onlyfansapi/onlyfans-sdk→ https://www.npmjs.com/package/@onlyfansapi/onlyfans-sdk - 🔹 PHP —
onlyfansapi/onlyfansapi-php→ https://packagist.org/packages/onlyfansapi/onlyfansapi-php
Python (onlyfans on PyPI) and Ruby (onlyfans on RubyGems) are coming soon — we already reserved the package names. Yes, we got onlyfans. On PyPI. You're welcome.
🔐 Team Roles & Permissions
This was the #1 requested team feature. You now have five roles:
- 👑 Owner — full control
- 🛠️ Admin — everything except billing and team deletion
- 💻 Developer — API keys, webhooks, integrations, data exports
- 👁️ Viewer — read-only access to everything
- 🎯 Custom — pick exactly what they can access (e.g. "smart links only")
Any role can get extra permissions on top of its defaults. Your VA doesn't need your billing page. Trust us.
🔗 Smart Links & Tracking Upgrades
A bunch of improvements landed for everyone running campaigns:
- 💰 Cost-Per-Click Tracking — we already had cost-per-promo and cost-per-sub. Now you can track cost-per-click too, so you know exactly what each click costs across campaigns.
- 📝 Auto-Add Fans to Lists — when a fan subscribes through a Smart Link, auto-add them to a specific list. Great for segmenting by traffic source.
- 📨 Postback Improvements — new conversion types including "fan sent 3 messages" and "message received", Global vs Campaign-Specific scope, and click tracking with
gclidandttclidparameters. If you're running Google or TikTok ads, this one's for you.
👉 Docs: https://docs.onlyfansapi.com/api-reference/tracking-links
⚙️ New Settings Endpoints
Four new endpoints for CRM and agency builders:
- 💲 Update Subscription Price — change a creator's subscription price via API.
- 👋 Get / Update / Toggle Welcome Message — read, edit, or enable/disable the auto-welcome message.
👉 Docs: https://docs.onlyfansapi.com/api-reference/settings/update-subscription-price · https://docs.onlyfansapi.com/api-reference/settings/get-welcome-message
📡 New Webhooks: Online/Offline
Two new webhook events: users.online and users.offline. Track when fans come online or go offline in real-time — useful for chatting tools, engagement timing, or analytics.
The "is this fan online right now?" question finally has a real-time answer.
👉 Docs: https://docs.onlyfansapi.com/webhooks/available-events
🔄 Shared Tracking & Trial Links
If models share their tracking or free trial links to your account on OF, you can now manage them through our API and dashboard:
- 📂 10 new endpoints — list, tag, and revoke access for shared links.
- 📱 Dashboard pages — show shared links alongside your own.
🌍 Dashboard Timezones
All dates, charts, and graphs in the dashboard now respect your timezone. Auto-detects on first load, change it anytime. No more mental UTC math.
🚫 Blocked Countries Endpoints
Get and update your blocked countries list via API.
👉 Docs: https://docs.onlyfansapi.com/api-reference/settings/get-blocked-countries
📋 Custom Smart Lists
Create, edit, and delete your own custom Smart Lists in Housekeeping — define total-spend and subscription-day ranges to segment fans however you want.
🔧 More Improvements
- 😂 Giphy GIF Support — send GIFs in chat messages via API and dashboard (https://docs.onlyfansapi.com/api-reference/chats/send-message).
- 🔋 Auto Top-Up for Credits — set a threshold and your credits refill automatically when low.
- 📩 Get Chat Message endpoint — fetch a single message by ID.
- ⏱️ Rate Limit Retry-After header — we now return how many seconds to wait, so you can handle limits cleanly (https://docs.onlyfansapi.com/introduction/essentials/rate-limits).
- 📤 Data Export upgrades — exports now track total records found, support restarting and cancelling mid-export, and completion emails link to a non-expiring URL (https://docs.onlyfansapi.com/data-exports).
- 📅 Post expiration — now supports any value between 1–30 days (not just preset options).
- 🏷️ "Without tags" filter — filter trial links and tracking links by "no tags" in the dashboard.
- 💿 Data export race condition — fixed a bug where some exports showed scraped rows but the CSV came back empty.
- 🧠 AI Fan Summaries — improved reliability and response handling.
- 🌐 CDN upload fix — fixed an edge case where OF silently dropped videos/images during upload.
- 📖 Endpoint data sources docs — every endpoint now documents whether it reads from our database or hits OF live (https://docs.onlyfansapi.com/introduction/essentials/endpoint-data-sources).
💬 Questions or feedback?
- 📧 hello@onlyfansapi.com
- 💬 Telegram: @onlyfansapi
- 📢 Updates: @onlyfansapi_updates
More updates coming soon. Keep building.
