Listen APIVanliga frågor

1. Varför ska jag använda Listen API i stället för iTunes API? 🔗

Det finns alltid alternativ: bygg och underhåll en egen podddatabas eller välj ett annat podd-API.

För att underlätta utvärderingen erbjuder vi en enkel och transparent prismodell och fullständig dokumentation av alla endpoints med exempel på JSON-svar.

Listen API är enkelt att prova. Du behöver inte prata med säljare eller begära en demo: teckna FREE utan kortuppgifter och börja använda API:t.

Med PRO eller ENTERPRISE kan du skicka frågor till hello@listennotes.com och få snabba svar direkt från Listen Notes grundare och CEO.

Hur är det med Apples iTunes API? Läs dokumentationen och prova själv. Det kanske inte passar eftersom:

det saknar tillräckliga endpoints och strukturerade data för grundläggande funktioner som sökning i alla avsnitt, ljuduppspelning och spellistor;
sökningen ger få poddar och dålig rankning;
villkoren kanske inte tillåter ditt användningsfall;
det sannolikt inte underhålls aktivt av Apples bästa personal eftersom det inte är en viktig produkt;
mänsklig support brukar ingå i företags-API:er, men snabba och informativa svar från Apple är svåra att få.

Läs även: Så utvärderar du ett externt REST-API.

2. Hur svårt kan det vara att bygga en podddatabas? 🔗

Att bygga en bra podddatabas kräver kontinuerligt arbete. Det är inte svårt, men tar tid och pengar för servrar, utvecklarlöner och underhåll. Precis som med en bil eller ett hus är inköpskostnaden mycket lägre än de löpande kostnaderna för skatt, försäkring, oväntade reparationer och framför allt din tid.

Tänk på följande innan du bygger och underhåller en egen databas:

På internet finns minst 3,831,088 poddar och 196,732,836 avsnitt, och mängden växer allt snabbare. Du måste själv lagra data och hålla dem aktuella.
Vid 3,831,088 poddar och 196,732,836 avsnitt ändras RSS-flöden och ljud-URL:er oftare än du tror. Automatiska verktyg och manuella processer behövs dygnet runt för datarensning – nödvändigt men osynligt arbete.
För att söka i 3,831,088 poddar och 196,732,836 avsnitt efter sökord måste du bygga en sökmotor. Gränssnittet kan vara enkelt men backend-infrastrukturen är mycket komplex. Det finns en anledning till att Google, en till synes ”enkel webbplats”, hade 175 000 heltidsanställda 2022 och hundratusentals konsulter.
Det finns många falska poddar på internet, exempelvis maskingenererat ljud. Black-hat-SEO-aktörer massproducerar dem för länkbygge; de är inte avsedda för människor. Både automatiska och manuella kontroller behövs för att utesluta dem. Kul fakta: Google har ett särskilt webbspamteam, och Listen Notes lägger också stora resurser på falska poddar.
Om databasen och sökmotorn ska fungera dygnet runt måste serveravbrott förebyggas och åtgärdas.
Vad kostar en kompetent heltidsutvecklare? Betalar du hellre för en extern molntjänst som vårt API eller lönerna för flera interna utvecklare?

Den dyraste delen av en egen podddatabas är ärligt talat alternativkostnaden. Tiden som läggs på databasen kan inte användas för att bygga appen eller webbplatsen.

Listen API låter dig börja direkt med projektets mest spännande del. Vi driver också den populära sökmotorn listennotes.com, som används av fler än 2,000,000 personer varje månad. De hjälper till att hålla databasen aktuell genom att skicka in saknade poddar och rätta felaktiga data. Med hjälp från människor över hela världen dygnet runt kan vi hålla hög kvalitet.

3. Underhåller ni API:t aktivt och tänker ni fortsätta? 🔗

Ja på båda frågorna.

Listen API driver vår publika webbplats ListenNotes.com och får de flesta förbättringarna av dess backend.

Vi har funnits sedan 2017 och planerar att fortsätta länge.

4. Vad händer om vi använder Listen API och tjänsten försvinner? 🔗

Oron är befogad: ingen onlinetjänst eller inget företag varar för evigt. Google har exempelvis lagt ned många egna produkter.

