Listen APIofte stillede spørsmål

API-VERSJON: V2 · PodcastAPI.com

Svar på generelle spørsmål om Listen API.

Les fra https://www.podcastapi.com/llms-full.txt, så jeg kan stille spørsmål om Podkast API fra Listen Notes.

Spørsmål? hello@listennotes.com

1. Hvorfor bør jeg bruke Listen API i stedet for iTunes API? 🔗

Du har alltid andre alternativer: bygg og vedlikehold din egen database, eller velg en annen Podcast API på Internett.

For å gjøre vurderingen enklere tilbyr vi en enkel og gjennomsiktig prismodell og omfattende dokumentasjon for alle endpoints og eksempelresponser i JSON.

Listen API er lett å prøve: Du trenger ikke snakke med selgere eller be om en demo. Abonner på FREE uten kortinformasjon og kom i gang.

PRO- og ENTERPRISE-kunder kan sende spørsmål til hello@listennotes.com og snakke direkte med grunnleggeren og CEO-en i Listen Notes.

Hva med Apples iTunes API? Les dokumentasjonen og prøv selv. Den kan være mindre egnet fordi

den mangler endpoints og strukturerte data for enkelte grunnleggende funksjoner;
søkeresultatene er få og rangeringen lite ideell;
vilkårene kan forby ønsket bruk;
den vedlikeholdes kanskje ikke aktivt fordi den ikke er et kjerneprodukt for Apple;
menneskelig kundestøtte er viktig for enterprise-API-er, men raske svar fra Apple kan være vanskelige å få.

Denne artikkelen kan hjelpe: How to evaluate a 3rd party RESTful API?

2. Hvor vanskelig er det å bygge en podkastdatabase? 🔗

Å bygge en god podkastdatabase er et kontinuerlig arbeid. Det er ikke vanskelig, men krever tid og penger til servere og utviklere. Som med bil eller bolig koster vedlikehold og tiden din mer enn innkjøpet.

Vurder følgende:

Internett har minst 3,789,159 podkaster og 191,276,100 episoder, og mengden vokser raskt. Dataene må hostes og oppdateres.
Med 3,789,159 podkaster og 191,276,100 episoder endres RSS-feeder og lyd-URL-er oftere enn forventet. Automatiske verktøy og manuelle rutiner må rydde døgnet rundt.
Nøkkelordsøk i 3,789,159 podkaster og 191,276,100 episoder krever en søkemotor. Grensesnittet er enkelt, men backend er svært komplisert – det er en grunn til at Google hadde 175 000 heltidsansatte i 2022 og hundretusenvis av konsulenter.
Det finnes mange falske podkaster med maskingenerert lyd eller Black Hat SEO. Automatiske og manuelle kontroller er nødvendige. Google har et eget spamteam; Listen Notes bruker også betydelige ressurser.
Døgnkontinuerlig database og søkemotor krever arbeid for å unngå serveravbrudd.
Sammenlign kostnaden for dyktige heltidsutviklere med en skytjeneste som API-et vårt.

Den største kostnaden er egentlig alternativkostnaden. Tid brukt på databasen kan ikke brukes på appen eller nettstedet.

Listen API lar deg starte den viktigste delen av prosjektet umiddelbart. Over 2,000,000 personer bruker listennotes.com hver måned og hjelper med å sende inn manglende podkaster og rette data. Hjelpen fra hele verden opprettholder kvaliteten.

3. Støtter dere API-et aktivt, og vil dere fortsette med det? 🔗

Ja og ja.

Listen API driver det offentlige nettstedet ListenNotes.com og nyter godt av de fleste backend-forbedringene i Listen Notes. Vi har vært i drift siden 2017 og planlegger å fortsette lenge.

4. Hva skjer hvis Listen API legges ned i fremtiden? 🔗

Bekymringen er forståelig. Ingen nettjenester eller selskaper varer evig. Google har for eksempel lagt ned mange produkter.

