Listen APIЧасто задаваемые вопросы по вопросам выставления счетов

API ВЕРСИЯ: V2 · PodcastAPI.com

Ответы на вопросы об оплате.

Прочитайте https://www.podcastapi.com/llms-full.txt, чтобы я мог задавать вопросы о Podcast API от Listen Notes.

Вопросы? hello@listennotes.com

1. Можно ли пользоваться Listen API бесплатно? 🔗

Да. У нас есть план FREE. Рекомендуем начать с него и при необходимости перейти на более высокий. Для FREE не нужно указывать данные банковской карты.

2. Храните ли вы мои платёжные данные? 🔗

Нет. Мы не храним и не можем хранить данные банковской карты в своей базе. Платежи обрабатывают Stripe и PayPal, как у Uber, Shopify, Reddit, Spotify, Instacart и многих других компаний.

3. Что произойдёт при превышении квоты? 🔗

В плане FREE при превышении запросов в месяц доступ приостанавливается, например возвращается HTTP 429. Счётчик сбрасывается в конце периода. Ключ API действует, пока вы его не сбросите.

В PRO и ENTERPRISE дополнительные запросы сверх бесплатной квоты оплачиваются (для PRO — 5 000 в месяц). Используется ступенчатая тарификация, как во многих API, например Google Maps API. Изучите цены и калькулятор.

4. Когда будет списана плата за план PRO? 🔗

Расчётный период составляет месяц. Если оформить PRO 24 марта в 8:00, первая плата будет списана 24 апреля в 8:00 за период с 24 марта, следующая — 24 мая за следующий месяц, затем 24 июня и так далее.

При переходе с PRO на FREE пропорциональная сумма списывается сразу. В панели API она обновляется каждые 10 минут.

5. Взимается ли плата за запросы, завершившиеся ошибкой? 🔗

Нет. Учитываются только запросы с успешным ответом HTTP 200. Запросы HEAD также не оплачиваются.

6. Как оформляется возврат средств? 🔗

Если нужен возврат, например из-за нашей ошибки, мы оформим его через Stripe для оплаты картой или через PayPal. По вопросам оплаты пишите на hello@listennotes.com.

7. Нужно ли менять ключ API в коде при переходе с FREE на PRO или обратно? 🔗

Нет. Ключ API продолжит работать, пока вы не сбросите его.

8. Как отменить план? 🔗

Если вы используете FREE, ничего делать не нужно: плата никогда не взимается.

Если у вас PRO, перейдите на FREE.

Если у вас ENTERPRISE, напишите: hello@listennotes.com.

9. Я использую Listen API v1 через RapidAPI. Как перейти на Listen API v2? 🔗

По эндпоинтам, параметрам и JSON-ответам Listen API v2 почти обратно совместим с v1 (с мая 2019 года), а его цены проще.

Listen API v1 размещался на RapidAPI, которая обрабатывала аналитику и платежи. По мере развития Listen Notes нам понадобились возможности настройки и гибкость, недоступные на сторонней платформе. Поэтому мы создали Listen API v2 на замену RapidAPI.

Для перехода на v2 выполните три шага:

Оформите на этой странице план FREE или PRO.
В коде измените базовый URL на https://listen-api.listennotes.com, версию во всех эндпоинтах на v2 и используйте новый ключ в заголовке X-ListenAPI-Key. Полный URL можно скопировать со страницы документации.
Напишите на hello@listennotes.com, чтобы мы включили режим обратной совместимости. Без него ответы v1 и v2 немного различаются.

Заголовки X-RateLimit-* из v1 отсутствуют в v2. Вместо них v2 возвращает X-ListenAPI-FreeQuota и X-ListenAPI-Usage.

Listen API v1 продолжит работать, поэтому переходить можно без спешки. Однако все будущие улучшения появятся только в v2.

10. Я пользуюсь планом PRO. Что произойдёт, если платёж не пройдёт, например из-за утери или истечения срока карты? 🔗