Om Listen API läggs ned meddelar vi minst 12 veckor i förväg. Då kan du köpa den senaste databaskopian med alla poddar och avsnitt till ett rimligt lågt pris.

Listen Notes överlever sannolikt många välfinansierade startups och börsbolag. Vi driver verksamheten resurssnålt. Till skillnad från större företag har vi inte enorm personalstyrka och lönekostnad, så interna maktstrider lär inte stänga företaget. Infrastrukturen är robust utan onödigt höga serverkostnader.

5. Erbjuder ni support? 🔗

Ja. PRO- och ENTERPRISE-kunder kan mejla alla API-frågor till hello@listennotes.com. Ibland svarar vi FREE-användare, men betalande kunder prioriteras.

I stället för opersonlig kundtjänst talar du direkt med Listen Notes, Inc:s grundare och CEO, som har byggt hela produkten själv med stort engagemang.

6. Vi kommer att göra väldigt många API-anrop. Klarar ni vår skala? 🔗

Vissa företag gör tiotals miljoner anrop i månaden genom Listen API. Vi kan enkelt hantera tio gånger dagens trafik utan fler servrar.

Vi följer bästa praxis för drift, övervakning och larm. Om infrastrukturen får problem kan vi snabbt felsöka och åtgärda dem. Vi har mycket god historik för prestanda och tillgänglighet.

7. Får vi cachelagra API-svaret på klientsidan, exempelvis i appen eller webbläsaren? 🔗

Ja. Våra API Terms of Use (FREE och PRO) tillåter cache på klientsidan men inte på servern, förutom id:n för poddar/avsnitt och pub_dates.

På servern, exempelvis i egen databas, får alltså bara dessa id:n och pub_dates lagras permanent. Sådan policy är vanlig för data-API:er, exempelvis Google Maps API (sök efter ”No Scraping”).

Själva ljudfilerna får lagras och bearbetas på servern, exempelvis för klipp och transkription.

Med ENTERPRISE får fullständiga svar cachelagras.

8. Varför kommer ljud-URL:erna i API-svaret från domänen listennotes.com? 🔗

För tydlighetens skull: vi lagrar inte ljud på våra servrar. Poddare får korrekt analysdata som lyssnarens IP och user-agent.

De verkliga adresserna omsluts av våra URL:er via HTTP 301, exempelvis audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Poddar byter ofta ljud-URL, och så hjälper vi användarna att alltid hitta rätt adress.

Appar cachelagrar ofta data på klienten för prestanda. De sparar den permanenta Listen Notes-URL:en medan vi fastställer den aktuella ljudadressen på servern och övervakar ändringar.

9. Vad gör vi om en podcast saknas eller data inte stämmer med RSS-flödet, till exempel trasigt ljud eller fel metadata? 🔗

Trots att databasen är omfattande hinner vi ibland inte lägga till en ny podd. På samma sätt hittar Google inte nya webbplatser direkt – robotarna behöver tid för att hitta och indexera. Du kan skicka in den saknade podden.

Producenten kan också ändra RSS-flödet innan vi upptäcker det, eller så kan flödet innehålla fel. Det liknar gamla sidor och 404-fel i Google – rättelser tar tid. Rapportera metadatafel till hello@listennotes.com så rättar vi dem snabbt, normalt inom några minuter. Du kan även själv rätta metadata med våra verktyg – hjälp oss hålla kvaliteten :)

10. Hur håller ni podddatabasen aktuell? 🔗

Vi hittar nya poddar på fyra sätt.

Våra robotar söker dygnet runt efter offentliga poddar, ungefär som Google hittar webbplatser.
Poddare skickar själva in nya program – hundratals varje dag.
Listen Notes medarbetare lägger manuellt till saknade poddar. Dessutom används listennotes.com av fler än 2,000,000 personer varje månad. Alla kan skicka in en saknad podd, vilket håller databasen komplett och aktuell. Vi granskar varje bidrag manuellt och avvisar falska poddar.
Vi samarbetar med stora poddhotell som integrerar vårt Podcast API för direktinlämning.

Vi kontrollerar alla RSS-flöden dygnet runt. För nyligen lyssnade poddar via webbplatsen eller API:t läggs nya avsnitt till inom en timme, oftast 15–30 minuter. Övriga hämtas normalt inom 2–4 timmar.

