Często zadawane pytania dotycząceListen API

1. Dlaczego warto korzystać z Listen API zamiast z iTunes API? 🔗

Zawsze masz inne możliwości: możesz zbudować i utrzymywać własną bazę podcastów albo wybrać inne API dostępne w internecie.

Aby ułatwić ocenę Listen API, udostępniamy przejrzysty i prosty cennik oraz pełną dokumentację wszystkich endpointów wraz z przykładowymi odpowiedziami JSON.

Wypróbowanie Listen API jest bardzo łatwe. Nie musisz rozmawiać ze sprzedawcą ani prosić o prezentację. Wystarczy wykupić plan FREE bez podawania danych karty i zacząć korzystać z Listen API.

Użytkownicy planu PRO lub ENTERPRISE mogą w każdej chwili napisać na hello@listennotes.com i szybko uzyskać odpowiedź bezpośrednio od założyciela i CEO Listen Notes.

A co z iTunes API firmy Apple? Warto przeczytać jego dokumentację i samodzielnie je wypróbować. Możesz dojść do wniosku, że nie spełnia Twoich potrzeb, ponieważ:

nie udostępnia wystarczającej liczby endpointów ani ustrukturyzowanych danych, aby zbudować podstawowe funkcje produktu, takie jak wyszukiwanie wszystkich odcinków, odtwarzanie nagrań czy tworzenie playlist — po kilku minutach lektury dokumentacji stanie się to jasne;
zwraca niewiele wyników wyszukiwania podcastów, a ich kolejność jest daleka od idealnej;
warunki korzystania mogą nie zezwalać na planowane zastosowanie — ponownie, można to szybko sprawdzić w dokumentacji;
prawdopodobnie nie jest aktywnie utrzymywane ani rozwijane przez najlepszych pracowników, ponieważ nie stanowi ważnego produktu Apple Inc.;
w przypadku firmowego API pomoc prawdziwych ludzi, np. inżynierów wsparcia, zwykle jest częścią usługi — od pracowników Apple Inc. trudno oczekiwać szybkich i rzeczowych odpowiedzi.

Przydatny może być również nasz artykuł: Jak ocenić zewnętrzne REST API?

2. Jak trudne może być zbudowanie bazy podcastów? 🔗

Zbudowanie dobrej bazy podcastów wymaga stałej pracy. Nie jest szczególnie trudne, ale jej utworzenie i utrzymanie kosztuje czas i pieniądze — na serwery, wynagrodzenia inżynierów itd. Podobnie jak w przypadku samochodu lub domu, początkowy koszt zakupu jest znacznie niższy od późniejszych kosztów utrzymania: podatków, ubezpieczenia, nieprzewidzianych napraw, a przede wszystkim własnego czasu.

Przed zbudowaniem i utrzymywaniem własnej bazy podcastów trzeba uwzględnić kilka kwestii:

W internecie jest co najmniej 3,831,088 podcastów i 196,732,836 odcinków, a liczba treści rośnie coraz szybciej. Musisz samodzielnie hostować dane i dbać o ich aktualność.
Przy skali 3,831,088 podcastów i 196,732,836 odcinków kanały RSS i adresy audio zmieniają się częściej, niż można oczekiwać. Trzeba inwestować w automatyczne narzędzia oraz całodobowe procesy ręcznego porządkowania danych. Są niezbędne, choć niewidoczne dla użytkowników.
Aby przeszukiwać 3,831,088 podcastów i 196,732,836 odcinków według słów kluczowych, trzeba zbudować własną wyszukiwarkę. Jej interfejs może być prosty, ale infrastruktura zaplecza jest niezwykle złożona. Nie bez powodu Google — pozornie „prosta witryna” — zatrudniało w 2022 r. 175 000 pracowników etatowych i setki tysięcy wykonawców.
W internecie jest wiele fałszywych podcastów, np. nagrań generowanych maszynowo. Specjaliści od black-hat SEO tworzą je masowo do budowania linków; nie są przeznaczone dla ludzi. Potrzebujesz automatycznych i ręcznych procesów, które nie dopuszczą ich do bazy. Ciekawostka: Google ma osobny zespół do zwalczania spamu, a Listen Notes również przeznacza wiele zasobów na walkę z fałszywymi podcastami.
Jeśli baza i wyszukiwarka mają działać przez całą dobę, musisz stale zapobiegać awariom serwerów.
Ile kosztuje kompetentny inżynier oprogramowania na pełny etat? Wolisz płacić za zewnętrzną usługę chmurową, taką jak nasze API, czy pensje kilku własnych inżynierów?

