Listen APISSS

1. Neden iTunes API yerine Listen API kullanmalıyım? 🔗

Her zaman başka seçenekleriniz vardır: kendi podcast veritabanınızı oluşturup bakımını yapın veya internetteki başka bir API'yi seçin.

Listen API'yi değerlendirmeniz için basit ve şeffaf fiyatlandırma ile tüm endpoint'ler ve örnek JSON yanıtları için kapsamlı belgeler sunuyoruz.

Denemek çok kolaydır. Satış ekibiyle görüşmeniz veya demo istemeniz gerekmez; kart bilgisi girmeden FREE'ye abone olup başlayın.

PRO veya ENTERPRISE kullanıcıları sorularını hello@listennotes.com adresine göndererek Listen Notes'un kurucusu ve CEO'sundan hızla yanıt alır.

Apple iTunes API nasıl? Belgelerini okuyup deneyin. Uygun olmayabilir; çünkü:

tüm bölümlerde arama, ses oynatma ve çalma listeleri gibi temel özelliklere yetecek endpoint ve yapılandırılmış veri sunmaz;
az sonuç döndürür ve sıralaması ideal değildir;
koşulları yapmak istediğinize izin vermeyebilir;
Apple için önemli bir ürün olmadığından muhtemelen aktif geliştirilmiyordur;
kurumsal API'lerde insan desteği hizmete dahildir, ancak Apple çalışanlarından hızlı ve bilgilendirici yanıt almak zordur.

Ayrıca okuyun: Haricî bir REST API nasıl değerlendirilir?

2. Podcast veritabanı oluşturmak ne kadar zor olabilir? 🔗

İyi bir podcast veritabanı oluşturmak sürekli emek ister. Zor değildir ama sunucu giderleri, mühendis maaşları ve bakım için zaman ve para gerekir. Araba veya ev sahibi olmak gibi ilk satın alma maliyeti, vergi, sigorta, beklenmedik onarım ve en önemlisi zamanınızdan oluşan sürekli maliyetlerden çok daha düşüktür.

Kendi veritabanınızı oluşturmadan önce şunları düşünün:

İnternette en az 3,831,088 podcast ve 196,732,836 bölüm vardır ve içerik hacmi giderek hızlanarak büyür. Verileri kendiniz barındırmalı ve güncel tutmalısınız.
3,831,088 podcast ve 196,732,836 bölüm ölçeğinde RSS akışları ve ses URL'leri tahmin ettiğinizden sık değişir. Verileri sürekli temizlemek için otomatik araçlara ve elle yürütülen süreçlere yatırım gerekir. Bu çalışma zorunlu ama kullanıcıya görünmezdir.
3,831,088 podcast ve 196,732,836 bölümde anahtar sözcük aramak için kendi arama motorunuzu kurmalısınız. Arayüz basit görünse de arka uç altyapısı son derece karmaşıktır. “Basit bir web sitesi” gibi görünen Google'ın 2022'de 175.000 tam zamanlı çalışan ve yüz binlerce yüklenici çalıştırmasının bir nedeni vardır.
İnternette makine üretimi sesler gibi birçok sahte podcast vardır. Black Hat SEO uzmanları bağlantı oluşturmak için bunları topluca üretir; insanların dinlemesi için yapılmazlar. Veritabanına girmelerini önlemek için otomatik ve elle kontroller gerekir. İlginç bilgi: Google'ın ayrı bir web spam ekibi vardır; Listen Notes da sahte podcast'lerle mücadeleye önemli kaynak ayırır.
Veritabanı ve arama motoru sürekli çalışacaksa sunucu kesintilerini önlemek ve gidermek için sürekli emek gerekir.
Yetkin bir tam zamanlı yazılım mühendisi ne kadara mal olur? Bizim API'miz gibi haricî bir bulut hizmetine mi, yoksa birkaç şirket içi mühendisin maaşına mı ödeme yapmayı tercih edersiniz?

