How to get your Firecrawl API usage, balance and spend programmatically

What the Firecrawl API exposes

Call it yourself

Credential. A normal Firecrawl API key (fc-…).

curl https://api.firecrawl.dev/v2/team/credit-usage \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY"

{
  "success": true,
  "data": {
    "remainingCredits": 1742,
    "planCredits": 3000,
    "billingPeriodStart": "2026-10-01T00:00:00Z",
    "billingPeriodEnd": "2026-11-01T00:00:00Z"
  }
}

Gotchas

• Credits aren't dollars. One credit is roughly one page.
• There's no pay-as-you-go. Without auto-recharge packs, every call returns 402 once credits hit zero.
• Firecrawl also has /v2/team/credit-usage/historical. Argus doesn't need it; burn comes from the hourly remainingCredits series.

How Firecrawl charges

Monthly subscription credits (1 credit ≈ 1 page); no pure pay-per-use. Optional auto-recharge credit packs roll over.

Free allowance. 1,000 a month.

At zero. 402. No PAYG; without auto-recharge packs, hard stop when credits run out.

• 500 requests per minute, per team. Per-team, per-plan; 10 (Free) → 7,500 (Scale).

Or let Argus track it

Paste the key once. Argus keeps the ledger, and your coding agent reads it through the MCP server.

• Reads the Firecrawl balance every hour and keeps the series, so you get burn per day (top-ups never count as negative spend) and days until it hits zero.
• Tracks the plan: the allowance, what's used this period, the reset date, and when you cross into overage.
• With the SDK, itemizes each call by endpoint and prices it at Firecrawl's per-operation rates.
• Emails you on low balance, days to zero, a spend spike, or projected overage.
• Hands all of it to your coding agent over MCP, so it can ask what a run cost or how much runway is left without leaving the editor.

> what has firecrawl cost today, and how long until it runs out?

get_overview       → firecrawl: mtd spend, burn per day, days to zero
get_request_costs  { "provider": "firecrawl", "limit": 25 }
get_advisories     → credits_low, spend_spike, rate_limit_low …

Questions

Does Firecrawl have an API for its balance?

Yes. GET https://api.firecrawl.dev/v2/team/credit-usage returns remaining credits, the plan's credits and the billing period.

Can I get Firecrawl spend per day from the API?

Not as a series. Derive it from how much the balance drops each day, ignoring top-ups.

What happens when Firecrawl credits run out?

Requests fail with HTTP 402. No PAYG; without auto-recharge packs, hard stop when credits run out. Auto-recharge is available.

What key does Argus need for Firecrawl?

A normal Firecrawl API key (fc-…).

Related

ExaParallelTavily