Listen APIЧасто задаваемые вопросы

1. Почему стоит выбрать Listen API вместо iTunes API? 🔗

У вас всегда есть другие варианты: создать и поддерживать собственную базу подкастов или выбрать другое API в интернете.

Чтобы упростить оценку Listen API, мы предлагаем простую и прозрачную модель цен и полную документацию всех эндпоинтов с примерами JSON.

Попробовать Listen API очень легко. Не нужно разговаривать с отделом продаж или запрашивать демонстрацию: просто оформите FREE без банковской карты и начните работу.

Пользователи PRO и ENTERPRISE могут написать любой вопрос на hello@listennotes.com и быстро получить ответ непосредственно от основателя и CEO Listen Notes.

А как насчёт iTunes API от Apple? Изучите документацию и попробуйте его. Оно может не подойти, потому что:

эндпоинтов и структурированных данных недостаточно для базовых функций вроде поиска всех выпусков, воспроизведения аудио и списков;
поиск возвращает мало подкастов, а ранжирование далеко от идеального;
условия могут запрещать нужный сценарий;
API, вероятно, не поддерживается лучшими специалистами Apple, поскольку не является важным продуктом компании;
в корпоративном API поддержка живыми специалистами обычно входит в услугу, но от Apple трудно получить быстрый содержательный ответ.

Также может пригодиться статья: Как оценить стороннее REST API?

2. Насколько сложно создать базу данных подкастов? 🔗

Создание хорошей базы подкастов требует постоянной работы. Это не сложно, но нужны время и деньги на серверы, зарплаты инженеров и обслуживание. Как с автомобилем или домом, первоначальная покупка обходится намного дешевле дальнейшего содержания: налогов, страховки, непредвиденного ремонта и, главное, вашего времени.

Перед созданием собственной базы учтите:

В интернете не менее 3,831,088 подкастов и 196,732,836 выпусков, и объём растёт всё быстрее. Вам придётся размещать данные и поддерживать их актуальность.
При масштабе 3,831,088 подкастов и 196,732,836 выпусков RSS и URL аудио меняются чаще, чем кажется. Нужны автоматические инструменты и круглосуточные ручные процессы очистки — необходимая, но невидимая пользователям работа.
Для поиска по 3,831,088 подкастов и 196,732,836 выпусков нужно создать поисковую систему. Интерфейс может быть простым, но серверная инфраструктура чрезвычайно сложна. Не случайно Google, кажущийся «простым сайтом», в 2022 году имел 175 000 штатных сотрудников и сотни тысяч подрядчиков.
В интернете много поддельных подкастов, например машинно созданного аудио. Специалисты black-hat SEO массово создают их ради ссылок; людям они не предназначены. Нужны автоматические и ручные проверки, чтобы исключать их из базы. Интересный факт: у Google есть отдельная команда борьбы со спамом, и Listen Notes также тратит на подделки много ресурсов.
Если база и поиск должны работать круглосуточно, необходимо постоянно предотвращать сбои серверов.
Сколько стоит компетентный штатный инженер? Выгоднее оплачивать сторонний облачный сервис, такой как наше API, или зарплаты нескольких собственных инженеров?

Честно говоря, самая дорогая часть собственной базы — альтернативные издержки. Время, потраченное на базу, нельзя использовать для создания приложения или сайта.

Listen API позволяет сразу заняться самой интересной частью проекта. Кроме того, мы поддерживаем популярную поисковую систему listennotes.com, которой ежемесячно пользуются более 2,000,000 человек. Они помогают обновлять базу: сообщают об отсутствующих подкастах и исправляют ошибки. Благодаря круглосуточной помощи людей со всего мира мы поддерживаем высокое качество базы.

3. Поддерживаете ли вы API и планируете ли продолжать? 🔗

Да на оба вопроса.

Listen API обеспечивает работу публичного сайта ListenNotes.com и получает большинство улучшений его серверной части.

Мы работаем с 2017 года и планируем продолжать ещё долго.

4. Что произойдёт, если мы внедрим Listen API, а сервис в будущем закроется? 🔗