Açıkçası kendi veritabanınızın en pahalı kısmı fırsat maliyetidir. Veritabanına harcadığınız zamanı uygulama veya web sitenizi geliştirmeye ayıramazsınız.

Listen API projenizin en heyecanlı kısmına hemen başlamanızı sağlar. Ayrıca listennotes.com üzerinde ayda 2,000,000 üzerinde kişinin kullandığı popüler bir podcast arama motoru işletiyoruz. Kullanıcılar eksik podcast'leri göndererek ve yanlış verileri düzelterek veritabanını güncel tutmamıza yardımcı olur. Dünyanın her yerinden sürekli gelen bu yardımla yüksek kaliteli bir veritabanı sürdürebiliyoruz.

3. API'yi aktif olarak destekliyor musunuz ve devam edecek misiniz? 🔗

İki sorunun da yanıtı evet.

Listen API, kullanıcıya açık ListenNotes.com sitemize güç verir ve sitenin arka uç geliştirmelerinin çoğundan yararlanır.

2017'den beri buradayız ve uzun süre devam etmeyi planlıyoruz.

4. Listen API'yi kullanırken hizmet gelecekte kapanırsa ne olur? 🔗

Endişeniz haklıdır: hiçbir çevrimiçi hizmet veya şirket sonsuza kadar sürmez. Örneğin Google birçok ürününü kapattı.

Listen API'yi kapatmaya karar verirsek en az 12 hafta önce haber veririz. Tüm podcast ve bölümleri içeren en güncel kopyayı makul bir düşük fiyatla satın alabilirsiniz.

Listen Notes muhtemelen iyi finanse edilen birçok girişimden ve halka açık şirketten uzun yaşayacaktır. Yalın çalışırız. Büyük şirketler gibi dev kadromuz ve maaş giderimiz yoktur; iç güç mücadelesiyle kapanmamız olası değildir. Sunucu faturalarını boşa şişirmeden sağlam altyapı kurarız.

5. Destek sunuyor musunuz? 🔗

Evet. PRO veya ENTERPRISE kullanıcıları API sorularını hello@listennotes.com adresine gönderebilir. Bazen FREE kullanıcılarını yanıtlasak da ücretli kullanıcılara öncelik veririz.

Sıradan müşteri hizmetleri yerine her şeyi kendi emeğiyle kuran Listen Notes, Inc. kurucusu ve CEO'suyla doğrudan konuşursunuz.

6. Çok sayıda API isteği yapacağız. Bu ölçeği destekleyebilir misiniz? 🔗

Bazı şirketler Listen API ile ayda on milyonlarca istek yapıyor. Yeni sunucu eklemeden bugünkü trafiğin en az on katını kolayca karşılarız.

Altyapı işletiminde en iyi uygulamaları, kapsamlı izleme ve uyarıları kullanırız. Sorun olursa hızla teşhis edip düzeltiriz. Performans ve çalışma süresinde çok iyi bir geçmişimiz vardır.

7. API yanıtını istemci tarafında, örneğin uygulamada veya tarayıcıda önbelleğe alabilir miyiz? 🔗

Evet. API Terms of Use (FREE ve PRO) yanıtları istemcide önbelleğe almanıza izin verir; ancak podcast/bölüm id'leri ve pub_dates dışında sunucuda önbelleğe alamazsınız.

Yani sunucuda, örneğin kendi veritabanınızda kalıcı olarak yalnızca id ve pub_dates saklayabilirsiniz. Bu politika Google Maps API gibi veri API'lerinde yaygındır (sayfada “No Scraping” arayın).

Ses dosyalarını sunucunuzda saklayıp klip veya metne dönüştürme amacıyla işleyebilirsiniz.

ENTERPRISE ile tam yanıtları sunucularınızda önbelleğe alabilirsiniz.

