> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spidra.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage by tool

> Credits used per day, split by tool: scrape, crawl, search, parse and map.

## Request

```bash theme={null}
curl "https://api.spidra.io/api/usage-stats/breakdown?range=7d" \
  -H "Authorization: Bearer $SPIDRA_API_KEY"
```

`range` is `1d`, `7d` or `30d`, or `custom` with `startDate` and `endDate` (`YYYY-MM-DD`, up to 90 days apart).

## Response

One row per day, shortened to two:

```json theme={null}
{
  "status": "success",
  "data": [
    { "label": "Oct 19", "date": "2026-10-19", "scrapeCredits": 74, "crawlCredits": 0, "searchCredits": 0, "parseCredits": 0, "mapCredits": 0 },
    { "label": "Oct 20", "date": "2026-10-20", "scrapeCredits": 3, "crawlCredits": 0, "searchCredits": 0, "parseCredits": 0, "mapCredits": 0 }
  ]
}
```

Batch scrapes count under `scrapeCredits`. Totals across every tool are in [Usage stats](https://docs.spidra.io/api-reference/account/usage-stats.md).


## OpenAPI

````yaml GET /usage-stats/breakdown
openapi: 3.1.0
info:
  title: Spidra API
  version: 1.0.0
  description: >-
    Public API endpoints for web scraping via Spidra. Authenticate with
    `Authorization: Bearer YOUR_API_KEY`.
servers:
  - url: https://api.spidra.io/api
security:
  - BearerAuth: []
  - ApiKeyAuth: []
paths:
  /usage-stats/breakdown:
    get:
      tags:
        - Account
      summary: Usage by tool
      description: Credits per day, split by tool.
      parameters:
        - name: range
          in: query
          required: false
          schema:
            type: string
            enum:
              - 1d
              - 7d
              - 30d
              - custom
          description: The period. custom needs startDate and endDate.
        - name: startDate
          in: query
          required: false
          schema:
            type: string
            format: date
          description: 'With range=custom: the first day (YYYY-MM-DD).'
        - name: endDate
          in: query
          required: false
          schema:
            type: string
            format: date
          description: 'With range=custom: the last day, up to 90 days after startDate.'
      responses:
        '200':
          description: One row per day.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    enum:
                      - success
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        label:
                          type: string
                        date:
                          type: string
                        scrapeCredits:
                          type: number
                        crawlCredits:
                          type: number
                        searchCredits:
                          type: number
                        parseCredits:
                          type: number
                        mapCredits:
                          type: number
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.