# Credit System
URL: /introduction/essentials/credits

Understanding credit allocation and subscription plans

***

title: "Credit System"
description: "Understanding credit allocation and subscription plans"
icon: Coins
-----------

import {
    ChartNoAxesCombinedIcon,
    CodeIcon,
    CoinsIcon,
    DatabaseZapIcon,
    FileTextIcon,
    HeartPlusIcon,
    MonitorIcon,
    ScanSearchIcon,
    SquareActivityIcon,
    TrendingUpIcon,
} from 'lucide-react';

## Credit calculator

<Card>
  <iframe src="https://ofapi-credit-calculator.pages.dev/" height="400" className="w-full" />
</Card>

## Credit cost overview

Please refer to the table below to get a general overview of the credit cost for our endpoints.

For detailed information about where to find credit information in API responses, see our [Response Structure](/introduction/essentials/response-structure) documentation.

| Endpoint(s)                                                          | Cost                            | Notes                                                                                                                                                                                                                              |
| -------------------------------------------------------------------- | ------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| [Search Profiles](/api-reference/public-profiles/searchProfiles)     | 1 credit per result             | E.g. if your search query has 10 results, you will be debited 10 credits.                                                                                                                                                          |
| [Media Uploading](/api-reference/media/uploadMediaToTheOnlyFansCDN)  | 6 credits per MB                | For easy calculation, we use decimal measurements. This means that 1MB is 1,000 KB.                                                                                                                                                |
| [Media Scraping](/api-reference/media/scrapeMediaFromTheOnlyFansCDN) | 6 credits per MB                | For easy calculation, we use decimal measurements. This means that 1MB is 1,000 KB.                                                                                                                                                |
| [Webhooks](/webhooks)                                                | 1 credit per sent webhook event | E.g. if you have one webhook configured for both `messages.received` and `messages.sent`, you will be charged 1 credit every time one of those events is triggered. Webhooks are not sent as a bundle, so every event is 1 credit. |
| [All other uncached responses](#uncached-responses)                  | 1 credit per request            | -                                                                                                                                                                                                                                  |
| [All other cached responses](#cached-responses)                      | 0 credits                       | -                                                                                                                                                                                                                                  |

## Cached vs uncached

### Cached responses

Public endpoints make use of automatic caching by default, and thus won't cost you any credits if a cached response already exists.

<Callout>
  **Account-specific endpoints will never be cached**, and will always give you a fresh response from OnlyFans.
</Callout>

#### Forcing a fresh response

You can force a fresh response by appending the endpoint URL with `?fresh=true`

### Uncached responses

All account-specific endpoints, and endpoints that reply on real-time data, will always return a fresh response from OnlyFans and thus will consume credits.

## Subscription Plans

Our subscription tiers provide different credit allocations:

<Cards className="grid grid-cols-3 gap-4 @container">
  <Card title="Basic Plan • 25,000 credits per month" href="https://app.onlyfansapi.com/register" cta="Start for free">
    • Perfect for small to medium projects\
    • Includes all basic features\
    • Automatic credit tracking
  </Card>

  <Card title="Pro Plan • 75,000 credits per month" href="https://app.onlyfansapi.com/register" cta="Start for free">
    • Ideal for larger applications\
    • Priority support\
    • Advanced features included
  </Card>

  <Card title="Enterprise Plan • Unlimited credits" href="mailto:hello@onlyfansapi.com" cta="Contact us">
    • Tailored to your needs\
    • Contact us to discuss requirements\
    • Custom features and support
  </Card>
</Cards>

## Credit Features

All subscription tiers include:

<Cards className="grid grid-cols-3 gap-4 @container">
  <Card title="Credit Rollover" icon={<CoinsIcon />}>
    • Up to 200% of monthly allocation\
    • Automatic rollover management\
    • No manual activation required
  </Card>

  <Card title="Usage Monitoring" icon={<ChartNoAxesCombinedIcon />}>
    • Real-time balance tracking\
    • Detailed usage analytics\
    • Automated notifications
  </Card>

  <Card title="Cache Optimization" icon={<DatabaseZapIcon />}>
    • Automatic response caching\
    • Zero-credit cached responses\
    • Cache control with `?fresh=true`
  </Card>
</Cards>

## Monitoring Tools

You can easily track your credit usage through all of our API responses, and through our Console

<Cards>
  <Card title="API Responses" icon={<CodeIcon />}>
    * Real-time credit balance
    * Request-specific credit usage
    * Cache status indicators
  </Card>

  <Card title="Console Analytics" icon={<MonitorIcon />}>
    * Real-time credit balance
    * View your rate limit usage
    * Easily purchase more credits
  </Card>
</Cards>

## Credit Management

Best practices for optimizing credit usage:

<Cards className="grid grid-cols-3 gap-4 @container">
  <Card title="Efficient caching" icon={<DatabaseZapIcon />}>
    Leverage cached responses when possible.
  </Card>

  <Card title="Credit balance monitoring" icon={<SquareActivityIcon />}>
    Monitor your credit balance regularly.
  </Card>

  <Card title="Usage patterns" icon="magnifying-glass" icon={<ScanSearchIcon />}>
    Review usage patterns regularly. Consider optimizing your requests.
  </Card>
</Cards>

<Callout>
  Cached responses are free and don't consume any credits from your balance.
  This applies to public endpoints like profile information.
</Callout>

## Enterprise Solutions

For high-volume requirements, we offer:

<Cards className="grid grid-cols-4 gap-4 @container">
  <Card title="Custom credit packages" icon={<CoinsIcon />} />

  <Card title="Volume-based pricing" icon={<TrendingUpIcon />} />

  <Card title="Priority support access" icon={<HeartPlusIcon />} />

  <Card title="Custom SLA options" icon={<FileTextIcon />} />
</Cards>

Please contact our team to discuss your specific needs and get a tailored solution.