Documentation Index
Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Firecrawl uses a credit-based billing system. Every API call you make consumes credits, and the number of credits consumed depends on the endpoint and options you use. You get a monthly credit allotment based on your plan, and Smart Upgrade keeps you covered as your usage grows. For current plan pricing, visit the Firecrawl pricing page.All Firecrawl invoices are billed in US Dollars (USD), regardless of your billing address or payment method.
Credits
Credits are the unit of usage in Firecrawl. Each plan includes a monthly credit allotment that resets at the start of each billing cycle. Different API endpoints consume different amounts of credits.Credit costs per endpoint
| Endpoint | Credit Cost | Notes |
|---|---|---|
| Scrape | 1 credit / page | Convert a single URL into clean markdown, HTML, or structured data. Additional credits apply when using scrape options (see below). |
| Crawl | 1 credit / page | Scrape an entire website by following links from a starting URL. The same per-page scrape option costs apply to each page crawled. |
| Map | 1 credit / call | Discover all URLs on a website without scraping their content. |
| Search | 2 credits / 10 results | Search the web and optionally scrape the results. Rounded up per 10 results (e.g., 11 results = 4 credits). Additional per-page scrape costs apply to each result that is scraped. See here for enterprise ZDR search pricing. |
| Interact | 2 credits / browser minute | Interactive browser sandbox session, billed per minute. |
| Agent | Dynamic | Autonomous web research agent. 5 daily runs free; usage-based pricing beyond that. |
Additional credit costs for scrape options
Certain scrape options add credits on top of the base cost per page:| Option | Additional Cost | Description |
|---|---|---|
| PDF parsing | +1 credit / PDF page | Extract content from PDF documents |
| JSON format (LLM extraction) | +4 credits / page | Use an LLM to extract structured JSON data from the page |
| Enhanced Mode | +4 credits / page | Improved scraping for pages that are difficult to access |
| Zero Data Retention (ZDR) | +1 credit / page | Ensures no data is persisted beyond the request (see Scrape ZDR) |
When credits are charged
Credits are charged whenever Firecrawl’s infrastructure processes a request, even if the target site returns an HTTP error status code such as 403 Forbidden or 404 Not Found. This is because the scraping infrastructure (browser rendering, proxy, etc.) is fully utilized regardless of the target site’s response. You can check themetadata.statusCode field in the API response to detect these cases and avoid retrying URLs that are consistently blocked.
For batch scrape and crawl jobs, credits are billed asynchronously as each page completes processing — not when the job is submitted. This means there can be a delay between submitting a job and seeing the full credit cost reflected on your account. If a batch contains many URLs or pages are queued during high-traffic periods, credits may continue to appear minutes or hours after submission. Polling or checking batch status does not consume credits.
Crawl pre-flight credit check: Before a crawl job starts, Firecrawl verifies that your remaining credit balance can cover the full
limit parameter you’ve requested. If your balance is lower than limit, the request returns a 402 even if the crawl would have discovered fewer pages. The default limit is 10,000, so omitting it requires 10,000 credits available up front. To avoid this, pass an explicit limit that matches the number of pages you actually intend to crawl (e.g., limit: 100).Tracking your usage
You can monitor your credit usage in two ways:- Dashboard: View your current and historical usage at firecrawl.dev/app
- API: Use the Credit Usage and Credit Usage Historical endpoints to programmatically check your usage
We are actively working on improvements to make credit usage easier to understand. Stay tuned for updates.
Plans
Firecrawl offers subscription-based monthly plans. There is no pure pay-as-you-go option, but Smart Upgrade (described below) provides flexible scaling on top of your base plan.Paid plans
| Plan | Monthly Credits | Concurrent Browsers |
|---|---|---|
| Hobby | 5,000 / 6,500 / 8,000 | 5 |
| Standard | 100,000 / 130,000 / 160,000 | 50 |
| Growth | 500,000 / 650,000 | 100 |
| Scale | 1,000,000 | 150 |
For needs beyond Scale, Firecrawl offers Enterprise plans with custom credits, dedicated support, SLAs, bulk discounts, zero-data retention, and SSO. Visit the Enterprise page for details.
Billing cycle
- Monthly plans: Credits reset on your monthly renewal date
- Yearly plans: You are billed annually, but credits still reset each month on your virtual monthly renewal date
- Unused plan credits do not roll over by default — your monthly allotment resets each month. Annual Scale plans roll unused plan credits over 1 month, and annual Enterprise plans roll them over 2 months.
Concurrent browsers
Concurrent browsers represent how many web pages Firecrawl can process for you simultaneously. Your plan determines this limit. If you exceed it, additional jobs wait in a queue until a slot opens. See Rate Limits for full details on concurrency and API rate limits.Smart Upgrade
Starting June 1, 2026, Smart Upgrade replaces Auto-Recharge. Instead of paying for overages, these payments now go toward your upgrades, giving you a seamless experience without disruptions.
Pro-ration examples
Suppose you’re on Hobby 6.5k ($28/month or $290/year) and Smart Upgrade moves you to Hobby 8k ($37/month or $390/year). You receive 1,500 additional credits immediately (the delta to 8k), and the upgrade charge depends on your billing cadence:- Monthly plan: You’re billed the $37 − $28 = $9 monthly difference today. Your renewal date is unchanged.
- Yearly plan, 5 months remaining in your 12-month cycle: You’re billed
(5 ÷ 12) × 100 ≈ $41.67today, where the annual price difference is $390 − $290 = $100. The remaining 4 months on Hobby 8k are covered by this charge, and your renewal date is unchanged.
Upgrading and Downgrading
- Upgrades take effect immediately. You are charged the full new-plan price today (no proration), and your billing cycle resets — your next renewal is one month or one year from the upgrade date. Any unused credits from your previous plan carry over, and your new credit allotment and concurrency limits apply right away.
- Downgrades are scheduled to take effect at your next renewal date. You keep your current plan’s credits and limits until then, and unused time on your current plan is not credited or refunded. You can undo a scheduled downgrade from your billing settings any time before the effective date.
Switching between monthly and yearly billing
- Monthly → Yearly at the same or higher credit tier is treated as an immediate upgrade.
- Yearly → Monthly is treated as an immediate upgrade only if you move to a strictly higher credit tier.
Running Out of Credits
If you exhaust your credit allotment and do not have Smart Upgrade enabled, API requests that consume credits will return an HTTP 402 (Payment Required) error. With Smart Upgrade enabled, your subscription is automatically moved to the next credit tier and you receive the new tier’s credit allotment immediately, so requests keep flowing without interruption. Smart Upgrade stops once you reach the Scale tier. To resume usage after a hard stop, you can:- Enable Smart Upgrade to scale up automatically
- Upgrade to a higher plan manually
- Wait for your credits to reset at the next billing cycle
Coupons
Firecrawl supports two types of coupons:- Subscription coupons apply a discount to your plan subscription (e.g. a percentage off your monthly or yearly price). These can only be applied during the Stripe checkout flow when you first subscribe to a paid plan or change plans. You cannot apply a subscription coupon after checkout has completed.
- Credit coupons add bonus credits to your account. These can be redeemed from the Billing section of your dashboard at firecrawl.dev/app/billing. Look for the coupon input field on the billing page to apply your code. Bonus credits from credit coupons are separate from your plan’s monthly allotment and persist even if you upgrade or downgrade your plan.
FAQs
Do unused credits roll over to the next month?
Do unused credits roll over to the next month?
Plan credits do not roll over by default — your monthly allotment resets each month. Annual Scale plans roll unused plan credits over 1 month, and annual Enterprise plans roll them over 2 months.
How is the Smart Upgrade charge calculated?
How is the Smart Upgrade charge calculated?
Smart Upgrade bills the pro-rated difference between your current tier and the next tier. On monthly plans, this is the monthly price difference. On yearly plans, it’s
(months remaining in your billing cycle ÷ 12) × annual price difference, using full calendar months from the start of your current period. You also receive the delta in credits between the two tiers, so you only pay for what you gain.How do I know how many credits I have left?
How do I know how many credits I have left?
Check the dashboard at firecrawl.dev/app, or call the Credit Usage API endpoint programmatically.
Where do I apply a coupon code?
Where do I apply a coupon code?
It depends on the coupon type. Credit coupons are applied in the Billing section of your dashboard. Subscription coupons (discounts on your plan price) can only be applied at the Stripe checkout page when subscribing or changing plans.
I need more concurrency or a custom plan. Who do I contact?
I need more concurrency or a custom plan. Who do I contact?
Reach out to help@firecrawl.dev, or visit the Enterprise page to learn more about custom plans.
What currency are invoices billed in?
What currency are invoices billed in?
All Firecrawl invoices are billed in US Dollars (USD), regardless of your billing address or payment method.
How do I add a VAT number, company name, or billing address to my invoices?
How do I add a VAT number, company name, or billing address to my invoices?
Go to your billing settings, click Manage Subscriptions, and update your billing address, company name, and VAT number in the Stripe portal. Future invoices will automatically include the updated details.To regenerate a past paid invoice with the new information:
- Update your billing details in the Stripe portal first (see above).
- Open the Invoice history tab in the Stripe portal and download the PDF for the invoice you want; Stripe re-renders it against your current billing info.
- If an invoice doesn’t pick up the updated details, email help@firecrawl.dev with the invoice numbers and we’ll regenerate them for you.