Сначала мы уведомим вас по электронной почте. Как можно скорее обновите данные карты.

Пока платёж не проходит, мы можем ограничить частоту запросов. При превышении лимита API будет возвращать ошибку 429 Too Many Requests.

Если в течение 12 часов списать средства по-прежнему не удастся, нам придётся приостановить доступ к Listen API.

11. У нас хорошо финансируемый стартап, младший backend-разработчик получает $140 тыс. в год, а фрилансерам мы платим $150 в час, но не можем позволить себе PRO за $200.00 в месяц. Можно получить его бесплатно или со скидкой? 🔗

Нет. Желаем успехов вашему бизнесу.

Щедрого плана FREE достаточно для многих задач. Можно пользоваться им бессрочно, пока он отвечает вашим потребностям. Когда проект перерастёт возможности FREE, Listen API уже будет играть важную роль в бизнесе. Тогда следует оплатить и перейти на PRO, как поступают другие добросовестные компании и разработчики.

Listen Notes — небольшой стартап, поэтому у нас мало штатных сотрудников. Вместо этого мы используем множество SaaS и API других компаний. Если сервис экономит час работы инженера, мы с готовностью платим за него $100. Так мы оцениваем разумность цены SaaS и API. Можно потратить небольшую сумму и сберечь ценное время либо потратить много времени ради копеечной экономии. Учитывайте стоимость своего часа, часа разработчиков и альтернативные издержки.

12. Нужна ли учётная запись Stripe для оплаты плана PRO? 🔗

Нет. План PRO можно оплатить картой Visa, Mastercard, American Express, Discover, Diners Club или JCB.

Если карта недоступна, можно использовать PayPal. В этом случае потребуется учётная запись PayPal.

13. Что считается запросом API? Считается ли запросом показ изображения или воспроизведение аудио? 🔗

Запрос API — это успешный HTTP-запрос с кодом 200 к любому эндпоинту на странице документации API. Запросы изображений, аудио и вебхуков НЕ считаются запросами API.

14. Почему сразу после оформления PRO списывается $140.00? 🔗

Это депозит, который будет вычтен из первого счёта. Например, после месяца на PRO сумма может составить $360.80. Благодаря депозиту $140.00 в конце первого периода останется заплатить только $220.80.

Раньше некоторые пользователи оформляли PRO, но не оплачивали его. Депозит позволяет нам снизить этот риск.

15. Что такое план ENTERPRISE и стоит ли его оформить? 🔗

Главное о плане ENTERPRISE:

Гарантированная месячная квота от 35 000 запросов — чем выше квота, тем больше скидка.
Годовой договор с оплатой раз в год.
Логотип не требуется размещать в приложении или на сайте.
Более мягкие правила серверного кэширования, включая хранение полных ответов в течение срока обслуживания.
Лучшие SLA и поддержка по телефону.

Чтобы оформить ENTERPRISE:

1) Сообщите желаемую минимальную месячную квоту (не менее 35 000 запросов). Обсудите её с технической командой или несколько месяцев используйте PRO, чтобы лучше понять расход. Мы подготовим предложение и договор для проверки.

2) Если всё устроит, подпишем договор, вы внесёте годовую плату, а мы переведём аккаунт на ENTERPRISE.

16. Нужно ли платить за план PRO, если я не выполнил ни одного запроса? 🔗

Нет. С 18 января 2023 года при нулевом числе запросов за период плата составляет $0.

Если выполнен хотя бы один запрос, взимается базовая плата $200.00 и возможная доплата за превышение. Подробнее на странице цен.

Примеры:

Апрель 2023: 500 запросов; $200.00 (базовая плата $200.00 + превышение $0).
Май 2023: 0 запросов; $0.
Июнь 2023: 800 запросов; $200.00 (базовая плата $200.00 + превышение $0).
Июль 2023: 0 запросов; $0.