Szczerze mówiąc, najdroższą częścią własnej bazy podcastów jest koszt alternatywny. To kwestia wyboru: czasu poświęconego na bazę nie możesz przeznaczyć na budowanie aplikacji lub witryny.

Listen API pozwala od razu rozpocząć najbardziej interesującą część projektu. Prowadzimy też popularną wyszukiwarkę podcastów listennotes.com, z której co miesiąc korzysta ponad 2,000,000 osób. Odgrywają one ważną rolę w aktualizowaniu bazy, np. zgłaszając brakujące podcasty i poprawiając błędne dane. Dzięki całodobowej pomocy ludzi z całego świata możemy utrzymywać bazę wysokiej jakości.

3. Czy aktywnie rozwijacie API i zamierzacie robić to nadal? 🔗

Tak i tak.

Listen API zasila naszą publiczną witrynę ListenNotes.com i korzysta z większości ulepszeń jej zaplecza.

Działamy od 2017 roku i zamierzamy pozostać na rynku przez długi czas.

4. Co się stanie, jeśli zaczniemy korzystać z Listen API, a usługa zostanie kiedyś wyłączona? 🔗

To uzasadniona obawa. Wiemy, że żadna usługa internetowa ani firma nie istnieje wiecznie. Na przykład Google zamknęło wiele własnych produktów.

Jeśli zdecydujemy się wyłączyć Listen API, powiadomimy Cię co najmniej 12 tygodni wcześniej. Będzie można wtedy kupić najnowszy zrzut bazy obejmujący wszystkie podcasty i odcinki w rozsądnie niskiej cenie.

Listen Notes prawdopodobnie przetrwa wiele dobrze finansowanych startupów, a nawet spółek giełdowych. Działamy oszczędnie. W odróżnieniu od większych firm nie zatrudniamy ogromnej liczby osób i nie ponosimy olbrzymich kosztów wynagrodzeń, więc wewnętrzna walka o władzę raczej nie doprowadzi do zamknięcia firmy. Projektujemy solidną infrastrukturę bez marnowania pieniędzy na serwery.

5. Czy zapewniacie pomoc techniczną? 🔗

Tak. Użytkownicy planu PRO lub ENTERPRISE mogą wysłać każde pytanie dotyczące API na hello@listennotes.com. Czasem odpowiadamy również użytkownikom FREE, ale pierwszeństwo mają użytkownicy PRO i ENTERPRISE.

Zamiast przedzierać się przez typową obsługę klienta porozmawiasz bezpośrednio z założycielem i CEO Listen Notes, Inc., który stworzył cały produkt własnymi rękami i z pasją.

6. Będziemy wykonywać bardzo dużo żądań API. Czy obsłużycie taką skalę? 🔗

Niektóre firmy wykonują obecnie za pomocą Listen API dziesiątki milionów żądań miesięcznie. Bez dodawania nowych serwerów możemy z łatwością obsłużyć co najmniej dziesięciokrotnie większy ruch.

Stosujemy sprawdzone praktyki utrzymania infrastruktury oraz rozbudowane monitorowanie i alerty. Gdy w infrastrukturze API wystąpi problem, możemy szybko go zdiagnozować i naprawić. Pod względem wydajności i dostępności mamy bardzo dobre wyniki.

7. Czy możemy buforować odpowiedzi API po stronie klienta, np. w aplikacji lub przeglądarce? 🔗

Tak. Nasze API Terms of Use (plany FREE i PRO) zezwalają na buforowanie odpowiedzi po stronie klienta, ale w planach FREE i PRO nie można ich buforować po stronie serwera, z wyjątkiem identyfikatorów podcastów i odcinków oraz pól pub_date.

Na serwerze, np. we własnej bazie, można więc trwale przechowywać wyłącznie identyfikatory podcastów i odcinków oraz pub_date. Taki zakaz buforowania jest powszechny w API danych, np. w Google Maps API (wyszukaj na stronie „No Scraping”).

Same pliki audio podcastów możesz przechowywać i przetwarzać na serwerze, np. tworząc klipy lub transkrypcje.

W planie ENTERPRISE możesz buforować pełne odpowiedzi API na swoich serwerach.

8. Dlaczego adresy URL nagrań w odpowiedzi API pochodzą z domeny listennotes.com? 🔗

Dla jasności: nie przechowujemy nagrań na własnych serwerach. Podcasterzy otrzymują dokładne statystyki, np. adres IP i user-agent słuchacza.