11. Vad händer om vi bryter mot API Terms of Use? 🔗

Kontot stängs av om du bryter mot API Terms of Use. Beslutet kan överklagas via hello@listennotes.com.

De vanligaste orsakerna är: 1. flera konton för att kringgå FREE-kvoten, särskilt med engångsadresser; 2. cachelagring av merparten av svaren på servern. Följ API Terms of Use.

12. Måste Listen Notes-logotypen visas även med ett betalt abonnemang? 🔗

Ja. Våra API Terms of Use gäller alla FREE- och PRO-användare. ”Powered by Listen Notes” behöver bara visas på en skärm som använder våra data, inte alla. Logotypen får placeras nedanför första skärmbilden.

Vi gör inga undantag för vare sig enskilda utvecklare eller börsbolag. Engångsanpassningar ökar komplexiteten och tar tid från kärnprodukterna.

Källangivelse är vanligt för data-API:er, exempelvis Google Places och Maps API. Uber använder Google Maps och visar en stor Google-logotyp.

Med ENTERPRISE kan logotypkravet vara flexibelt.

13. Kan vi diskutera ett samarbete per telefon? 🔗

Listen API är utformat för självbetjäning. Om du inte kan förstå möjligheterna och användningen på några minuter har vi förklarat för dåligt. Börja med att mejla frågor till hello@listennotes.com.

Du får ett informativt svar via e-post mycket snabbare än det går att boka ett samtal.

14. Kan jag använda Listen API på no-code-plattformar? 🔗

Ja, om no-code-plattformen kan ansluta till ett REST-API. Listen API kan exempelvis söka poddar i appar byggda med Bubble eller Retool.

Om du bara vill bädda in spelbara poddar, avsnitt, klipp eller spellistor behövs inte Listen API. De kan enkelt bäddas in i WordPress, Blogger, Ghost, Google Sites, Tumblr och många andra plattformar.

15. Finns bibliotek för Podcast API för olika programmeringsspråk? 🔗

Ja. Vi har redan några bibliotek och kommer att lägga till fler programmeringsspråk framöver.

16. Vilken information samlar Listen Notes in om API-användare? 🔗

Vi samlar in minsta möjliga information om enheten som skickar anrop direkt till våra servrar: 1) IP-adress; 2) user-agent; 3) endpoint och parametrar. Det motsvarar i princip en rad i Nginx åtkomstlogg. Inget mer.

En utvecklare kan exempelvis bygga en poddapp som används av många lyssnare. Anropen skickas normalt från utvecklarens servrar, som fungerar som mellanhand. Därför ser vi bara 1) servernas IP-adresser; 2) deras user-agent, exempelvis python-requests; 3) endpoints och parametrar. Vi vet inget annat om slutanvändarna.

17. Har Listen API hastighetsbegränsningar, till exempel N anrop per sekund? 🔗

Ja. Vi har rimliga hastighetsgränser för våra endpoints. Vid korrekt användning märker du kanske aldrig dem.

Alla seriösa REST-API:er behöver gränser – sök efter ”api rate limit”. Utan dem är API:t lätt att slå ut med DDoS. Ett program kan skicka mängder av anrop i en tät eller oändlig loop. Sedan 2017 har detta hänt oftare än väntat. Utvecklare är människor och människor gör misstag. En användare ska inte kunna slå ut systemet för alla.

FREE har låg gräns, PRO högre och ENTERPRISE högst. Gränsen varierar per endpoint eftersom beräkningskostnaden skiljer sig. Nya användare börjar relativt lågt och får högre gränser över tid.

18. Hanterar ni borttagningsbegäranden enligt DMCA, GDPR och liknande lagar? 🔗

Ja. Vi hanterar borttagningsbegäranden. Läs mer:

Begäranden för användarnas räkning kan skickas via DELETE /podcasts/{id} eller till hello@listennotes.com.

19. Får jag lagligt strömma poddljud i appar eller på webbplatser med Listen API? 🔗

Ja. Du får lagligt strömma poddljud i appar och på webbplatser via Listen API. Läs mer.

Om App Store avvisar appen på grund av API-integrationen hjälper vi gärna till.