8. API yanıtındaki ses URL'leri neden listennotes.com alan adından geliyor? 🔗

Açıkça belirtelim: sesleri kendi sunucularımızda saklamıyoruz. Yapımcılar dinleyicinin IP'si ve user-agent gibi doğru analiz bilgilerini alır.

Gerçek URL'leri HTTP 301 ile kendi URL'lerimizde sarmalarız; örneğin audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Podcast'ler ses URL'lerini sık değiştirir; böylece kullanıcılar doğru adrese ulaşır.

Uygulamalar performans için istemcide veri önbelleğe alır. Kalıcı Listen Notes URL'sini saklarken biz sunucuda güncel ses URL'sini bulur ve değişiklikleri sürekli denetleriz.

9. Bir podcast'i bulamazsak veya veriler RSS ile eşleşmiyorsa, örneğin ses bozuk ya da meta veri hatalıysa ne yapmalıyız? 🔗

Veritabanımız çok kapsamlı olsa da bazen yeni bir programı zamanında ekleyemeyebiliriz. Google'ın yeni siteleri hemen bulamaması gibi tarayıcıların keşif ve dizine ekleme süresi gerekir. Eksik programı gönderebilirsiniz.

Yapımcı RSS'yi biz fark etmeden değiştirebilir veya akışta hata olabilir. Bu, Google sonuçlarındaki eski ya da 404 sayfalarına benzer; düzeltme zaman alır. Meta veri hatalarını hello@listennotes.com adresine bildirin, genellikle dakikalar içinde düzeltiriz. Ayrıca self servis araçlarımızla kendiniz düzeltebilirsiniz — kaliteye katkıda bulunun :)

10. Podcast veritabanını nasıl güncel tutuyorsunuz? 🔗

Yeni podcast'leri dört yöntemle buluruz.

Tarayıcılarımız Google'ın siteleri bulmasına benzer biçimde herkese açık podcast'leri sürekli arar.
Yapımcılar her gün yüzlerce yeni programı kendileri gönderir.
Listen Notes çalışanları buldukları eksikleri elle ekler. Ayrıca listennotes.com her ay 2,000,000 üzerinde kişi tarafından kullanılır. Herkes eksik programları gönderebilir, böylece veritabanı kapsamlı ve güncel kalır. Her gönderimi elle inceler, sahteleri reddederiz.
Büyük barındırma hizmetleri Podcast API hizmetimizi entegre ederek doğrudan gönderim sağlar.

Tüm RSS akışlarını sürekli kontrol ederiz. Site veya API trafiğimize göre yakın zamanda dinlenen podcast'lerin yeni bölümleri bir saat içinde, genellikle 15–30 dakikada eklenir. Diğerleri çoğunlukla 2–4 saatte alınır.

11. API Terms of Use ihlal edilirse ne olur? 🔗

API Terms of Use ihlal edilirse hesabınız askıya alınır. hello@listennotes.com adresinden itiraz edebilirsiniz.

En sık nedenler: 1. FREE kotasını aşmak için birden fazla hesap, özellikle tek kullanımlık e-posta oluşturmak; 2. yanıt verilerinin çoğunu sunucuda önbelleğe almak. API Terms of Use koşullarına uyun.

12. Ücretli plan kullansak da uygulamada Listen Notes logosunu göstermeli miyiz? 🔗

Evet. API Terms of Use tüm FREE ve PRO kullanıcıları için geçerlidir. Verilerimizi kullanan yalnızca bir ekranda “Powered by Listen Notes” göstermeniz yeterlidir; her ekranda gerekmez. Logoyu ilk ekranın altına yerleştirebilirsiniz.

Bireysel geliştirici veya halka açık şirket fark etmeksizin istisna yapmayız. Tek seferlik özelleştirmeler operasyonu karmaşıklaştırır ve temel ürünleri geliştirme süremizi azaltır.