Rzeczywiste adresy opakowujemy własnymi adresami URL za pomocą HTTP 301, np. audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Podcasty często zmieniają adresy nagrań, a w ten sposób pomagamy Tobie i użytkownikom zawsze dotrzeć pod właściwy adres.

Buforowanie danych po stronie klienta jest powszechną metodą poprawy wydajności aplikacji. Aplikacja przechowuje stały adres Listen Notes, a my po stronie serwera ustalamy aktualny adres nagrania. Stale sprawdzamy, czy podcasty nie zmieniły swoich adresów audio.

9. Co zrobić, jeśli nie możemy znaleźć podcastu albo dane nie są zsynchronizowane z kanałem RSS, np. nagranie nie działa lub metadane są błędne? 🔗

Choć nasza baza podcastów jest bardzo obszerna, czasem możemy nie dodać nowej audycji na czas. Podobnie nowych witryn nie zawsze można od razu znaleźć w Google, ponieważ roboty potrzebują czasu, by je wykryć i zindeksować. Możesz wtedy pomóc, zgłaszając brakujący podcast.

Twórca może też zmienić kanał RSS, zanim zdążymy wykryć zmianę, albo w kanale mogą występować błędy. To przypomina niedziałające lub nieaktualne strony w wynikach Google — ich usunięcie również wymaga czasu. Błędy metadanych zgłoś na hello@listennotes.com, a naprawimy je jak najszybciej, zwykle w ciągu kilku minut. Możesz również samodzielnie poprawić metadane za pomocą naszych narzędzi — pomóż nam dbać o jakość bazy :)

10. Jak dbacie o aktualność bazy podcastów? 🔗

Nowe podcasty znajdujemy na cztery sposoby.

Po pierwsze, nasze roboty przez całą dobę wyszukują publicznie dostępne podcasty w internecie, podobnie jak Google i inne wyszukiwarki znajdują nowe witryny.
Po drugie, podcasterzy samodzielnie zgłaszają nowe audycje do Listen Notes — codziennie otrzymujemy setki takich zgłoszeń.
Po trzecie, pracownicy Listen Notes ręcznie dodają zauważone brakujące podcasty. Prowadzimy też bardzo popularną wyszukiwarkę podcastów listennotes.com, z której co miesiąc korzysta ponad 2,000,000 osób. Każda z nich może zgłosić brakującą audycję, dzięki czemu baza jest kompletna i aktualna. Każde zgłoszenie sprawdzamy ręcznie i odrzucamy fałszywe podcasty, np. nagrania generowane maszynowo.
Po czwarte, współpracujemy z największymi usługami hostingowymi dla podcastów. Integrują one nasze Podcast API, aby twórcy mogli zgłaszać nowe audycje bezpośrednio do Listen Notes.

Przez całą dobę sprawdzamy kanały RSS wszystkich podcastów. W przypadku podcastów ostatnio słuchanych w naszej witrynie lub przez API nowe odcinki trafiają do bazy w ciągu godziny, zwykle po 15–30 minutach. W pozostałych przypadkach pobieramy je w ciągu kilku godzin, zazwyczaj 2–4.

11. Co się stanie, jeśli naruszymy API Terms of Use? 🔗

Konto zostanie zawieszone, jeśli naruszysz nasze API Terms of Use. Od tej decyzji możesz odwołać się e-mailem: hello@listennotes.com.

Dwie najczęstsze przyczyny zawieszenia użytkownika API to: 1. tworzenie wielu kont w celu obejścia limitu planu FREE, zwłaszcza z użyciem jednorazowych adresów e-mail; 2. buforowanie większości danych odpowiedzi po stronie serwera. Upewnij się, że nie naruszasz API Terms of Use.

12. Czy musimy umieszczać logo Listen Notes w aplikacji, nawet jeśli korzystamy z płatnego planu? 🔗

Tak. Nasze API Terms of Use dotyczą wszystkich użytkowników API w planach FREE i PRO. Napis „Powered by Listen Notes” trzeba umieścić tylko na jednym ekranie korzystającym z naszych danych, a nie na każdym. Logo może znajdować się poniżej pierwszego widoku strony, aby nie przeszkadzało użytkownikom.

Nie robimy wyjątków dla użytkowników FREE ani PRO, niezależnie od tego, czy są indywidualnymi deweloperami, czy spółkami publicznymi. Jednorazowe odstępstwa zwiększałyby złożoność operacyjną i odbierały czas, który możemy przeznaczyć na ulepszanie podstawowych produktów.

