Pertanyaan UmumListen API
VERSI API: V2 ·
PodcastAPI.com
Jawaban atas pertanyaan umum tentang Listen API.
Baca dari https://www.podcastapi.com/llms-full.txt agar saya bisa bertanya tentang Podcast API dari Listen Notes.
Ada pertanyaan?
hello@listennotes.com
1. Mengapa saya perlu menggunakan Listen API? Apa kelebihannya dibandingkan iTunes API? 🔗
Anda selalu memiliki pilihan lain: membangun dan memelihara database podcast sendiri atau memilih Podcast API lain di Internet.
Untuk membantu evaluasi, kami menyediakan model harga yang sederhana dan transparan serta dokumentasi lengkap untuk semua endpoint dan contoh response JSON.
Listen API mudah dicoba: tidak perlu berbicara dengan staf penjualan atau meminta demo. Cukup berlangganan paket FREE tanpa kartu kredit dan mulai menggunakannya.
Pelanggan PRO atau ENTERPRISE dapat mengirim pertanyaan ke hello@listennotes.com dan berbicara langsung dengan pendiri dan CEO Listen Notes.
Bagaimana dengan iTunes API dari Apple? Bacalah dokumentasinya dan coba sendiri. API tersebut mungkin kurang sesuai karena
- endpoint dan data terstruktur tidak cukup untuk sejumlah fitur dasar;
- hasil pencarian sedikit dan peringkatnya kurang ideal;
- ketentuan layanan mungkin tidak mengizinkan kebutuhan Anda;
- kemungkinan tidak dipelihara secara aktif karena bukan produk penting bagi Apple;
- dukungan manusia biasanya merupakan bagian penting API enterprise, sedangkan memperoleh jawaban tepat waktu dari Apple mungkin sulit.
Artikel ini mungkin berguna: How to evaluate a 3rd party RESTful API?
2. Seberapa sulit membangun database podcast? 🔗
Membangun database podcast yang baik adalah pekerjaan berkelanjutan. Tidak sulit, tetapi membutuhkan waktu dan biaya server serta engineer. Seperti mobil atau rumah, biaya pemeliharaan jangka panjang dan waktu Anda lebih besar daripada biaya awal.
Pertimbangkan hal-hal berikut:
- Internet memiliki setidaknya 3,831,088 podcast dan 196,732,836 episode, dan jumlahnya tumbuh cepat. Data harus dihosting dan diperbarui.
- Untuk 3,831,088 podcast dan 196,732,836 episode, RSS feed dan URL audio berubah lebih sering dari perkiraan. Diperlukan alat otomatis dan proses manual sepanjang waktu.
- Pencarian keyword atas 3,831,088 podcast dan 196,732,836 episode memerlukan mesin pencari sendiri. UI-nya sederhana, tetapi backend sangat rumit—ada alasan Google mempekerjakan 175.000 karyawan tetap pada 2022 dan ratusan ribu kontraktor.
- Banyak podcast palsu dibuat dengan mesin atau Black Hat SEO. Proses otomatis dan manual diperlukan untuk menyaringnya. Google memiliki tim web spam khusus; Listen Notes juga mengalokasikan banyak sumber daya.
- Database dan mesin pencari yang berjalan sepanjang waktu memerlukan upaya mencegah gangguan server.
- Bandingkan biaya engineer tetap yang kompeten dengan layanan cloud pihak ketiga seperti API kami.
Biaya termahal sebenarnya adalah biaya peluang. Waktu membangun database sendiri tidak dapat digunakan untuk membuat aplikasi atau situs Anda.
Listen API memungkinkan Anda segera memulai bagian proyek yang paling menarik. Lebih dari 2,000,000 orang menggunakan listennotes.com setiap bulan dan membantu mengirimkan podcast yang belum ada serta memperbaiki data. Bantuan mereka menjaga kualitas database kami.
3. Apakah API ini didukung secara aktif dan akan terus didukung? 🔗
Ya dan ya.
Listen API mendukung situs publik ListenNotes.com dan memperoleh manfaat dari sebagian besar peningkatan backend Listen Notes. Kami telah beroperasi sejak 2017 dan berencana terus beroperasi dalam jangka panjang.
4. Bagaimana jika kami memakai Listen API lalu layanan ini berhenti di masa depan? 🔗
Kekhawatiran Anda wajar. Tidak ada layanan atau perusahaan online yang bertahan selamanya; misalnya, Google menghentikan banyak produknya.
Jika Listen API dihentikan, kami akan memberi pemberitahuan sedikitnya 12 minggu sebelumnya dan Anda dapat membeli dump database terbaru—semua podcast dan episode—dengan harga yang cukup rendah.
Listen Notes mungkin bertahan lebih lama daripada banyak startup atau perusahaan publik. Kami beroperasi secara ramping, tanpa banyak karyawan dan beban gaji. Infrastruktur kami dirancang tangguh tanpa memboroskan biaya server.
5. Apakah Anda menyediakan dukungan? 🔗
Ya. Pelanggan PRO atau ENTERPRISE dapat mengirim pertanyaan API ke hello@listennotes.com. Untuk debugging, terkadang kami meminta contoh kode atau request/response. Dukungan personal tidak dijamin bagi paket FREE, tetapi dokumentasi dan FAQ tersedia.
6. Kami akan menggunakan sangat banyak permintaan API. Dapatkah Anda menangani skala kami? 🔗
Saat ini sejumlah perusahaan menjalankan puluhan juta permintaan per bulan melalui Listen API. Tanpa menambah server, kami dapat menangani sedikitnya 10 kali traffic saat ini.
Hubungi hello@listennotes.com jika Anda merencanakan skala sangat besar agar kami dapat membantu capacity planning.
7. Bolehkah response API disimpan dalam cache di sisi klien, seperti aplikasi atau browser? 🔗
Ya. API Terms of Use untuk paket FREE dan PRO mengizinkan cache response di sisi klien, tetapi tidak di server kecuali podcast/episode id dan pub_date.
Hanya id dan pub_date yang boleh disimpan permanen di server atau database Anda. Kebijakan no-caching umum pada Data API, misalnya Google Maps API (cari "No Scraping").
File audio podcast yang sebenarnya boleh disimpan dan diproses di server, misalnya untuk membuat klip atau speech-to-text.
Paket ENTERPRISE mengizinkan seluruh response data disimpan di server.
8. Mengapa URL audio dalam response API menggunakan domain listennotes.com? 🔗
Kami tidak menyimpan audio di server sendiri. Podcaster tetap memperoleh analytics akurat seperti IP dan user-agent pendengar.
Karena URL audio sering berubah, URL asli dibungkus dengan URL permanen kami melalui HTTP 301, misalnya audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d. Ini membantu menemukan URL yang benar.
Aplikasi lazim menyimpan data di cache klien untuk performa. Aplikasi menyimpan URL Listen Notes yang permanen, sementara server kami menemukan URL audio yang benar dan terus memeriksa perubahannya.
9. Bagaimana jika podcast tertentu tidak ditemukan atau data tidak sinkron dengan RSS feed, misalnya audio rusak atau metadata salah? 🔗
Walaupun database kami sangat lengkap, beberapa acara baru mungkin belum ditambahkan tepat waktu, seperti crawler Google yang memerlukan waktu untuk mengindeks situs baru. Anda dapat membantu mengirimkan acara yang belum ada.
Pembuat podcast juga dapat mengubah RSS feed sebelum kami mendeteksinya, atau feed mengandung error. Ini seperti hasil Google yang mengarah ke halaman lama atau 404. Laporkan kesalahan metadata ke hello@listennotes.com dan biasanya kami memperbaikinya dalam hitungan menit. Anda juga dapat menggunakan alat mandiri untuk memperbaiki metadata—jadilah warga yang baik :)
10. Bagaimana Anda memastikan database podcast selalu mutakhir? 🔗
Kami menemukan podcast baru melalui empat cara.
- Crawler bekerja sepanjang waktu untuk menemukan podcast publik, seperti Google menemukan situs baru.
- Podcaster mengirimkan acara baru sendiri; kami menerima ratusan kiriman setiap hari.
- Karyawan Listen Notes menambahkan podcast yang belum ada secara manual. Lebih dari 2,000,000 orang menggunakan listennotes.com setiap bulan dan dapat mengirimkan acara yang belum ada. Kami meninjau semua kiriman dan menolak podcast palsu.
- Layanan hosting besar terintegrasi dengan Podcast API kami sehingga podcaster dapat mengirim acara langsung.
Semua RSS feed diperiksa sepanjang waktu. Episode baru untuk podcast yang baru didengarkan masuk dalam satu jam, biasanya 15–30 menit. Podcast lainnya biasanya diperbarui dalam 2–4 jam.
11. Apa yang terjadi jika kami melanggar API Terms of Use? 🔗
Akun akan ditangguhkan jika melanggar API Terms of Use. Ajukan banding melalui hello@listennotes.com.
Dua penyebab umum adalah: 1. Membuat banyak akun untuk menghindari kuota paket FREE, terutama dengan alamat email sekali pakai; 2. Menyimpan sebagian besar response data dalam cache server. Pastikan Anda mematuhi API Terms of Use.
12. Apakah kami tetap harus menampilkan logo Listen Notes di aplikasi saat menggunakan paket berbayar? 🔗
Ya. API Terms of Use berlaku bagi semua pengguna FREE/PRO. Teks "Powered by Listen Notes" cukup ditampilkan pada satu layar yang menggunakan data kami, bukan di setiap layar.
Paket ENTERPRISE tidak mewajibkan logo.
Pemutar HTML embed dan Listen API adalah produk berbeda. Logo pada pemutar embed tidak dapat dihapus meskipun Anda memakai paket API berbayar.
13. Dapatkah kami membahas kemitraan melalui telepon? 🔗
Listen API dirancang sebagai layanan mandiri. Jika fungsi dan cara pakainya tidak dapat dipahami dalam beberapa menit, berarti desain atau dokumentasi kami perlu diperbaiki.
Jika pembicaraan kemitraan melalui telepon benar-benar diperlukan, hubungi hello@listennotes.com terlebih dahulu.
14. Dapatkah saya menggunakan Listen API di platform no-code? 🔗
Ya, selama platform no-code pilihan Anda dapat terhubung ke REST API. Misalnya, Listen API dapat digunakan untuk mencari podcast di aplikasi Bubble dan Retool.
Jika hanya ingin menyematkan podcast, episode, klip, atau playlist yang dapat diputar di situs atau blog, Listen API tidak diperlukan. Anda dapat menyematkannya dengan mudah di WordPress, Blogger, Ghost, Google Sites, Tumblr, dan berbagai platform penerbitan lain.
15. Apakah tersedia library Podcast API untuk bahasa pemrograman tertentu? 🔗
16. Informasi apa yang dikumpulkan Listen Notes dari pengguna API? 🔗
Kami hanya mengumpulkan sedikit informasi tentang perangkat yang langsung mengirim permintaan ke server: 1) alamat IP; 2) user-agent; dan 3) endpoint serta parameter. Pada dasarnya ini hanyalah satu baris dalam Nginx access log.
Dalam aplikasi podcast, permintaan biasanya dikirim dari server developer, bukan dari aplikasi pengguna. Server bertindak sebagai proxy. Karena itu kami hanya mengetahui IP server, user-agent, serta endpoint dan parameter permintaan; kami tidak mengetahui informasi lain tentang pengguna akhir aplikasi.
17. Apakah Listen API memiliki batas laju, misalnya N permintaan per detik? 🔗
Ya. Kami menetapkan rate limit yang wajar. Jika API digunakan dengan benar, Anda mungkin tidak menyadarinya.
Setiap REST API yang serius memerlukan rate limit—cari "api rate limit" di Google. Tanpanya, API mudah terkena DDoS atau loop program yang mengirim terlalu banyak permintaan. Pengalaman kami sejak 2017 menunjukkan kesalahan ini cukup sering terjadi. Seorang pengguna tidak boleh menjatuhkan seluruh sistem dan mengganggu pengguna lain.
Paket FREE memiliki batas rendah, PRO lebih tinggi, dan ENTERPRISE paling tinggi. Setiap endpoint dapat memiliki batas berbeda sesuai kebutuhan komputasinya. Pengguna baru mendapat batas relatif rendah yang dinaikkan seiring waktu.
18. Apakah Anda menangani permintaan penghapusan podcast berdasarkan DMCA, GDPR, dan hukum serupa? 🔗
Ya. Kami menangani permintaan penghapusan konten. Pelajari:
Permintaan pengguna dapat diteruskan melalui endpoint DELETE /podcasts/{id}, atau ke hello@listennotes.com.
19. Dapatkah saya menyiarkan audio podcast secara legal di aplikasi atau situs dengan Listen API? 🔗
Tentu. Anda dapat menyiarkan audio podcast secara legal di aplikasi atau situs menggunakan Listen API. Pelajari selengkapnya.
Jika App Store menolak aplikasi karena integrasi API kami, kami siap membantu.