Опасение справедливо: ни один онлайн-сервис или компания не существует вечно. Например, Google закрыл множество собственных продуктов.

Если мы решим закрыть Listen API, то предупредим минимум за 12 недель. Вы сможете недорого купить последнюю копию базы со всеми подкастами и выпусками.

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

5. Предоставляете ли вы техническую поддержку? 🔗

Да. Пользователи PRO и ENTERPRISE могут отправлять любые вопросы об API на hello@listennotes.com. Иногда мы отвечаем пользователям FREE, но приоритет у платных клиентов.

Вместо общения с безликой службой поддержки вы поговорите непосредственно с основателем и CEO Listen Notes, Inc., который создал весь продукт своими руками и с душой.

6. Мы будем выполнять огромное число запросов. Справится ли API с такой нагрузкой? 🔗

Некоторые компании выполняют через Listen API десятки миллионов запросов в месяц. Мы легко справимся с десятикратным ростом трафика без новых серверов.

Мы применяем лучшие практики эксплуатации, мониторинга и оповещений. При проблеме с инфраструктурой можем быстро найти и устранить причину. У нас отличная история производительности и доступности.

7. Можно ли кэшировать ответ API на стороне клиента, например в приложении или браузере? 🔗

Да. Наши API Terms of Use (планы FREE и PRO) разрешают кэшировать ответы на клиенте, но не на сервере, кроме id подкастов/выпусков и pub_dates.

Таким образом, на сервере, например в собственной базе, можно постоянно хранить только эти id и pub_dates. Такой запрет распространён среди API данных, например в Google Maps API (найдите «No Scraping»).

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

В ENTERPRISE разрешено кэшировать полные ответы.

8. Почему URL аудио в ответах API относятся к домену listennotes.com? 🔗

Уточним: мы не храним аудио на своих серверах. Авторы получают точную аналитику, например IP и user-agent слушателя.

Реальные адреса оборачиваются нашими URL через HTTP 301, например audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Подкасты часто меняют URL аудио, а так пользователи всегда попадают по правильному адресу.

Для производительности приложения обычно кэшируют данные на клиенте. Они сохраняют постоянный URL Listen Notes, а мы на сервере определяем актуальный адрес аудио и постоянно проверяем изменения.

9. Что делать, если подкаст не найден или данные не синхронизированы с RSS, например не работает аудио или неверны метаданные? 🔗

Хотя база очень полна, иногда мы не успеваем добавить новый подкаст. Аналогично новые сайты не сразу появляются в Google: роботам нужно время на обнаружение и индексацию. Вы можете сообщить об отсутствующем подкасте.

Автор также может изменить RSS, прежде чем мы заметим, или в ленте могут быть ошибки. Это похоже на устаревшие страницы и ошибки 404 в Google — исправление занимает время. Сообщите об ошибке метаданных на hello@listennotes.com, и мы быстро её исправим, обычно за несколько минут. Можно также самостоятельно исправить данные нашими инструментами — помогите поддерживать качество :)

10. Как вы поддерживаете базу подкастов в актуальном состоянии? 🔗

Новые подкасты находятся четырьмя способами.

Наши роботы круглосуточно ищут общедоступные подкасты, как Google обнаруживает сайты.
Авторы самостоятельно отправляют новые подкасты — ежедневно поступают сотни заявок.
Сотрудники Listen Notes вручную добавляют найденные отсутствующие подкасты. Кроме того, поисковой системой listennotes.com ежемесячно пользуются более 2,000,000 человек. Каждый может сообщить об отсутствующем подкасте, помогая сохранять полноту и актуальность базы. Каждая заявка проверяется вручную, а поддельные подкасты отклоняются.
Мы сотрудничаем с крупными хостингами, которые интегрируют Podcast API для прямой отправки новых подкастов.

RSS всех подкастов проверяются круглосуточно. Для недавно прослушанных через сайт или API новые выпуски добавляются в течение часа, обычно за 15–30 минут. Остальные обновляются за несколько часов, как правило за 2–4.