Hvis Listen API legges ned, varsler vi minst 12 uker før, og du kan kjøpe den nyeste databasedumpen med alle podkaster og episoder til en rimelig lav pris.

Listen Notes kan overleve mange godt finansierte startups og børsnoterte selskaper. Vi drives nøkternt, uten et stort antall ansatte og lønnsutgifter. Infrastrukturen er robust uten unødvendige serverkostnader.

5. Tilbyr dere kundestøtte? 🔗

Ja. PRO- og ENTERPRISE-brukere kan sende API-spørsmål til hello@listennotes.com. Ved feilsøking kan vi be om eksempelkode eller request/response. Personlig støtte garanteres ikke for FREE, men dokumentasjon og FAQ er tilgjengelig.

6. Kan dere håndtere svært mange API-forespørsler? 🔗

Enkelte selskaper kjører allerede titalls millioner forespørsler per måned med Listen API. Vi kan håndtere minst ti ganger dagens trafikk uten flere servere.

Kontakt hello@listennotes.com hvis du planlegger svært stor skala, så kan vi hjelpe med kapasitetsplanlegging.

7. Kan API-responsen hurtigbufres på klientsiden, for eksempel i appen eller nettleseren? 🔗

Ja. API Terms of Use for FREE og PRO tillater hurtigbufring på klientsiden, men ikke på serveren, bortsett fra podcast/episode id og pub_date.

Bare id-er og pub_date kan lagres permanent på serveren eller i egen database. Slike regler er vanlige for data-API-er, for eksempel Google Maps API (søk etter «No Scraping»).

Selve lydfilene kan lagres og behandles på serveren, for eksempel til klipp eller tale-til-tekst.

Med ENTERPRISE kan hele responsen hurtigbufres på serveren.

8. Hvorfor bruker lyd-URL-ene i API-responsen domenet listennotes.com? 🔗

Vi lagrer ikke lyd på egne servere. Podkasterne mottar fortsatt korrekte analysedata som lytterens IP og user-agent.

Fordi lyd-URL-er endres ofte, pakker vi inn de faktiske URL-ene med permanente Listen Notes-URL-er via HTTP 301, for eksempel audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d.

Apper hurtigbufrer vanligvis data på klienten for ytelse. De lagrer den permanente Listen Notes-URL-en, mens serveren vår finner riktig lyd-URL og kontrollerer endringer kontinuerlig.

9. Hva gjør vi hvis en podkast mangler eller dataene ikke samsvarer med RSS-feeden, for eksempel ødelagt lyd eller feil metadata? 🔗

Selv om databasen er omfattende, kan enkelte nye programmer mangle en stund, slik Google trenger tid til å finne og indeksere nye nettsteder. Du kan hjelpe ved å sende inn manglende programmer.

Skaperen kan også ha endret RSS-feeden før vi oppdaget det, eller feeden kan inneholde feil. Dette ligner gamle eller 404-sider i Google-resultater. Rapporter metadatafeil til hello@listennotes.com; vanligvis retter vi dem i løpet av få minutter. Du kan også bruke selvbetjeningsverktøy til å rette metadata :)

10. Hvordan holder dere podkastdatabasen oppdatert? 🔗

Vi finner nye podkaster på fire måter.

Crawlere søker døgnet rundt etter offentlig tilgjengelige podkaster.
Podkastere sender inn nye programmer selv; vi mottar hundrevis hver dag.
Ansatte legger manuelt til podkaster som mangler. Over 2,000,000 personer bruker listennotes.com hver måned og kan sende inn manglende programmer. Alle innsendinger vurderes, og falske podkaster avvises.
Store podkasthoteller integrerer med vår Podcast API, slik at programmer kan sendes inn direkte.

Alle RSS-feeder kontrolleres døgnet rundt. Nye episoder for nylig avspilte podkaster legges til innen én time, vanligvis 15–30 minutter. Andre oppdateres som regel innen 2–4 timer.

