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

# Get usage and capacity

> See how many keywords your key has used today on a suggest engine, its jobs and requests by status, and the engine's delivery tiers.

`GET https://rankfield.dev/v1/bing/suggest/usage`

```bash cURL
curl 'https://rankfield.dev/v1/bing/suggest/usage' \
  -H 'Authorization: Bearer YOUR_API_KEY'
```

```python Python
import requests

response = requests.get(
    "https://rankfield.dev/v1/bing/suggest/usage",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
print(response.json())
```

```javascript JavaScript
const response = await fetch("https://rankfield.dev/v1/bing/suggest/usage", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.json());
```

```json 200
{
  "day": "2026-10-26",
  "admittedKeywords": 10240,
  "limits": "off",
  "jobs": [{ "status": "completed", "jobs": 5, "keywords": 10120, "succeeded": 10120 }],
  "live": [{ "status": 200, "requests": 120 }]
}
```

Each engine has its own `/usage` and `/capacity`: `{base path}/usage`, `{base path}/capacity`.

## Usage

| Field | Type | Description |
|---|---|---|
| `day` | string | The UTC day the counts cover. |
| `admittedKeywords` | integer | Keywords used today. |
| `limits` | string | `off`: no per-key limits for now. |
| `jobs` | array | Every job this key has started on this engine, counted by status: `{status, jobs, keywords, succeeded}`. |
| `live` | array | Single-keyword requests by status, `{status, requests}`, counted since the key first used this engine (not reset daily). Requests still in flight come first, with `status: null`. |

## Capacity

`GET {base path}/capacity` describes the engine: `"limits": "off"` (no per-key limits), and `deliveryTiers` with each tier's target (`live` 6 s, `priority` 60 s, `standard` 300 s). Targets are design values, not a measured guarantee.