Wymóg podania źródła jest powszechny w API danych, np. w Google Places i Google Maps API. Uber korzysta w aplikacji z Google Maps i wyświetla w niej duże logo Google.

W planie ENTERPRISE możemy elastycznie podejść do wymogu dotyczącego logo.

13. Czy możemy omówić współpracę telefonicznie? 🔗

Listen API jest usługą samoobsługową. Jeśli w ciągu kilku minut nie można zrozumieć, co potrafi i jak go używać, oznacza to, że nie wyjaśniliśmy tego dostatecznie dobrze. Jeśli masz pytania, zacznijmy od rozmowy e-mailowej: hello@listennotes.com.

Szczegółową odpowiedź otrzymasz od nas e-mailem znacznie szybciej, niż udałoby się umówić rozmowę telefoniczną.

14. Czy mogę używać Listen API na platformach no-code? 🔗

Tak, o ile wybrana platforma no-code umożliwia połączenie z REST API. Listen API pozwala na przykład wyszukiwać podcasty w aplikacjach zbudowanych w Bubble i Retool.

Jeśli chcesz tylko osadzić w witrynie lub blogu odtwarzalne podcasty, odcinki, klipy albo playlisty, Listen API nie jest potrzebne. Możesz je łatwo osadzić w WordPressie, Bloggerze, Ghost, Google Sites, Tumblrze i wielu innych platformach publikacyjnych.

15. Czy udostępniacie biblioteki Podcast API dla poszczególnych języków programowania? 🔗

Tak. Udostępniamy biblioteki dla kilku języków programowania, a w przyszłości dodamy obsługę kolejnych.

16. Jakie informacje Listen Notes zbiera o użytkownikach API? 🔗

Zbieramy minimalny zakres informacji o urządzeniu, które bezpośrednio wysyła żądania API do naszych serwerów: 1) adres IP urządzenia; 2) user-agent; 3) endpoint i parametry żądania. Jest to zasadniczo jeden wpis w logu dostępu Nginx. To wszystko.

Przykładowo deweloper buduje za pomocą naszego API aplikację do podcastów, z której korzystają słuchacze. Żądania API zwykle wysyłają serwery dewelopera, a nie sama aplikacja — serwery pełnią rolę pośrednika między nią a Listen API. Rejestrujemy więc wyłącznie 1) adresy IP serwerów wysyłających żądania; 2) ich user-agent, np. python-requests; 3) endpointy i parametry żądań. Poza tym nie wiemy nic o użytkownikach końcowych aplikacji.

17. Czy Listen API ma limity szybkości, np. N żądań na sekundę? 🔗

Tak. Stosujemy rozsądne limity szybkości dla endpointów API. Przy prawidłowym korzystaniu z API możesz nawet nie zauważyć ich istnienia.

Każde poważne REST API musi mieć limit szybkości — wyszukaj w Google „api rate limit”. Bez limitów API łatwo padłoby ofiarą DDoS. Programista może na przykład w krótkim czasie wysłać ogromną liczbę żądań z ciasnej, a nawet nieskończonej pętli. Od uruchomienia Listen API w 2017 r. widzieliśmy takie sytuacje częściej, niż oczekiwaliśmy. Programiści są ludźmi, a ludzie popełniają błędy. Nie chcemy, aby jeden użytkownik wyłączył cały system i zaszkodził pozostałym.

Plan FREE ma niski limit szybkości, PRO — wyższy, a ENTERPRISE — najwyższy. Limity różnią się też między endpointami, ponieważ niektóre wymagają więcej mocy obliczeniowej. Nowy użytkownik zaczyna ze stosunkowo niskimi limitami, które z czasem zwiększamy.

18. Czy obsługujecie żądania usunięcia podcastów wynikające z DMCA, RODO i podobnych przepisów? 🔗

Tak. Obsługujemy żądania usunięcia treści. Więcej informacji:

Żądania usunięcia treści przesłane w imieniu użytkowników możesz przekierować do Listen Notes przez endpoint DELETE /podcasts/{id} albo po prostu wysłać na hello@listennotes.com.

19. Czy mogę legalnie przesyłać strumieniowo podcasty w aplikacji lub witrynie za pomocą Listen API? 🔗

Oczywiście. Za pomocą Listen API możesz legalnie przesyłać strumieniowo nagrania podcastów w aplikacjach i witrynach. Dowiedz się więcej.

Jeśli App Store odrzuci aplikację z powodu integracji z naszym API, pomożemy Ci rozwiązać problem.