Kaynak gösterme, Google Places ve Maps API gibi veri API'lerinde yaygındır. Uber, Google Maps kullanır ve uygulamada büyük bir Google logosu gösterir.

ENTERPRISE'ta logo şartında esnek olabiliriz.

13. İş ortaklığını telefonda görüşebilir miyiz? 🔗

Listen API self servis olacak şekilde tasarlanmıştır. Neler yaptığını ve nasıl kullanılacağını birkaç dakikada anlayamıyorsanız biz yeterince iyi açıklamamışız demektir. Sorularınız için önce hello@listennotes.com adresine yazın.

E-postayla bilgilendirici yanıtı telefon görüşmesi ayarlamaktan çok daha hızlı alırsınız.

14. Listen API'yi no-code platformlarında kullanabilir miyim? 🔗

Evet, seçtiğiniz no-code platformu bir REST API'ye bağlanabiliyorsa kullanabilirsiniz. Örneğin Bubble ve Retool uygulamalarında Listen API ile podcast arayabilirsiniz.

Yalnızca oynatılabilir podcast, bölüm, klip veya çalma listesini sitenize yerleştirecekseniz Listen API gerekmez. Bunları WordPress, Blogger, Ghost, Google Sites, Tumblr ve diğer birçok platforma kolayca yerleştirebilirsiniz.

15. Podcast API için programlama dili kütüphaneleri sunuyor musunuz? 🔗

Evet. Bazı kütüphanelerimiz var; gelecekte daha fazla programlama dili ekleyeceğiz.

16. Listen Notes API kullanıcılarından hangi bilgileri toplar? 🔗

Sunucularımıza doğrudan istek gönderen cihaz hakkında yalnızca 1) IP adresi, 2) user-agent, 3) endpoint ve parametreleri toplarız. Bu, temelde Nginx erişim günlüğündeki tek satırdır. Hepsi bu.

Örneğin geliştirici API'mizle bir uygulama yapar ve insanlar bunu dinlemek için kullanır. İstekler genellikle uygulamadan değil geliştiricinin sunucularından gelir; sunucular aracı görevi görür. Bu nedenle yalnızca 1) sunucu IP'leri, 2) python-requests gibi user-agent, 3) endpoint ve parametreleri izleriz. Son kullanıcılar hakkında başka hiçbir şey bilmeyiz.

17. Listen API'nin hız sınırları var mı, örneğin saniyede N istek? 🔗

Evet. Endpoint'ler için makul hız sınırlarımız vardır. Doğru kullanırsanız fark etmeyebilirsiniz bile.

Her ciddi REST API hız sınırı koymalıdır; “api rate limit” arayın. Sınır olmadan API kolayca DDoS'a uğrar. Programcı kısa veya sonsuz döngüden çok sayıda istek gönderebilir. 2017'den beri bu beklediğimizden sık oldu. Programcılar da insandır ve hata yapar. Tek kullanıcı tüm sistemi çökertmemelidir.

FREE düşük, PRO daha yüksek, ENTERPRISE en yüksek sınıra sahiptir. İşlem yükü değiştiğinden endpoint'lerin sınırları farklıdır. Yeni kullanıcılar düşük başlar ve zamanla sınırları artırılır.

18. DMCA, GDPR ve benzeri yasalar kapsamındaki silme taleplerini işliyor musunuz? 🔗

Evet. İçerik silme taleplerini işleriz. Ayrıntılar:

Kullanıcılarınız adına talepleri DELETE /podcasts/{id} üzerinden veya hello@listennotes.com adresine yönlendirebilirsiniz.

19. Listen API ile uygulamalarımda veya sitelerimde podcast sesini yasal olarak yayınlayabilir miyim? 🔗

Evet. Listen API ile uygulama veya sitenizde podcast sesini yasal olarak yayınlayabilirsiniz. Ayrıntılar.

App Store uygulamanızı API entegrasyonu nedeniyle reddederse yardımcı oluruz.