Docs / API reference
Usage and limits
Your plan's limits and how much you've used today and this month.
Request
GET
https://tcgpriceapi.com/v1/usageFree: checking your usage never counts as a request.
curl "https://tcgpriceapi.com/v1/usage" \
-H "X-API-Key: YOUR_API_KEY"import requests
response = requests.get(
"https://tcgpriceapi.com/v1/usage",
headers={"X-API-Key": "YOUR_API_KEY"},
timeout=30,
)
response.raise_for_status()
print(response.json())const response = await fetch("https://tcgpriceapi.com/v1/usage", {
headers: { "X-API-Key": process.env.TCGPRICEAPI_KEY },
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());Response
{
"plan": "Free",
"tier": "lowest",
"limits": {
"requests_per_day": 100,
"requests_per_month": 1500,
"requests_per_minute": 10,
"cards_per_request": 1,
"history_cards_per_request": 1,
"history_days": 7,
"cards_per_day": null
},
"used": {
"requests_today": 12,
"cards_today": 40,
"history_cards_today": 2,
"requests_this_month": 230
}
}The limits are the Free plan's; the used numbers are an illustration.
| Field | Type | Description |
|---|---|---|
plan | string | Your plan, such as "Free" or "Pro". |
tier | string | Your plan's internal name. |
limits | limits object | |
used | used object |
limits
| Field | Type | Description |
|---|---|---|
requests_per_day | integer | Requests allowed each day (UTC). |
requests_per_month | integer | Requests allowed each month (UTC). |
requests_per_minute | integer | Requests allowed in one calendar minute (UTC). Going over gets a 429 answer with a Retry-After header. |
cards_per_request | integer | The most cards one current-price request can ask for. |
history_cards_per_request | integer | The most cards one history request can ask for. |
history_days | integer | The longest sold history your plan includes, in days: 7 on Free, 30 on Starter, 365 on Pro and up. |
cards_per_day | integer or null | Cards allowed each day (UTC), counting prices, history and scans together. null when your plan has no card limit. |
used
| Field | Type | Description |
|---|---|---|
requests_today | integer | Requests counted today (UTC). |
cards_today | integer | Cards looked up for current prices today (history lookups are counted in history_cards_today). Shown for your records; only requests are limited. |
history_cards_today | integer | Cards whose history was looked up today. |
requests_this_month | integer | Requests counted this month (UTC). |