Remaining views
GET /usage — plan, requests per minute, remaining views and AI credits. Free.
GET /public/v1/usageYour plan, remaining views and AI credits. The call itself is free, so it's handy before a large pull.
curl https://app.mtwspy.com/public/v1/usage \
-H "Authorization: Bearer mtw_live_your_key"Response
{
"data": {
"plan": { "code": "team_api", "name": "Team API", "rate_per_min": 60 },
"api_limit": {
"period": "2026-11", "limit": 60000, "used": 12340, "remaining": 47660,
"resets_at": "2026-11-30T23:59:59+03:00", "plan": "team_api", "unit": "views"
},
"basic_limit": { "limit": 60000, "used": 12340, "remaining": 47660 },
"requests": 128,
"credits": {
"limit": 600, "used": 150, "remaining": 450,
"monthly_limit": 400, "packs_remaining": 200,
"period_start": "2026-11-12T00:00:00+03:00"
},
"resets_at": "2026-11-30T23:59:59+03:00"
},
"meta": { "request_id": "e24395ec17c30d4c" }
}| Field | Description |
|---|---|
plan.code / plan.name | Plan: basic, team, team_api or custom |
plan.rate_per_min | Requests per minute |
api_limit | View balance: total, used, remaining. Shared with the feed on the website |
basic_limit | The same balance. Kept for older clients |
requests | API requests this month |
credits.remaining | AI credits left: the plan's monthly allowance plus purchased packs |
credits.limit / credits.used | Total for the period / spent in the current period |
credits.monthly_limit | Credits included in the plan for the period. 0 without an active subscription |
credits.packs_remaining | What's left of purchased packs. A pack is valid for a year from purchase |
credits.period_start | Start of the current period. Periods start on your plan's renewal day of the month |
resets_at | When the nearest view package expires; null if no package is active |
AI credits are spent in the dashboard AI studio; the API can't spend them. credits can be null if the balance couldn't be calculated at the moment.
Views don't reset on the first of the month: the balance is topped up when your plan renews or when you buy extra views in the dashboard.