11. Что произойдёт при нарушении API Terms of Use? 🔗

При нарушении API Terms of Use аккаунт будет заблокирован. Решение можно обжаловать по адресу hello@listennotes.com.

Две самые частые причины: 1. создание нескольких аккаунтов для обхода квоты FREE, особенно с одноразовыми адресами; 2. кэширование большей части ответов на сервере. Соблюдайте API Terms of Use.

12. Нужно ли показывать логотип Listen Notes в приложении при платном плане? 🔗

Да. Наши API Terms of Use относятся ко всем пользователям FREE и PRO. Надпись «Powered by Listen Notes» нужна лишь на одном экране с нашими данными, а не на каждом. Логотип можно разместить ниже первого экрана, чтобы он не мешал.

Мы не делаем исключений ни для отдельных разработчиков, ни для публичных компаний. Разовые изменения повышают сложность работы и отнимают время от улучшения основных продуктов.

Указание источника распространено в API данных, например в Google Places и Maps API. Uber использует Google Maps и показывает в приложении крупный логотип Google.

В ENTERPRISE требование к логотипу может быть гибким.

13. Можно ли обсудить сотрудничество по телефону? 🔗

Listen API предназначен для самостоятельного использования. Если за несколько минут нельзя понять его возможности и способ работы, значит, мы плохо всё объяснили. С вопросами сначала напишите на hello@listennotes.com.

Подробный ответ по электронной почте придёт гораздо быстрее, чем удастся назначить звонок.

14. Можно ли использовать Listen API на no-code-платформах? 🔗

Да, если выбранная no-code-платформа умеет подключаться к REST API. Например, Listen API позволяет искать подкасты в приложениях на Bubble и Retool.

Если нужно лишь встроить на сайт или в блог воспроизводимые подкасты, выпуски, фрагменты или списки, Listen API не требуется. Их легко встроить в WordPress, Blogger, Ghost, Google Sites, Tumblr и другие платформы.

15. Есть ли библиотеки Podcast API для разных языков программирования? 🔗

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

16. Какие данные Listen Notes собирает о пользователях API? 🔗

Мы собираем минимум данных об устройстве, которое непосредственно отправляет запросы на наши серверы: 1) IP-адрес; 2) user-agent; 3) эндпоинт и параметры. По сути, это одна строка журнала доступа Nginx. И всё.

Например, разработчик создаёт приложение, которым пользуются слушатели. Обычно запросы идут с серверов разработчика, выступающих посредником между приложением и Listen API. Поэтому мы видим лишь 1) IP серверов; 2) их user-agent, например python-requests; 3) эндпоинты и параметры. О конечных пользователях нам больше ничего не известно.

17. Есть ли в Listen API ограничения частоты, например N запросов в секунду? 🔗

Да. Для эндпоинтов действуют разумные ограничения частоты. При правильном использовании вы можете их даже не заметить.

Любому серьёзному REST API нужны ограничения — найдите в Google «api rate limit». Без них API легко вывести из строя DDoS-атакой. Например, программа может отправить огромное число запросов из короткого или бесконечного цикла. С 2017 года это происходило чаще, чем мы ожидали. Разработчики — люди, а люди ошибаются. Один пользователь не должен нарушать работу всей системы.

У FREE низкий лимит, у PRO выше, у ENTERPRISE самый высокий. Он различается и по эндпоинтам, поскольку некоторые требуют больше вычислений. Новые пользователи начинают с относительно низких значений, которые со временем повышаются.

18. Обрабатываете ли вы запросы на удаление подкастов по DMCA, GDPR и аналогичным законам? 🔗

Да. Мы обрабатываем запросы на удаление. Подробнее:

Запросы от имени пользователей можно направлять через DELETE /podcasts/{id} или на hello@listennotes.com.

19. Можно ли законно транслировать аудио подкастов в приложениях и на сайтах через Listen API? 🔗

Да. Через Listen API можно законно транслировать аудио подкастов в приложениях и на сайтах. Подробнее.

Если App Store отклонит приложение из-за интеграции с нашим API, мы поможем решить проблему.