คำถามที่พบบ่อยของListen API

API เวอร์ชัน: V2 · PodcastAPI.com

คำตอบสำหรับคำถามทั่วไปเกี่ยวกับ Listen API

อ่านจาก https://www.podcastapi.com/llms-full.txt เลยได้ถามคำถามเกี่ยวกับ Podcast API จาก Listen Notes ครับ

มีคำถาม? hello@listennotes.com

1. ทำไมจึงควรใช้ Listen API แทน iTunes API 🔗

คุณมีทางเลือกอื่นเสมอ เช่น สร้างและดูแลฐานข้อมูลเอง หรือเลือก API พอดแคสต์รายอื่น

เพื่อช่วยประเมิน Listen API เรามีรูปแบบราคาที่โปร่งใสและเรียบง่าย พร้อมเอกสารครบถ้วนของทุก endpoint และตัวอย่าง JSON

ทดลองใช้ได้ง่ายโดยไม่ต้องคุยกับฝ่ายขายหรือขอดูเดโม เพียงสมัคร FREE โดยไม่กรอกบัตร แล้วเริ่มใช้ Listen API

ผู้ใช้ PRO หรือ ENTERPRISE ส่งคำถามไปที่ hello@listennotes.com และรับคำตอบโดยตรงจากผู้ก่อตั้งและ CEO ของ Listen Notesได้อย่างรวดเร็ว

แล้ว iTunes API ของ Apple ล่ะ? โปรดอ่านเอกสารและลองด้วยตนเอง คุณอาจพบว่าไม่เหมาะ เพราะ

มี endpoint และข้อมูลแบบมีโครงสร้างไม่เพียงพอสำหรับฟีเจอร์พื้นฐาน เช่น ค้นหาทุกตอน เล่นเสียง หรือสร้างเพลย์ลิสต์
ผลการค้นหาพอดแคสต์มีน้อยและการจัดอันดับไม่ดี
ข้อกำหนดอาจไม่อนุญาตกรณีใช้งานของคุณ
น่าจะไม่ได้รับการพัฒนาอย่างจริงจัง เพราะไม่ใช่ผลิตภัณฑ์สำคัญของ Apple
API สำหรับองค์กรมักมีการช่วยเหลือจากคนจริง แต่การได้คำตอบรวดเร็วและมีสาระจาก Apple อาจยาก

อ่านบทความนี้เพิ่มเติม: วิธีประเมิน REST API จากภายนอก

2. การสร้างฐานข้อมูลพอดแคสต์ยากเพียงใด 🔗

การสร้างฐานข้อมูลพอดแคสต์ที่ดีต้องทำอย่างต่อเนื่อง ไม่ได้ยากเป็นพิเศษ แต่ต้องใช้เวลาและเงิน ทั้งค่าเซิร์ฟเวอร์ เงินเดือนวิศวกร และค่าดูแล เช่นเดียวกับรถหรือบ้าน ค่าเริ่มต้นมักต่ำกว่าค่าใช้จ่ายระยะยาว ทั้งภาษี ประกัน การซ่อมที่ไม่คาดคิด และที่สำคัญที่สุดคือเวลาของคุณ

ก่อนสร้างและดูแลฐานข้อมูลเอง โปรดพิจารณา:

