# Uso histórico de tokens (/es/api-reference/endpoint/token-usage-historical)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 809 · updated: 2026-07-30 -->
Related: [Búsqueda](/es/api-reference/endpoint/search.md), [Comentarios sobre la búsqueda](/es/api-reference/endpoint/search-feedback.md), [Scrape](/es/api-reference/endpoint/scrape.md), [Raspado en lote](/es/api-reference/endpoint/batch-scrape.md), [Obtener el estado de la captura por lotes](/es/api-reference/endpoint/batch-scrape-get.md), [Cancelar extracción en lote](/es/api-reference/endpoint/batch-scrape-delete.md)

Devuelve el uso histórico de tokens por mes. Este endpoint también puede desglosar el uso por clave de API de forma opcional.

<Info>
  Hemos simplificado la facturación para que Extract ahora use créditos, igual que los demás endpoints. Cada crédito equivale a 15 tokens. El uso de tokens informado ahora incluye el uso de todos los endpoints.
</Info>

> ¿Eres un agente de IA que necesita una clave de API de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver las instrucciones de incorporación automatizada.

`GET /team/token-usage/historical`

Obtén el historial de uso de tokens para el equipo autenticado (solo Extract)

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "Obtener el historial de uso de tokens por clave de API",
      "in": "query",
      "name": "byApiKey",
      "required": false,
      "schema": {
        "default": false,
        "type": "boolean"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "periods": {
                "items": {
                  "properties": {
                    "apiKey": {
                      "description": "Nombre de la clave de API usada durante el periodo de facturación. null si byApiKey es false (valor predeterminado)",
                      "nullable": true,
                      "type": "string"
                    },
                    "endDate": {
                      "description": "Fecha de final del período de facturación",
                      "example": "2025-01-31T23:59:59Z",
                      "format": "date-time",
                      "type": "string"
                    },
                    "startDate": {
                      "description": "Fecha de inicio del período de facturación",
                      "example": "2025-01-01T00:00:00Z",
                      "format": "date-time",
                      "type": "string"
                    },
                    "totalTokens": {
                      "description": "Número total de tokens utilizados en el período de facturación",
                      "example": 1000,
                      "type": "integer"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "success": {
                "example": true,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Respuesta satisfactoria"
    },
    "500": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Internal server error while fetching historical token usage",
                "type": "string"
              },
              "success": {
                "example": false,
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "Error del servidor"
    }
  }
}
```