Firecrawl API SOP

Appearance

Billing & Plans ​

Updated Feb 2026

Firecrawl uses a credit-based billing system. Every API call consumes credits, and the number consumed depends on the endpoint and options you use. You get a monthly credit allotment based on your plan, and can purchase additional credits via auto-recharge packs when needed.

For current pricing, visit the Firecrawl pricing page.

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 ​

EndpointCredit CostNotes
Scrape (/v2/scrape)1 credit / pageConvert a single URL into clean markdown, HTML, or structured data. Additional credits apply for scrape options (see below).
Crawl (/v2/crawl)1 credit / pageScrape an entire website by following links. The same per-page option costs apply to each page crawled.
Map (/v2/map)1 credit / callDiscover all URLs on a website without scraping content.
Search (/v2/search)2 credits / 10 resultsSearch the web and optionally scrape results. Additional per-page scrape costs apply to each scraped result.
Browser (/v2/browser)2 credits / browser minuteInteractive browser sandbox session, billed per minute.
Agent (/v2/agent)DynamicAutonomous 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:

OptionAdditional CostDescription
PDF parsing+1 credit / PDF pageExtract content from PDF documents
JSON format (LLM extraction)+4 credits / pageUse an LLM to extract structured JSON data from the page
Enhanced Mode+4 credits / pageImproved scraping for pages that are difficult to access

Credit Stacking

These modifiers stack. For example, scraping a page with both JSON format and Enhanced Mode costs 1 + 4 + 4 = 9 credits per page. The same modifiers apply to Crawl and Search endpoints since they use Scrape internally for each page.

Tracking Your Usage ​

You can monitor your credit usage in two ways:

MethodDetails
DashboardView current and historical usage at firecrawl.dev/app
APIUse the Credit Usage and Credit Usage Historical endpoints to programmatically check usage

Plans ​

Firecrawl offers subscription-based monthly plans. There is no pure pay-as-you-go option, but auto-recharge provides flexible scaling on top of your base plan.

Available Plans ​

PlanMonthly CreditsConcurrent Browsers
Free500 (one-time)2
Hobby3,0005
Standard100,00050
Growth500,000100
Scale / Enterprise1,000,000+150+

Enterprise Plans

For high-volume needs beyond the Growth plan, Firecrawl offers Scale and Enterprise plans with 1M+ credits, 150+ concurrent browsers, dedicated support, SLAs, bulk discounts, zero-data retention, and SSO. Visit the Enterprise page for details.

All paid plans are available with monthly or yearly billing. Yearly billing offers a discount compared to paying month-to-month.

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.

Auto-Recharge ​

If you occasionally need more credits than your plan includes, enable auto-recharge from the dashboard:

  • Available on all paid plans
  • When remaining credits drop below a configurable threshold, Firecrawl automatically purchases an additional credit pack
  • Pack sizes and prices vary by plan (visible on the pricing page)
  • You can configure the recharge threshold and toggle auto-recharge on or off at any time

When to Upgrade vs. Auto-Recharge

Auto-recharge is best for handling occasional spikes in usage. If you consistently exceed your plan's allotment, upgrading to a higher plan gives you better value per credit.

Billing Cycle ​

Billing TypeCredit Reset
Monthly plansCredits reset on your monthly renewal date
Yearly plansBilled annually, but credits still reset each month on your virtual monthly renewal date

Credits Do Not Roll Over

Unused credits do not roll over to the next billing period. Your allotment resets to the plan amount at the start of each cycle.

Upgrading and Downgrading ​

ActionWhen It Takes Effect
UpgradeImmediately. You are billed a prorated amount for the remainder of the current billing period. Credits and limits update right away.
DowngradeScheduled for your next renewal date. You keep your current plan's credits and limits until then.

What Happens When You Run Out of Credits ​

If you exhaust your credit allotment and do not have auto-recharge enabled, API requests that consume credits will return an HTTP 402 (Payment Required) error.

To resume usage:

  1. Enable auto-recharge to automatically purchase more credits
  2. Upgrade to a higher plan
  3. Wait for your credits to reset at the next billing cycle
json
// Example 402 error response
{
  "success": false,
  "error": "Payment required. You have exceeded your credit limit."
}

Free Plan ​

The Free plan provides a one-time allotment of 500 credits with no credit card required. These credits do not renew -- once they are used up, you need to upgrade to a paid plan to continue using Firecrawl.

The Free plan also has:

  • Lower rate limits compared to paid plans
  • Lower concurrency (2 concurrent browsers)
  • No auto-recharge capability

See Rate Limits for the full comparison.

FAQs ​

Do unused credits roll over to the next month?

No. Your credit allotment resets at the start of each billing period. Unused credits do not carry forward.

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.

What is the difference between credits and tokens?

Credits are the billing unit for Firecrawl API calls. Tokens refer to LLM tokens used internally by endpoints like Extract and Agent. Each credit is equivalent to 15 tokens. For most users, you only need to think in terms of credits.

I need more concurrency or a custom plan. Who do I contact?

Reach out to help@firecrawl.dev, or visit the Enterprise page for custom plans.