บนอินเทอร์เน็ตมีอย่างน้อย 3,831,088 พอดแคสต์และ 196,732,836 ตอน และปริมาณเพิ่มเร็วขึ้นเรื่อย ๆ คุณต้องโฮสต์ข้อมูลและทำให้เป็นปัจจุบันเอง
เมื่อมี 3,831,088 พอดแคสต์และ 196,732,836 ตอน RSS และ URL เสียงเปลี่ยนบ่อยกว่าที่คิด คุณต้องลงทุนในเครื่องมืออัตโนมัติและกระบวนการตรวจด้วยคนตลอด 24 ชั่วโมงเพื่อทำความสะอาดข้อมูล งานเหล่านี้จำเป็นแต่ผู้ใช้มองไม่เห็น
หากต้องค้นหา 3,831,088 พอดแคสต์และ 196,732,836 ตอนด้วยคำสำคัญ คุณต้องสร้างเครื่องมือค้นหาเอง หน้าจออาจดูเรียบง่าย แต่โครงสร้างพื้นฐานเบื้องหลังซับซ้อนมาก มีเหตุผลที่ Google ซึ่งดูเหมือน “เว็บไซต์ง่าย ๆ” มีพนักงานประจำ 175,000 คนในปี 2022 และผู้รับจ้างอีกหลายแสนคน
อินเทอร์เน็ตมีพอดแคสต์ปลอมจำนวนมาก เช่น เสียงที่สร้างโดยเครื่อง ผู้ทำ Black Hat SEO ผลิตขึ้นเพื่อสร้างลิงก์ ไม่ได้ทำให้มนุษย์ฟัง คุณต้องมีทั้งระบบอัตโนมัติและการตรวจด้วยคนเพื่อกันออกจากฐานข้อมูล เกร็ดน่ารู้: Google มีทีมเว็บสแปมโดยเฉพาะ และ Listen Notes ก็ใช้ทรัพยากรมากกับพอดแคสต์ปลอมเช่นกัน
หากฐานข้อมูลและเครื่องมือค้นหาต้องทำงานตลอด 24 ชั่วโมง คุณต้องป้องกันและแก้ไขเซิร์ฟเวอร์หยุดทำงานอยู่เสมอ
วิศวกรซอฟต์แวร์ที่มีความสามารถเต็มเวลามีค่าใช้จ่ายเท่าใด คุณอยากจ่ายค่าบริการคลาวด์ภายนอก เช่น API ของเรา หรือเงินเดือนวิศวกรภายในหลายคนมากกว่ากัน

พูดตามตรง ส่วนที่แพงที่สุดของการสร้างฐานข้อมูลเองคือต้นทุนค่าเสียโอกาส เวลาที่ใช้สร้างฐานข้อมูลคือเวลาที่ไม่ได้นำไปสร้างแอปหรือเว็บไซต์

Listen API ช่วยให้คุณเริ่มทำส่วนที่น่าสนใจที่สุดของโปรเจกต์ได้ทันที เรายังให้บริการเครื่องมือค้นหายอดนิยมที่ listennotes.com ซึ่งมีผู้ใช้มากกว่า 2,000,000 คนต่อเดือน ผู้ใช้เหล่านี้ช่วยให้ฐานข้อมูลเป็นปัจจุบัน เช่น ส่งพอดแคสต์ที่ขาดและแก้ไขข้อมูลผิด ด้วยความช่วยเหลือจากผู้คนทั่วโลกตลอดเวลา เราจึงรักษาฐานข้อมูลคุณภาพสูงได้

3. เรายังดูแล API อย่างต่อเนื่องและจะทำต่อไปหรือไม่ 🔗

ใช่ทั้งสองข้อ

Listen API อยู่เบื้องหลังเว็บไซต์ ListenNotes.com และได้รับประโยชน์จากการปรับปรุง backend ส่วนใหญ่ของเว็บไซต์

เราให้บริการมาตั้งแต่ปี 2017 และตั้งใจดำเนินงานต่อไปอีกนาน

4. หากใช้ Listen API แล้วบริการยุติลงในอนาคตจะทำอย่างไร 🔗

ความกังวลนี้สมเหตุสมผล ไม่มีบริการออนไลน์หรือบริษัทใดอยู่ตลอดไป ตัวอย่างเช่น Google ยุติผลิตภัณฑ์ของตนเองจำนวนมาก

หากตัดสินใจยุติ Listen API เราจะแจ้งล่วงหน้าอย่างน้อย 12 สัปดาห์ และคุณซื้อสำเนาฐานข้อมูลล่าสุดซึ่งมีพอดแคสต์และตอนทั้งหมดได้ในราคาที่สมเหตุสมผล

Listen Notes น่าจะอยู่ได้นานกว่าสตาร์ทอัปที่มีเงินทุนดีหรือบริษัทมหาชนหลายแห่ง เราดำเนินงานอย่างกระชับ ไม่จ้างคนจำนวนมากและไม่มีภาระเงินเดือนสูง จึงไม่น่าปิดเพราะความขัดแย้งภายใน อีกทั้งออกแบบโครงสร้างพื้นฐานให้มั่นคงโดยไม่สิ้นเปลืองค่าเซิร์ฟเวอร์

5. เรามีบริการช่วยเหลือหรือไม่ 🔗