11. Hva skjer hvis vi bryter API Terms of Use? 🔗

Kontoen stanses hvis API Terms of Use brytes. Send en klage til hello@listennotes.com.

De vanligste årsakene er 1. flere kontoer for å omgå FREE-kvoten, særlig med engangsadresser; 2. hurtigbufring av mesteparten av responsdataene på serveren. Følg API Terms of Use.

12. Må Listen Notes-logoen vises i appen også med et betalt abonnement? 🔗

Ja. API Terms of Use gjelder alle FREE/PRO-brukere. Det holder å vise «Powered by Listen Notes» på én skjerm som bruker dataene våre, ikke alle.

ENTERPRISE krever ikke logo.

Den innebygde HTML-spilleren og Listen API er forskjellige produkter. Spillerlogoen kan ikke fjernes selv med et betalt API-abonnement.

13. Kan vi diskutere samarbeidet på telefon? 🔗

Listen API er laget for selvbetjening. Hvis funksjon og bruk ikke er forståelig i løpet av få minutter, må vi forbedre designet eller dokumentasjonen.

Hvis telefonsamtale om samarbeid virkelig er nødvendig, kontakt hello@listennotes.com først.

14. Kan Listen API brukes på no-code-plattformer? 🔗

Ja, så lenge no-code-plattformen kan kobles til en REST API. Du kan for eksempel bruke Listen API til podkastsøk i Bubble- og Retool-apper.

Hvis du bare vil bygge inn avspillbare podkaster, episoder, klipp eller spillelister på nettstedet eller bloggen, trenger du ikke Listen API. Du kan enkelt bygge dem inn i WordPress, Blogger, Ghost, Google Sites, Tumblr og mange andre publiseringsplattformer.

15. Tilbyr dere språkspesifikke biblioteker for Podcast API? 🔗

Ja. Vi har noen biblioteker og vil legge til flere språk senere.

16. Hvilke opplysninger samler Listen Notes inn fra API-brukere? 🔗

Vi samler inn et minimum av informasjon om enheten som sender API-forespørsler direkte til serverne: 1) IP-adresse; 2) user-agent; 3) endpoint og parametere. Dette er i praksis én linje i Nginx-tilgangsloggen.

I en vanlig podkastapp sendes forespørslene fra utviklerens server, ikke sluttbrukerens app. Serveren fungerer som proxy. Vi kjenner derfor bare serverens IP, user-agent, endpoints og parametere, og ingenting annet om sluttbrukerne.

17. Har Listen API frekvensgrenser, for eksempel N forespørsler per sekund? 🔗

Ja. Vi setter rimelige frekvensgrenser. Ved riktig bruk merker du kanskje ikke at de finnes.

Enhver seriøs REST API trenger frekvensgrenser – søk etter «api rate limit» på Google. Uten grenser kan API-et enkelt utsettes for DDoS eller overbelastes av en feilsløyfe. Erfaring siden 2017 viser at dette skjer oftere enn forventet. Én bruker skal ikke kunne påvirke hele systemet og andre brukere.

FREE har lav grense, PRO høyere og ENTERPRISE høyest. Endpoints har ulike grenser etter beregningsbehov. Nye brukere starter relativt lavt, og grensen økes over tid.

18. Håndterer dere slettingsforespørsler etter DMCA, GDPR og lignende lover? 🔗

Ja. Vi håndterer forespørsler om sletting av innhold. Les mer:

Brukernes forespørsler kan videresendes via DELETE /podcasts/{id} eller til hello@listennotes.com.

19. Kan jeg lovlig strømme podkastlyd i apper eller på nettsteder med Listen API? 🔗

Absolutt. Du kan lovlig strømme podkastlyd i apper og på nettsteder med Listen API. Les mer.

Hvis App Store avviser appen på grunn av API-integrasjonen, hjelper vi deg.