Frequently Asked Questions

Quick answers to common Fans API questions about authentication, security, rate limits, fan analytics, webhooks, and integration best practices.

Fans API is an independent, unofficial service and is not affiliated with or approved by OnlyFans. Use it only on accounts you own or are authorised in writing to manage, and comply with the OnlyFans Terms of Service, including §8(b) (creator responsibility for third-party assistants) and §8(g) (automated data collection and AI training). Label AI-generated content #ai. See Compliance & acceptable use.

Frequently Asked Questions

Getting Started

API Capabilities & Features

Security & Safety

API Stability & Performance

Rate Limiting & Best Practices

API Keys Management

Account Authentication & Management

Fan Data & Analytics

Webhooks & Media Handling

Media & Downloads

Tracking & Free Trial Links

API Troubleshooting

Billing & Subscriptions

Documentation & Resources

On this page

Frequently Asked Questions

How do I create a Fans API account?

Can I work with Fans API if I'm not a developer?

Do you have a sandbox or demo account for testing?

Which programming languages can I use?

Can I use Fans API with OnlyMonster / Infloww / CreatorHero / Any other OnlyFans CRM?

Can your API send and read messages?

Is image generation supported?

Can I upload media directly to the vault?

Can I integrate with Supabase or similar tools?

Is there an API endpoint for scheduling chat messages?

How do I send a PPV (pay-per-view) message?

Can your API retrieve Golden Response Times?

Why do I get 404 errors on your endpoints?

Which endpoint should I use to build a creator directory?

Can I add text, question stickers, or emoji elements on story posts through the API?

Is your API safe to use?

Can I get banned for using Fans API as a chatbot?

How are login credentials protected?

How do you handle proxy configuration?

Does Fans API store data from my connected accounts?

What happens when my OnlyFans session expires?

How stable is your API?

What happens when OnlyFans updates their website?

How long is the cache duration?

How do I handle rate limiting errors?

Where can I find rate limit documentation?

How many API keys should I create?

Is there a limit on how many API key I can create?

Can one API key access multiple endpoints?

Are there specific scopes or permissions required for API keys?

Where do I find my account ID?

What's the correct format for {account} IDs in API calls?

Can I create a platform for users to manage their accounts?

Can I connect an OnlyFans account through the API?

How to export cookies to authenticate an account?

Can I retrieve the user agent used for authentication?

Is there a way to speed up the authentication process?

How does face verification work?

I have the same OnlyFans account connected multiple times. What am I doing wrong?

Is there an endpoint to list all connected creators?

How can I see how many subscribers I have?

How can I see my OnlyFans creator ranking?

How can I add a team member?

Why do I sometimes get empty fan data?

How can I check if a fan is online?

How do I track fan subscription duration?

How can I see total fan spending?

How can I get a list of subscribers with spending > 0?

How can I filter users by subscriber count?

How can I see my user following count?

How can I see fans with rebill enabled?

How can I calculate the percentage of fans with rebill enabled?

How can I change a fan's nickname?

Can I detect a fan's language preference?

How do I see what content a fan has purchased?

Does Fans API allow scraping of subscriber data?

How can I get the account ID of a user from the chats endpoint?

Where can I find the chat_id for getting chat messages?

How can I delete several users from a list with a single request?

How can I tell if a fan has read my message?

How do webhooks work?

Why do media in webhooks have no URL?

Can I use webhooks with no-code tools?

How can I view the logs of my webhook connection?

Is there a users.stopped_typing webhook event?

Why am I receiving a webhook event multiple times?

Is there a webhook for follower events?

Is there a webhook for message read receipts?

Is there a Fansly webhook for when a fan comes online?

I cannot access a cdn*.onlyfans.com URL

How do I download Fansly media?

Why do some Fansly API responses return cdn.fansapi.com URLs instead of cdn*.fansly.com?

What do I do when downloading a media file returns a 403 error?

Are there content restrictions for downloading media?

Does the media download endpoint require a specific account type?

My media file's files.full.url is null. Why?

Which OnlyFans user's content can I view?

Is there a dashboard for tracking link data?

Are there limits on how many free trial or tracking links I can create?