Token Usage

INFO

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.

OpenAPI

openapi: 3.0.0
info:
title: Firecrawl API
version: v2
description: >-
  API for interacting with Firecrawl services to perform web scraping and
  crawling tasks.
contact:
  name: Firecrawl Support
  url: https://firecrawl.dev/support
  email: support@firecrawl.dev
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
paths:
/team/token-usage:
  get:
    tags:
      - Billing
    summary: Get remaining tokens for the authenticated team (Extract only)
    operationId: getTokenUsage
    responses:
      '200':
        description: Successful response
        content:
          application/json:
            schema:
              type: object
              properties:
                success:
                  type: boolean
                  example: true
                data:
                  type: object
                  properties:
                    remainingTokens:
                      type: number
                      description: Number of tokens remaining for the team
                      example: 1000
                    planTokens:
                      type: number
                      description: >-
                        Number of tokens in the plan. This does not include
                        coupon tokens.
                      example: 500000
                    billingPeriodStart:
                      type: string
                      format: date-time
                      description: >-
                        Start date of the billing period. null if using the
                        free plan
                      example: '2025-01-01T00:00:00Z'
                      nullable: true
                    billingPeriodEnd:
                      type: string
                      format: date-time
                      description: >-
                        End date of the billing period. null if using the free
                        plan
                      example: '2025-01-31T23:59:59Z'
                      nullable: true
      '404':
        description: Token usage information not found
        content:
          application/json:
            schema:
              type: object
              properties:
                success:
                  type: boolean
                  example: false
                error:
                  type: string
                  example: Could not find token usage information
      '500':
        description: Server error
        content:
          application/json:
            schema:
              type: object
              properties:
                success:
                  type: boolean
                  example: false
                error:
                  type: string
                  example: Internal server error while fetching token usage
    security:
      - bearerAuth: []
components:
securitySchemes:
  bearerAuth:
    type: http
    scheme: bearer