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

# Credits & Pricing

> Understand Crawleo's credits-based pricing system, API costs per endpoint, subscription plans, and how to optimize your usage.

## Overview

Crawleo uses a **credits-based billing system** that gives you flexibility and predictability in your API usage. Credits are deducted from your monthly allowance based on which API endpoints you use and their configuration.

## Credit Costs

### Bing Search API

Optimized for LLM and RAG pipelines with auto-crawling and content extraction.

| Operation                    | Credits Cost   |
| ---------------------------- | -------------- |
| Search (per page of results) | **10 credits** |

<Info>
  Each page of search results (controlled by `max_pages` parameter) costs 10 credits. For example, searching with `max_pages=3` will cost 30 credits.
</Info>

### Google Search API

Structured Google SERP data for SEO, lead generation, and competitor research.

| Operation             | Credits Cost   |
| --------------------- | -------------- |
| Google search request | **10 credits** |

<Info>
  Each Google Search request costs a flat 10 credits regardless of result count. Supports web, news, images, places, and shopping search types.
</Info>

### Crawl API

| Rendering Mode                       | Credits Cost           |
| ------------------------------------ | ---------------------- |
| HTTP request (`render_js=false`)     | **1 credit** per URL   |
| Browser rendering (`render_js=true`) | **10 credits** per URL |

<Info>
  Failed requests cost **0 credits**. You only pay for successful responses.
</Info>

<Tip>
  Use browser rendering (`render_js=true`) only for JavaScript-heavy sites that require dynamic content. Default HTTP requests are the most cost-effective.
</Tip>

### Headful Browser API

Premium crawling using a real headed browser with advanced anti-bot evasion, dedicated GPU rendering, and SOAX residential proxies.

| Operation                         | Credits Cost   |
| --------------------------------- | -------------- |
| Headful browser request (per URL) | **50 credits** |

<Info>
  The Headful Browser API is designed for sites protected by Cloudflare, Akamai, DataDome, or other advanced bot-detection systems where the standard Crawl API is insufficient.
</Info>

<Warning>
  At 50 credits per URL, use the Headful Browser API only when necessary. Always try the standard Crawl API (`render_js=false` or `render_js=true`) first. Failed requests cost **0 credits**.
</Warning>

## Subscription Plans

<CardGroup cols={2}>
  <Card title="Free Plan" icon="gift">
    **\$0/month**

    * 500 credits/month
    * 500 page crawls
    * 50 searches
    * Email support
    * Zero data retention
  </Card>

  <Card title="Developer" icon="code">
    \*\*$20/month** (or $200/year)

    * 100,000 credits/month
    * 20 concurrent requests
    * Email support
    * Zero data retention
  </Card>

  <Card title="Pro" icon="rocket">
    \*\*$100/month** (or $1,000/year)

    * 1,000,000 credits/month
    * 50 concurrent requests
    * Email + Dedicated support
    * Zero data retention
  </Card>

  <Card title="Scale" icon="chart-line">
    \*\*$200/month** (or $2,000/year)

    * 2,500,000 credits/month
    * 100 concurrent requests
    * Email + Dedicated support
    * Zero data retention
  </Card>
</CardGroup>

<Card title="View All Plans" icon="arrow-right" href="https://www.crawleo.dev/pricing">
  Compare plans and subscribe at crawleo.dev/pricing
</Card>

## Usage Examples

### Bing Search API Examples

| Use Case            | Parameters                              | Credits Used |
| ------------------- | --------------------------------------- | ------------ |
| Basic search        | `query="AI news"` (1 page)              | 10 credits   |
| Deep search         | `query="AI news"&max_pages=5`           | 50 credits   |
| Multi-page research | `query="machine learning"&max_pages=10` | 100 credits  |

### Google Search API Examples

| Use Case         | Parameters                              | Credits Used |
| ---------------- | --------------------------------------- | ------------ |
| Basic search     | `q="best CRM software"`                 | 10 credits   |
| News search      | `q="AI news"&type=news`                 | 10 credits   |
| Local businesses | `q="coffee shops"&type=places&gl=gb`    | 10 credits   |
| Shopping         | `q="wireless headphones"&type=shopping` | 10 credits   |

