Остаток просмотров

GET /usage — тариф, лимит запросов в минуту, остаток просмотров и AI-кредитов. Просмотры не тратит.

GET /public/v1/usage

Тариф, остаток просмотров и AI-кредитов. Сам запрос просмотры не тратит, его удобно вызывать перед большой выборкой.

curl https://app.mtwspy.com/public/v1/usage \
  -H "Authorization: Bearer mtw_live_ваш_ключ"

Ответ

{
  "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" }
}
ПолеОписание
plan.code / plan.nameТариф: basic, team, team_api или custom
plan.rate_per_minЛимит запросов в минуту
api_limitПул просмотров: всего, потрачено, осталось. Общий с лентой на сайте
basic_limitТот же пул. Поле оставлено для старых клиентов
requestsЗапросов к API за текущий месяц
credits.remainingСколько AI-кредитов осталось: месячный лимит тарифа плюс докупленные пакеты
credits.limit / credits.usedВсего на период / потрачено в текущем периоде
credits.monthly_limitКредиты тарифа на период. Без действующей подписки — 0
credits.packs_remainingОстаток докупленных пакетов. Пакет действует год с покупки
credits.period_startНачало текущего периода. Период начинается в день месяца, на который приходится продление тарифа
resets_atКогда сгорает ближайший пакет просмотров; null, если активных пакетов нет

AI-кредиты тратятся в AI-студии кабинета, через API их потратить нельзя. credits бывает null, если остаток временно не удалось посчитать.

Просмотры не обнуляются первого числа: пул пополняется при продлении тарифа или докупке в кабинете.

On this page