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.

GEThttps://rankfield.dev/v1/bing/suggest/usage

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

import requests

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

const response = await fetch("https://rankfield.dev/v1/bing/suggest/usage", {
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
  },
});
console.log(await response.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.