### Crawl API Examples

| Use Case                   | Parameters                                     | Credits Used |
| -------------------------- | ---------------------------------------------- | ------------ |
| Single page crawl          | `urls=https://example.com`                     | 1 credit     |
| Crawl with JavaScript      | `urls=https://example.com&render_js=true`      | 10 credits   |
| 5 pages, HTTP only         | `urls=url1,url2,url3,url4,url5`                | 5 credits    |
| 5 pages, with JS rendering | `urls=url1,url2,url3,url4,url5&render_js=true` | 50 credits   |

### Headful Browser API Examples

| Use Case               | Parameters                                        | Credits Used |
| ---------------------- | ------------------------------------------------- | ------------ |
| Crawl a protected site | `urls=https://protected-site.com`                 | 50 credits   |
| With screenshot        | `urls=https://protected-site.com&screenshot=true` | 50 credits   |
| With country proxy     | `urls=https://protected-site.com&country=gb`      | 50 credits   |

When using Crawleo via MCP (Model Context Protocol), the same credit costs apply:

| MCP Tool                        | Credits Cost           |
| ------------------------------- | ---------------------- |
| `search_web`                    | 10 credits per page    |
| `google_search`                 | 10 credits per request |
| `google_maps`                   | 10 credits per request |
| `crawl_web` (HTTP request)      | 1 credit per URL       |
| `crawl_web` (browser rendering) | 10 credits per URL     |
| `headful_browser`               | 50 credits per URL     |

## Response Fields

Every API response includes credit usage information:

```json theme={null}
{
  "success": true,
  "data": { ... },
  "credits_used": 10,
  "credits_remaining": 9990
}
```

<ResponseField name="credits_used" type="integer">
  Number of credits consumed by this API call.
</ResponseField>

<ResponseField name="credits_remaining" type="integer">
  Your remaining credit balance for the current billing period.
</ResponseField>

## Monitoring Your Usage

Track your credit usage in the [Crawleo Dashboard](https://www.crawleo.dev/dashboard):

* View current credit balance
* See usage history and trends
* Set up usage alerts
* Monitor API call patterns

## Optimizing Credit Usage

<AccordionGroup>
  <Accordion title="Use Appropriate Rendering Mode" icon="browser">
    * Start with **HTTP requests** (1 credit) for most static sites
    * Use **browser rendering** (10 credits) only for JavaScript-heavy sites
    * Test with HTTP first before enabling JavaScript rendering
  </Accordion>

  <Accordion title="Optimize Search Depth" icon="magnifying-glass">
    Only request the number of search pages you need. Each additional page costs 10 credits.
  </Accordion>

  <Accordion title="Batch Crawl Requests" icon="layer-group">
    Crawl multiple URLs in a single request when possible to reduce overhead.
  </Accordion>

  <Accordion title="Cache Results" icon="database">
    Cache crawled content on your side to avoid re-crawling the same URLs.
  </Accordion>
</AccordionGroup>

## Rate Limits

In addition to credits, each plan has concurrent request limits:

| Plan      | Concurrent Requests |
| --------- | ------------------- |
| Free      | 5                   |
| Developer | 20                  |
| Pro       | 50                  |
| Scale     | 100                 |

If you exceed your concurrent request limit, you'll receive a `429` response:

```json theme={null}
{
  "error": {
    "code": "CONCURRENT_LIMIT_EXCEEDED",
    "message": "Concurrent request limit reached (5). Please wait for other requests to finish."
  }
}
```

## Upgrading Your Plan

Need more credits? [Upgrade your plan](https://www.crawleo.dev/pricing) at any time:

* Upgrades take effect immediately
* Unused credits don't roll over
* Pro-rated billing for mid-cycle upgrades

<Card title="Contact Sales" icon="envelope" href="mailto:support@crawleo.dev">
  Need a custom plan or have questions? Contact our sales team.
</Card>