ผู้ใช้ PRO หรือ ENTERPRISE ส่งคำถาม API ไปที่ hello@listennotes.com ได้ เราอาจตอบผู้ใช้ FREE บ้าง แต่ต้องให้ความสำคัญกับลูกค้าที่ชำระเงินก่อน

แทนที่จะติดต่อเจ้าหน้าที่บริการลูกค้าทั่วไป คุณจะคุยโดยตรงกับผู้ก่อตั้งและ CEO ของ Listen Notes, Inc. ผู้สร้างผลิตภัณฑ์ทั้งหมดด้วยตนเองและด้วยใจ

6. หากมีคำขอ API จำนวนมาก เรารองรับได้หรือไม่ 🔗

ปัจจุบันบางบริษัทใช้ Listen API หลายสิบล้านคำขอต่อเดือน เรารองรับปริมาณเพิ่มอย่างน้อยสิบเท่าได้โดยไม่เพิ่มเซิร์ฟเวอร์

เราใช้แนวปฏิบัติที่ดีด้านโครงสร้างพื้นฐาน มีระบบตรวจสอบและแจ้งเตือนที่ครบถ้วน หากเกิดปัญหา เราวิเคราะห์และแก้ไขได้รวดเร็ว และมีประวัติที่ดีมากด้านประสิทธิภาพและความพร้อมใช้งาน

7. แคชคำตอบ API ฝั่งไคลเอนต์ เช่น ในแอปหรือเบราว์เซอร์ได้หรือไม่ 🔗

ได้ API Terms of Use (FREE และ PRO) อนุญาตให้แคชคำตอบฝั่งไคลเอนต์ แต่ห้ามแคชฝั่งเซิร์ฟเวอร์ ยกเว้น id ของพอดแคสต์/ตอนและ pub_dates

กล่าวคือ เก็บถาวรบนเซิร์ฟเวอร์หรือฐานข้อมูลของคุณได้เฉพาะ id และ pub_dates นโยบายนี้พบได้ทั่วไปใน API ข้อมูล เช่น Google Maps API (ค้นหา “No Scraping”)

ไฟล์เสียงจริงสามารถเก็บและประมวลผลบนเซิร์ฟเวอร์ได้ เช่น ทำคลิปหรือถอดเสียง

หากสมัคร ENTERPRISE คุณแคชคำตอบเต็มบนเซิร์ฟเวอร์ได้

8. ทำไม URL เสียงในคำตอบ API จึงมาจากโดเมน listennotes.com 🔗

เพื่อความชัดเจน เราไม่เก็บเสียงบนเซิร์ฟเวอร์ของเรา ผู้จัดทำจะได้รับข้อมูลวิเคราะห์ที่ถูกต้อง เช่น IP และ user-agent ของผู้ฟัง

เราครอบ URL จริงด้วย URL ของเราโดยใช้ HTTP 301 เช่น audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d เพราะพอดแคสต์เปลี่ยน URL เสียงบ่อย วิธีนี้ช่วยให้ผู้ใช้ไปยัง URL ที่ถูกต้องเสมอ

แอปมักแคชข้อมูลฝั่งไคลเอนต์เพื่อประสิทธิภาพ โดยเก็บ URL ถาวรของ Listen Notes ขณะที่เราค้นหา URL เสียงล่าสุดฝั่งเซิร์ฟเวอร์และตรวจสอบการเปลี่ยนแปลงอยู่เสมอ

9. หากหาพอดแคสต์ไม่พบ หรือข้อมูลไม่ตรงกับ RSS เช่น เสียงเสียหรือข้อมูลเมตาผิด ต้องทำอย่างไร 🔗

แม้ฐานข้อมูลจะครอบคลุมมาก แต่บางครั้งเราอาจเพิ่มรายการใหม่ไม่ทัน เช่นเดียวกับเว็บไซต์ใหม่ที่ยังไม่ปรากฏใน Google เพราะโปรแกรมรวบรวมข้อมูลต้องใช้เวลาค้นหาและจัดทำดัชนี คุณช่วยส่งรายการที่ขาดได้

