Лимиты и тарификация

Цена вызоваКопировать ссылку

Вы платите за ответы, а не попытки: списывается только 200. Ошибки, таймауты и пустые поиски бесплатны.

/discover/* — Обзор, /analytics/* — Аналитика, /resolve* — Resolve. GET /stats — публичный счётчик каталога (Статистика), без ключа и оплаты. /resolve/batch принимает до 100 кодов и тарифицирует группу за каждые начатые 10 уникальных.

Новые аккаунты получают $0.02 кредитов, около 50 поисков: хватит на небольшой проект.

Большие страницы стоят дорожеКопировать ссылку

/query, /idols и /random принимают num от 1 до 50. Цены выше — за 10 результатов; больше — цена растёт пропорционально странице, с округлением вверх:

cost = max(base price, base price × num ÷ 10)

Для /query, за 1000 вызовов:

Пять вызовов с num=10 стоят как один с num=50. Размер страницы — удобство, не способ сэкономить.

Та же формула — для /discover/* и /analytics/*, где у части эндпоинтов num по умолчанию выше 10 и вызов уже дороже базовой ставки:

Передайте num=10 или меньше для базовой ставки. Эндпоинты вне таблицы не принимают num (или по умолчанию 10 и меньше) и всегда стоят по базовой.

Пустой результат — не ошибкаКопировать ссылку

/query без совпадений вернёт 200 с count: 0 и пустым results, бесплатно. Проверяйте count, а не код состояния.

Доставка превьюКопировать ссылку

Превью-ролики раздаются с cdn.javinfo.dev и тарифицируются по объёму, а не по вызовам: $0.30 за ГБ, только при первой загрузке из источника. Дальше они живут в нашем объектном хранилище, и все следующие просмотры бесплатны для всех.

Качество зависит от аккаунта: после первого пополнения — лучшая версия тайтла, до него — стандартная.

URL видео привязаны к аккаунту и не истекают: ссылка годичной давности работает. Но любой, кому вы её дадите, смотрит за счёт вашего баланса. Берегите ссылки на превью как API-ключ.

Как часто можно вызыватьКопировать ссылку

Лимиты на аккаунт, общие для всех ключей.

При превышении — 429 и Retry-After со временем ожидания. Ограничение снимается само после первого платежа, без заявок.

Часовые лимиты для живых провайдеровКопировать ссылку

FANZA, DMM и провайдеры из нашего каталога не имеют часового лимита. Те, кого мы опрашиваем у источника при каждом запросе, стоят настоящего запроса и делят общий часовой бюджет:

• 6000 результатов в час на аккаунт. Сверх этого /query возвращает 429 с Retry-After.
• 3000 вызовов в час на провайдера, суммарно по всем. Когда один загружен, мы убираем его из поиска и отвечаем через остальные. Если он закреплён через providers=, откатываться некуда и вы получите 503 с Retry-After.

Обычная нагрузка до этих цифр не дотягивает: бюджет аккаунта заметно выше самого напряжённого нормального часа. Он нужен, чтобы один сорвавшийся скрипт не подставил источник под блокировку всем.

Ещё защита: страница дальше 50-й с пустым q возвращает 422. Уходить вглубь фильтра без поискового текста — выкачивание каталога, не поиск. Добавьте q или сузьте фильтр.

Когда кредиты заканчиваютсяКопировать ссылку

API возвращает 402 Payment Required и ничего не списывает. Retry-After — час, подсказка автоматическим клиентам, не блокировка: пополните счёт, и следующий вызов пройдёт сразу.

Пополнить счёт можно в панели управления. Платёж от $15 добавляет бонус сверх суммы, от $50 — максимальный, до 10%. Точный процент разыгрывается для каждого платежа и меняется внутри уровня.

Заголовки ответовКопировать ссылку

• X-Response-Time-Ms — время обработки на сервере.
• X-Balance-Remaining — кредиты после вызова.
• X-Cache: HIT | MISS — ответ из кэша. Присутствует на /movie, /query, /idols и кэшируемых эндпоинтах Обзора, Аналитики и Resolve. Попадание бесплатно.
• X-Degraded — не удалось прочитать индексы при сборке ответа; значение — число неудачных чтений. Ответ бесплатный и не кэшируется.
• Retry-After — присутствует в 429, 402 и 503. Учитывайте его.

Полный список кодов — в Ошибки.