---
title: "Current usage and limits"
method: GET
path: "/api/me/usage"
tags: ["Account"]
---

# Current usage and limits

`GET /api/me/usage`

## Request

- Base URL: `https://www.audioscrape.com`
- URL: `https://www.audioscrape.com/api/me/usage`
- Auth: HTTP bearer

Returns this calendar month's usage counters (searches, semantic searches, data calls, keyword alerts) alongside the plan's configured limits. Use it to handle 429 responses proactively — check usage before a heavy burst and back off if you're close to a cap.

## Response `200`

Usage counters vs plan limits

- UsageResponse
  - `data_calls` UsageCounter, required
    - `limit` integer, nullable: Configured plan limit for the period. `null` if unlimited.
    - `used` integer, required: Count used in the current period.
  - `keyword_alerts` UsageCounter, required
    - `limit` integer, nullable: Configured plan limit for the period. `null` if unlimited.
    - `used` integer, required: Count used in the current period.
  - `period` string, required: Calendar month the usage counters cover (UTC, format `YYYY-MM`).
  - `searches` UsageCounter, required
    - `limit` integer, nullable: Configured plan limit for the period. `null` if unlimited.
    - `used` integer, required: Count used in the current period.
  - `semantic_searches` UsageCounter, required
    - `limit` integer, nullable: Configured plan limit for the period. `null` if unlimited.
    - `used` integer, required: Count used in the current period.

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api.md) · [All operations](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/audioscrape/apis/audioscrape-rest-api/revisions/29b5788227cf?raw)