ผู้สร้างอาจเปลี่ยน RSS ก่อนที่เราจะพบ หรือ RSS อาจมีข้อผิดพลาด คล้ายกับผลค้นหา Google ที่เป็นหน้าเก่าหรือ 404 ซึ่งต้องใช้เวลาแก้ไข แจ้งข้อผิดพลาดข้อมูลเมตาที่ hello@listennotes.com เราจะแก้ไขโดยเร็ว โดยทั่วไปภายในไม่กี่นาที หรือใช้เครื่องมือของเราแก้ไขด้วยตนเอง ช่วยกันดูแลคุณภาพ :)

10. เราดูแลฐานข้อมูลพอดแคสต์ให้เป็นปัจจุบันอย่างไร 🔗

เราหาพอดแคสต์ใหม่ด้วยสี่วิธี

โปรแกรมรวบรวมข้อมูลค้นหาพอดแคสต์สาธารณะตลอดเวลา คล้ายกับ Google ที่ค้นหาเว็บไซต์ใหม่
ผู้จัดทำส่งรายการใหม่เข้ามาเองหลายร้อยรายการต่อวัน
พนักงาน Listen Notes เพิ่มรายการที่ขาดด้วยตนเอง และเว็บไซต์ listennotes.com มีผู้ใช้มากกว่า 2,000,000 คนต่อเดือน ทุกคนส่งรายการที่ขาดได้ ช่วยให้ฐานข้อมูลครบและใหม่เสมอ เราตรวจสอบทุกรายการด้วยคนและปฏิเสธพอดแคสต์ปลอม
เราร่วมมือกับโฮสต์รายใหญ่ที่เชื่อมต่อ Podcast API เพื่อส่งรายการโดยตรง

เราตรวจ RSS ทุกพอดแคสต์ตลอด 24 ชั่วโมง รายการที่มีคนฟังล่าสุดผ่านเว็บไซต์หรือ API จะเพิ่มตอนใหม่ภายในหนึ่งชั่วโมง โดยทั่วไป 15–30 นาที ส่วนรายการอื่นมักใช้ 2–4 ชั่วโมง

11. หากละเมิด API Terms of Use จะเกิดอะไรขึ้น 🔗

บัญชีจะถูกระงับหากละเมิด API Terms of Use คุณอุทธรณ์ได้ทาง hello@listennotes.com

สาเหตุที่พบบ่อยที่สุดคือ 1. สร้างหลายบัญชีเพื่อเลี่ยงโควตา FREE โดยเฉพาะใช้อีเมลแบบใช้ครั้งเดียว 2. แคชข้อมูลคำตอบส่วนใหญ่บนเซิร์ฟเวอร์ โปรดปฏิบัติตาม API Terms of Use

12. ต้องแสดงโลโก้ Listen Notes ในแอปแม้ใช้แพ็กเกจแบบชำระเงินหรือไม่ 🔗

ต้องแสดง API Terms of Use ใช้กับผู้ใช้ FREE และ PRO ทุกคน คุณแสดง “Powered by Listen Notes” เพียงหน้าจอเดียวที่ใช้ข้อมูลของเรา ไม่ต้องทุกหน้า และวางโลโก้ใต้ส่วนแรกของหน้าได้

เราไม่มีข้อยกเว้น ไม่ว่าจะเป็นนักพัฒนารายบุคคลหรือบริษัทมหาชน การปรับเฉพาะรายเพิ่มความซับซ้อนและลดเวลาพัฒนาผลิตภัณฑ์หลัก

การแสดงที่มาพบได้ทั่วไปใน API ข้อมูล เช่น Google Places และ Maps API Uber ใช้ Google Maps และแสดงโลโก้ Google ขนาดใหญ่ในแอป

สำหรับ ENTERPRISE เราสามารถยืดหยุ่นเรื่องโลโก้ได้

13. พูดคุยเรื่องความร่วมมือทางโทรศัพท์ได้หรือไม่ 🔗

Listen API ออกแบบให้ใช้งานได้ด้วยตนเอง หากคุณไม่เข้าใจความสามารถและวิธีใช้ภายในไม่กี่นาที แสดงว่าเราอธิบายได้ไม่ดีพอ หากมีคำถาม เริ่มจากอีเมล hello@listennotes.com

คุณจะได้รับคำตอบที่เป็นประโยชน์ทางอีเมลเร็วกว่าการนัดโทรศัพท์มาก

