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

# Credits & Pricing

> Understand the ScrapeBadger credit system, pricing tiers, and credit costs per endpoint.

ScrapeBadger uses a simple credit-based pricing model. Pay only for what you use with transparent, predictable costs.

## How Credits Work

<CardGroup cols={3}>
  <Card title="Purchase Credits" icon="bolt">
    Buy credit packages from your dashboard. Larger packages offer better value per credit.
  </Card>

  <Card title="Make API Calls" icon="credit-card">
    Each API request deducts credits from your balance. Most endpoints cost 1 credit per call.
  </Card>

  <Card title="Track Usage" icon="chart-line">
    Monitor your credit usage in real-time from your dashboard. Set up alerts for low balance.
  </Card>
</CardGroup>

## Credit Costs by Endpoint

### Web Scraping

| Component | Cost |
| - | - |
| Scrape — `http` engine (default) | 1 credit |
| Scrape — `browser` engine (JS rendering) | 5 credits |
| Scrape — Anti-bot solver add-on | +5 credits |
| Scrape — AI extraction add-on | +2 credits |
| Detect — Fresh scan | 1 credit |
| Detect — Cached result (5 min TTL) | 0 credits |

<Tip>
  Web scraping retries are free — you only pay for the engine that produces the final result. Failed requests cost 0 credits.
</Tip>

### Twitter

| Category | Endpoints | Cost |
| - | - | - |
| Tweets | 11 endpoints | 1 base credit + 1 credit per item returned |
| Users | 11 endpoints | 1 base credit + 1 credit per item returned |
| Lists | 3 endpoints | 1 base credit + 1 credit per item returned |
| Communities | 3 endpoints | 1 base credit + 1 credit per item returned |
| Trends | 2 endpoints | 1 base credit + 1 credit per item returned |
| Geo | 2 endpoints | 1 base credit + 1 credit per item returned |
| Spaces | 2 endpoints | 1 base credit + 1 credit per item returned |

<Info>
  **Twitter/X is billed per item.** Each request costs **1 base credit plus 1 credit for every item** (tweet, user, etc.) in the response — so a request that returns N items costs **N + 1** credits. For example, an `advanced_search` call returning 20 tweets costs **21 credits**. The exact amount charged for any request is returned in the **`X-Credits-Used`** response header.
</Info>

<Info>
  Failed requests (4xx/5xx errors) do not consume credits. You are only charged for successful responses.
</Info>

## Repeated requests are free for 60 seconds

If you send the same request again within **60 seconds**, the cached response is returned and you are charged **0 credits**. "The same request" means the same API key, endpoint, query parameters (in any order) and request body. This covers accidental retry loops and duplicate calls from your code.

* A cached response has the `X-Cache: HIT` header, an `Age` header (seconds since the original call) and `X-Credits-Used: 0`.
* If identical requests are sent at the same time, only the first one runs and is billed. The others wait for it and get its result for free.
* Only successful responses that cost credits are cached. Errors and empty results that cost 0 credits are not cached, so retrying them still makes a real request.
* To force a fresh result, send `Cache-Control: no-cache`. That request is billed as normal.
* Cached responses still count toward your [rate limit](/rate-limits).

```bash theme={null}
curl -H "x-api-key: $SCRAPEBADGER_API_KEY" -H "Cache-Control: no-cache" \
  "https://scrapebadger.com/v1/facebook/posts/1113411791332972"
```

## Free Credits

New accounts receive free credits to get started. Use them to test the API and build your integration before purchasing more.

<Card title="Create Free Account" icon="rocket" href="https://scrapebadger.com/auth/signup?utm_source=docs&utm_medium=referral">
  Sign up and get free credits to start building.
</Card>

## Credit Packages

We offer a range of credit packages to suit different needs. Larger packages offer better value per credit.

<Card title="View Pricing Plans" icon="credit-card" href="https://scrapebadger.com/pricing">
  See all available credit packages and pricing.
</Card>

## FAQ

<AccordionGroup>
  <Accordion title="What are credits?">
    Credits are the unit of measurement for API usage. Each API call consumes a certain number of credits based on the endpoint.
  </Accordion>

  <Accordion title="Do credits expire?">
    No, credits never expire. Once purchased, they remain in your account until you use them.
  </Accordion>

  <Accordion title="What happens when I run out of credits?">
    When your credit balance reaches zero, API requests will return a 402 Payment Required error. You can purchase more credits at any time.
  </Accordion>

  <Accordion title="Do you offer refunds?">
    Credits are non-refundable once purchased. However, if you experience technical issues, contact support and we will work with you.
  </Accordion>

  <Accordion title="Am I charged for repeating the same request?">
    No, not if you repeat it within 60 seconds. An identical request (same API key, endpoint, parameters and body) in that window returns the cached response at **0 credits**, marked `X-Cache: HIT`. See [Repeated requests are free for 60 seconds](#repeated-requests-are-free-for-60-seconds).
  </Accordion>

  <Accordion title="Am I charged for repeating the same Google request?">
    No. Google endpoints cache successful responses for 5 minutes. A repeat of the same endpoint with the same query parameters within that window — or sent while an identical request is still running — is served from the cache at **0 credits** and marked with an `X-Cache: HIT` or `X-Cache: COALESCED` response header. See [Google — Response Caching](/google/overview#response-caching).
  </Accordion>

  <Accordion title="Are there volume discounts?">
    Yes! Our larger credit packages offer significant discounts. Check the [pricing page](https://scrapebadger.com/pricing) for current rates.
  </Accordion>
</AccordionGroup>

***

Need help with billing? Contact us at [support@scrapebadger.com](mailto:support@scrapebadger.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.