Listen APIFAQ
API 버전: V2 ·
PodcastAPI.com
Listen API 일반 질문에 대한 답변입니다.
https://www.podcastapi.com/llms-full.txt를 읽으면 Listen Notes에서 Podcast API에 대해 질문할 수 있습니다.
질문이 있으신가요?
hello@listennotes.com
1. iTunes API 대신 Listen API를 사용해야 하는 이유는 무엇인가요? 🔗
다른 선택지도 있습니다. 자체 팟캐스트 데이터베이스를 구축·유지하거나 인터넷의 다른 Podcast API를 선택할 수 있습니다.
평가를 돕기 위해 투명하고 단순한 가격과 모든 endpoint 및 샘플 JSON response가 포함된 문서를 제공합니다.
영업 담당자와 이야기하거나 demo를 요청할 필요가 없습니다. 카드 정보 없이 FREE 플랜을 구독하고 즉시 사용할 수 있습니다.
PRO/ENTERPRISE 사용자는 hello@listennotes.com으로 질문하면 Listen Notes 창업자 겸 CEO가 직접 답합니다.
Apple의 iTunes API는 문서를 읽고 직접 시험해 보세요. 적합하지 않을 수 있는 이유:
- 기본 기능에 필요한 endpoint와 구조화 데이터가 부족함;
- 검색 결과가 적고 순위가 이상적이지 않음;
- 서비스 약관이 원하는 용도를 허용하지 않을 수 있음;
- Apple의 핵심 제품이 아니어서 적극적으로 유지되지 않을 수 있음;
- enterprise API에는 사람의 지원이 중요하지만 Apple에서 빠르고 유용한 답변을 받기 어려울 수 있음.
2. 팟캐스트 데이터베이스 구축은 얼마나 어려운가요? 🔗
좋은 팟캐스트 데이터베이스 구축은 지속적인 작업입니다. 어렵지는 않지만 server 비용, engineer 인건비와 시간이 필요합니다. 자동차나 집처럼 초기 비용보다 유지 비용과 시간이 더 큽니다.
고려할 사항:
- 인터넷에는 최소 3,831,088개 팟캐스트와 196,732,836개 에피소드가 있으며 빠르게 늘어납니다. 데이터를 host하고 업데이트해야 합니다.
- 3,831,088개와 196,732,836개를 다루면 RSS feed와 오디오 URL이 예상보다 자주 바뀝니다. 자동 도구와 수동 작업으로 계속 정리해야 합니다.
- 3,831,088개와 196,732,836개를 keyword로 검색하려면 검색 엔진이 필요합니다. UI는 단순해 보여도 backend는 매우 복잡합니다. Google이 2022년 정규직 175,000명과 수많은 contractor를 둔 이유가 있습니다.
- 기계 생성 오디오와 Black Hat SEO용 가짜 팟캐스트가 많습니다. 자동 및 수동 절차로 제외해야 합니다. Google에도 전담 web spam team이 있습니다. Listen Notes도 많은 자원을 투입합니다.
- 데이터베이스와 검색 엔진을 24시간 운영하려면 server 장애를 막는 작업이 필요합니다.
- 유능한 정규직 software engineer 비용과 당사 API 같은 third-party cloud service 비용을 비교하세요.
가장 큰 비용은 기회비용입니다. 자체 데이터베이스에 쓰는 시간은 앱이나 웹사이트 개발에 쓸 수 없습니다.
Listen API를 이용하면 프로젝트의 핵심 부분을 즉시 시작할 수 있습니다. 매달 2,000,000명 이상이 listennotes.com을 이용하며 누락된 팟캐스트 제출과 잘못된 데이터 수정을 돕습니다. 전 세계 사용자의 도움으로 품질을 유지합니다.
3. API를 적극적으로 지원하고 있으며 앞으로도 계속할 예정인가요? 🔗
둘 다 예입니다.
Listen API는 공개 웹사이트 ListenNotes.com을 구동하며 Listen Notes의 backend 개선 대부분이 API에도 적용됩니다. 2017년부터 운영했으며 앞으로도 장기간 운영할 계획입니다.
4. Listen API가 향후 종료되면 어떻게 되나요? 🔗
우려는 타당합니다. 어떤 온라인 서비스나 회사도 영원하지 않습니다. 예를 들어 Google도 많은 제품을 종료했습니다.
Listen API를 종료한다면 최소 12주 전에 알리고 최신 데이터베이스 덤프(모든 팟캐스트와 에피소드)를 합리적인 낮은 가격에 구매할 수 있도록 하겠습니다.
Listen Notes는 많은 투자받은 startup이나 상장사보다 오래 지속될 수 있습니다. 적은 인원으로 효율적으로 운영해 큰 인건비 부담이 없으며, server 비용을 낭비하지 않고 견고한 인프라를 설계했습니다.
5. 지원을 제공하나요? 🔗
예. PRO/ENTERPRISE 사용자는 API 질문을 hello@listennotes.com으로 보낼 수 있습니다. debug를 위해 sample code나 request/response를 요청할 수 있습니다. FREE에는 개인 지원이 보장되지 않지만 문서와 FAQ를 제공합니다.
6. 매우 많은 API 요청도 감당할 수 있나요? 🔗
현재 월 수천만 건의 요청을 처리하는 기업도 있습니다. server 추가 없이 현재 traffic의 최소 10배를 처리할 수 있습니다.
매우 큰 규모를 계획한다면 capacity planning을 도와드리므로 hello@listennotes.com으로 연락하세요.
7. 앱이나 브라우저 등 클라이언트에서 API 응답을 캐시할 수 있나요? 🔗
예. FREE/PRO API Terms of Use는 client-side cache를 허용하지만 podcast/episode id와 pub_date를 제외한 server-side cache는 허용하지 않습니다.
server 또는 자체 데이터베이스에 영구 저장할 수 있는 것은 id와 pub_date뿐입니다. 이런 no-caching 정책은 Google Maps API 등 Data API에서 일반적입니다(페이지에서 "No Scraping" 검색).
실제 팟캐스트 오디오 파일은 server에 저장하고 클립 제작이나 speech-to-text 등으로 처리할 수 있습니다.
ENTERPRISE 플랜은 response data 전체를 server에 cache할 수 있습니다.
8. API 응답의 오디오 URL이 listennotes.com 도메인인 이유는 무엇인가요? 🔗
당사 server에 오디오를 저장하지 않습니다. 팟캐스터는 청취자 IP, user-agent 등 정확한 analytics를 받습니다.
오디오 URL이 자주 바뀌므로 올바른 URL을 찾도록 실제 URL을 당사의 영구 URL(HTTP 301)로 감쌉니다. 예: audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d.
앱이 성능을 위해 client에 data를 cache하는 것은 일반적입니다. client에는 영구적인 Listen Notes URL을 저장하고 server에서 실제 오디오 URL을 찾습니다. 변경 여부도 지속적으로 확인합니다.
9. 특정 팟캐스트를 찾을 수 없거나 오디오 링크 오류, 잘못된 메타데이터 등 RSS feed와 동기화되지 않은 경우에는 어떻게 하나요? 🔗
데이터베이스가 매우 포괄적이지만 새 프로그램을 제때 추가하지 못할 수 있습니다. Google 크롤러가 새 사이트를 찾아 index하는 데 시간이 필요한 것과 같습니다. 누락된 프로그램을 제출해 주세요.
제작자가 RSS feed를 변경했는데 감지가 늦거나 feed에 오류가 있을 수도 있습니다. Google 검색에 오래된 페이지나 404가 남는 것과 같습니다. 메타데이터 오류는 hello@listennotes.com으로 신고하면 보통 몇 분 내에 수정합니다. 또는 self-service 도구로 직접 수정해 주세요 :)
10. 팟캐스트 데이터베이스를 최신 상태로 유지하는 방법은 무엇인가요? 🔗
새 팟캐스트를 네 가지 방법으로 찾습니다.
- 공개 팟캐스트를 찾는 크롤러를 24시간 가동합니다.
- 팟캐스터가 직접 새 프로그램을 제출하며 매일 수백 건을 받습니다.
- 직원이 누락된 팟캐스트를 직접 추가합니다. 매월 2,000,000명 이상이 listennotes.com을 사용하며 누락된 프로그램을 제출할 수 있습니다. 모든 제출을 검토하고 가짜 프로그램은 거부합니다.
- 주요 호스팅 서비스가 Podcast API와 연동해 프로그램을 직접 제출합니다.
모든 RSS feed를 24시간 확인합니다. 최근 청취된 팟캐스트의 새 에피소드는 1시간 이내(보통 15~30분), 그 외에는 보통 2~4시간 이내에 추가됩니다.
11. API Terms of Use를 위반하면 어떻게 되나요? 🔗
API Terms of Use를 위반하면 계정이 중단됩니다. 이의 제기는 hello@listennotes.com으로 보내세요.
흔한 사유는 1. 일회용 이메일 등으로 여러 계정을 만들어 FREE 한도를 우회하는 행위, 2. response data 대부분을 server에 cache하는 행위입니다. 약관을 준수하세요.
12. 유료 플랜에서도 앱에 Listen Notes 로고를 표시해야 하나요? 🔗
예. API Terms of Use는 모든 FREE/PRO 사용자에게 적용됩니다. 당사 데이터를 쓰는 화면 중 한 곳에 "Powered by Listen Notes"를 표시하면 되며 모든 화면에는 필요하지 않습니다.
ENTERPRISE에는 로고 표시 의무가 없습니다.
HTML 임베드 플레이어와 Listen API는 별도 제품이며 유료 API 플랜에서도 플레이어 로고를 제거할 수 없습니다.
13. 전화로 파트너십을 논의할 수 있나요? 🔗
Listen API는 self-service용입니다. 몇 분 내에 기능과 사용법을 이해할 수 없다면 저희 design이나 문서가 부족한 것입니다.
파트너십 관련 전화 상담이 꼭 필요하다면 먼저 hello@listennotes.com으로 연락하세요.
14. no-code 플랫폼에서 Listen API를 사용할 수 있나요? 🔗
15. Podcast API용 프로그래밍 언어별 라이브러리를 제공하나요? 🔗
16. Listen Notes는 API 사용자에게서 어떤 정보를 수집하나요? 🔗
당사 server로 API 요청을 직접 보내는 device에 대해 최소한의 정보만 수집합니다. 1) IP address, 2) user-agent, 3) endpoint와 parameter입니다. 사실상 Nginx access log 한 줄뿐입니다.
일반적인 팟캐스트 앱에서는 요청이 사용자 앱이 아니라 개발자 server에서 전송되며 server가 proxy 역할을 합니다. 따라서 server IP, user-agent, endpoint와 parameter만 추적하며 앱 최종 사용자에 대해서는 다른 정보를 알지 못합니다.
17. Listen API에 속도 제한(초당 N회 등)이 있나요? 🔗
예. endpoint에 합리적인 속도 제한을 적용합니다. 올바르게 사용하면 제한이 있다는 사실조차 모를 수 있습니다.
모든 신뢰할 수 있는 REST API에는 속도 제한이 필요합니다. Google에서 "api rate limit"을 검색해 보세요. 제한이 없으면 DDoS나 잘못된 loop로 짧은 시간에 대량 요청이 발생할 수 있습니다. 2017년 이후 경험상 예상보다 자주 발생합니다. 한 사용자의 실수가 전체 시스템과 다른 사용자에게 영향을 주지 않도록 하기 위한 장치입니다.
FREE는 낮고 PRO는 더 높으며 ENTERPRISE가 가장 높습니다. 계산 비용에 따라 endpoint별로 다릅니다. 신규 사용자는 비교적 낮은 한도로 시작하며 시간이 지나면 높아집니다.
18. DMCA, GDPR 및 유사 법률에 따른 삭제 요청을 처리하나요? 🔗
예. 콘텐츠 삭제 요청을 처리합니다. 자세히 보기:
사용자의 삭제 요청은 DELETE /podcasts/{id} endpoint로 전달하거나 hello@listennotes.com으로 안내하세요.