> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onlyfansapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Credit System (/introduction/essentials/credits)

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/search-profiles)                            | 1 credit per result             | E.g. if your search query has 10 results, you will be debited 10 credits.                                                                                |
| [Media Uploading](/api-reference/media/upload-media-to-the-only-fans-cdn)                    | 3 credits per MB                | Minimum 1 credit per file. For easy calculation, we use decimal measurements. This means that 1MB is 1,000 KB.                                           |
| [Media Downloading (OnlyFans)](/api-reference/media/download-media-from-the-only-fans-cdn)   | 3 credits per MB                | Minimum 1 credit per file. For easy calculation, we use decimal measurements. This means that 1MB is 1,000 KB. Files already cached on our CDN are free. |
| [Media Downloading (Fansly)](/api-reference/fansly/media/download-media-from-the-fansly-cdn) | 0 credits                       | This endpoint redirects instead of streaming bytes through us, so there is no per-MB charge.                                                             |
| [Webhooks](/webhooks)                                                                        | 1 credit per 100 Webhook events | -                                                                                                                                                        |
| Data Exports (Public Profiles)                                                               | 3 credits per profile           | -                                                                                                                                                        |
| Data Exports (Other)                                                                         | 1 credit per 20 results         | Applies to: Transactions, Chat Messages, Media, Trial Links, Tracking Links, Payouts, Chargebacks, Fans, Followings                                      |
| AI Profile Summaries                                                                         | 200 credits per generation      | Applies to both initial generation and re-generation.                                                                                                    |
| [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.

## When are credits charged?

A credit is consumed whenever your request causes a call to OnlyFans or Fansly — **including when the upstream response is an error** (e.g. a 404, 400, upstream 429, or 5xx).

You are **not** charged for:

* Responses served from cache
* Requests rejected by our rate limiter (`429 Too Many Requests`)
* Requests rejected for insufficient credits (`402 Payment Required`)
* Failures on our side before the upstream call is made

<Callout>
  Each page of a paginated list is one request — so one credit per page, if
  uncached.
</Callout>

## Subscription Plans

Our subscription tiers provide different credit allocations:

<Cards className="grid grid-cols-3 gap-4 @container">
  <Card title="Basic Plan • 20,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 • 100,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 • Custom credit allocation" href="mailto:hello@onlyfansapi.com" cta="Contact us">
    • Tailored to your needs\
    • Contact us to discuss requirements\
    • Custom features and support
  </Card>
</Cards>

## Buying extra credits

Need more credits than your monthly allowance? You can purchase one-time credit packs directly in the [dashboard](https://app.onlyfansapi.com/billing). Purchased credits are added on top of your monthly allowance and **never expire**.

| Credit pack       | Price  | Notes        |
| ----------------- | ------ | ------------ |
| 25,000 credits    | $50    | -            |
| 50,000 credits    | $89    | -            |
| 100,000 credits   | $149   | -            |
| 500,000 credits   | $499   | Most popular |
| 1,000,000 credits | $799   | -            |
| 5,000,000 credits | $3,499 | Best value   |

<Callout>
  **Auto top-up:** You can configure a balance threshold that automatically
  purchases a credit pack of your choice whenever your balance drops below it —
  so you never run out of credits mid-workflow.
</Callout>

## Credit Features

All subscription tiers include:

<Cards className="grid grid-cols-3 gap-4 @container">
  <Card title="Credit Rollover" icon={<CoinsIcon />}>
    • Unused credits stay in your balance\
    • Your credits never expire\
    • Purchased credit packs are added on top
  </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.