14. ใช้ Listen API บนแพลตฟอร์ม no-code ได้หรือไม่ 🔗

ได้ หากแพลตฟอร์ม no-code เชื่อมต่อ REST API ได้ เช่น ใช้ Listen API ค้นหาพอดแคสต์ในแอปที่สร้างด้วย Bubble หรือ Retool

หากเพียงต้องการฝังพอดแคสต์ ตอน คลิป หรือเพลย์ลิสต์ที่เล่นได้ในเว็บไซต์หรือบล็อก ไม่จำเป็นต้องใช้ Listen API คุณฝังได้ง่ายใน WordPress, Blogger, Ghost, Google Sites, Tumblr และแพลตฟอร์มอื่นอีกมาก

15. มีไลบรารี Podcast API สำหรับภาษาโปรแกรมต่าง ๆ หรือไม่ 🔗

มี เรามีไลบรารีบางภาษาแล้ว และจะเพิ่มภาษาอื่นในอนาคต

16. Listen Notes เก็บข้อมูลใดจากผู้ใช้ API บ้าง 🔗

เราเก็บข้อมูลขั้นต่ำของอุปกรณ์ที่ส่งคำขอไปยังเซิร์ฟเวอร์โดยตรง ได้แก่ 1) IP 2) user-agent 3) endpoint และพารามิเตอร์ ซึ่งเทียบเท่าหนึ่งบรรทัดในบันทึกการเข้าถึง Nginx เท่านั้น

ตัวอย่างเช่น นักพัฒนาสร้างแอปพอดแคสต์ที่มีผู้ใช้จำนวนมาก โดยปกติคำขอ API มาจากเซิร์ฟเวอร์ของนักพัฒนา ซึ่งเป็นตัวกลางระหว่างแอปกับ Listen API เราจึงเห็นเพียง 1) IP เซิร์ฟเวอร์ 2) user-agent เช่น python-requests 3) endpoint และพารามิเตอร์ นอกนั้นเราไม่รู้อะไรเกี่ยวกับผู้ใช้ปลายทาง

17. Listen API จำกัดอัตราคำขอ เช่น N คำขอต่อวินาทีหรือไม่ 🔗

มี เรากำหนดขีดจำกัดอัตราที่สมเหตุสมผล หากใช้อย่างถูกต้อง คุณอาจไม่สังเกตด้วยซ้ำ

REST API ที่จริงจังทุกแห่งต้องจำกัดอัตรา ลองค้นหา “api rate limit” หากไม่มี API จะถูก DDoS ได้ง่าย เช่น โปรแกรมส่งคำขอจำนวนมากจากลูปสั้นหรือไม่มีที่สิ้นสุด ตั้งแต่ปี 2017 เรื่องนี้เกิดบ่อยกว่าที่คาด นักพัฒนาก็เป็นมนุษย์และทำผิดพลาดได้ เราไม่ต้องการให้ผู้ใช้รายเดียวทำระบบล่มและกระทบคนอื่น

FREE มีขีดจำกัดต่ำ PRO สูงขึ้น และ ENTERPRISE สูงที่สุด แต่ละ endpoint ต่างกันตามภาระประมวลผล ผู้ใช้ใหม่เริ่มจากขีดจำกัดค่อนข้างต่ำซึ่งจะเพิ่มขึ้นตามเวลา

18. เราดำเนินการตามคำขอลบพอดแคสต์ภายใต้ DMCA, GDPR และกฎหมายที่คล้ายกันหรือไม่ 🔗

เราดำเนินการตามคำขอลบเนื้อหา อ่านเพิ่มเติม:

ส่งคำขอแทนผู้ใช้ผ่าน DELETE /podcasts/{id} หรือส่งไปที่ hello@listennotes.com

19. ใช้ Listen API สตรีมเสียงพอดแคสต์ในแอปหรือเว็บไซต์ได้อย่างถูกกฎหมายหรือไม่ 🔗

ได้ คุณสตรีมเสียงพอดแคสต์ในแอปหรือเว็บไซต์ผ่าน Listen API ได้อย่างถูกกฎหมาย อ่านเพิ่มเติม

หาก App Store ปฏิเสธแอปเนื่องจากการเชื่อมต่อ API เราพร้อมช่วยเหลือ