Historical Token Usage

GET /team/token-usage/historical

Get historical token usage for the authenticated team (Extract only)

cURL

curl --request GET \
  --url https://api.firecrawl.dev/v2/team/token-usage/historical \
  --header 'Authorization: Bearer <token>'

200

{
  "success": true,
  "periods": [
    {
      "startDate": "2025-01-01T00:00:00Z",
      "endDate": "2025-01-31T23:59:59Z",
      "apiKey": "<string>",
      "totalTokens": 1000
    }
  ]
}

Returns historical token usage on a month-by-month basis. The endpoint can also breaks usage down by API key optionally.

We’ve simplified billing so that Extract now uses credits, just like all of the other endpoints. Each credit is worth 15 tokens. Reported token usage now includes usage from all endpoints.

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

byApiKey · boolean · default: false

Get historical token usage by API key

Response

200

application/json

Successful response

success · boolean

Example:

true

periods · object[]

Show child attributes