Listen APIよくある質問
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を選べます。
Listen APIを評価しやすいよう、透明でシンプルな料金体系と、全endpointとJSON response例を含む包括的なdocumentationを用意しています。
営業担当との会話やdemoの依頼は不要です。card情報なしでFREEプランへ登録し、すぐに試せます。
PRO/ENTERPRISEではhello@listennotes.comへ質問すると、Listen Notesの創業者兼CEOが直接回答します。
AppleのiTunes APIについては、documentationを読みご自身で試すことをおすすめします。適さない可能性がある理由:
- 基本機能に必要なendpointや構造化データが不足している;
- 検索結果が少なくrankingも理想的ではない;
- 利用規約が目的の用途を認めない場合がある;
- 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年時点で17万5千人の正社員と多数のcontractorを抱えていたのには理由があります。
- 機械生成音声やBlack Hat SEOによる偽番組が多数あります。自動・手動の両方で除外する必要があります。Googleにも専任spam teamがあります。Listen Notesも多くのリソースを投入しています。
- データベースと検索を24時間稼働させるには、server障害を防ぐ作業が必要です。
- 有能な正社員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費用を使わず、堅牢なinfrastructureを設計しています。
5. サポートはありますか？ 🔗
はい。PRO/ENTERPRISE利用者はAPIに関する質問をhello@listennotes.comへ送れます。debugのためsample codeやrequest/responseをお願いする場合があります。FREEで個別サポートは保証しませんが、documentationとFAQを利用できます。
6. 大量のAPIリクエストにも対応できますか？ 🔗
現在、月数千万件のリクエストを処理する企業もあります。serverを追加しなくても現状の少なくとも10倍のtrafficに対応できます。
非常に大規模な利用を予定している場合は、capacity planningを支援しますのでhello@listennotes.comへご連絡ください。
7. APIレスポンスをアプリやブラウザなどクライアント側でキャッシュできますか？ 🔗
はい。FREE/PROのAPI Terms of Useではclient側のcacheを認めていますが、podcast/episode idとpub_date以外をserver側へcacheできません。
serverや自社データベースへ永続保存できるのはidとpub_dateだけです。このno-caching方針はGoogle Maps APIなどData APIでは一般的です（ページ内で「No Scraping」を検索）。
実際の音声ファイルはserverへ保存し、clip作成やspeech-to-textなどの処理ができます。
ENTERPRISEプランではresponse data全体をserverへcacheできます。
8. APIレスポンスの音声URLがlistennotes.comドメインなのはなぜですか？ 🔗
当社のserverに音声を保存しているわけではありません。ポッドキャスターはlistenerのIPやuser-agentなど正確なanalyticsを受け取れます。
音声URLは頻繁に変わるため、正しいURLを見つけやすくする目的で実URLを当社の恒久URL（HTTP 301）で包みます。例: audio.listennotes.com/e/p/997c4db8bd224df78f0716a3a8c05f5d。
appが性能向上のためclient側へdataをcacheするのは一般的です。clientには恒久的なListen Notes URLを保存し、当社serverが正しい音声URLを判定します。音声変更も常に確認しています。
9. 特定のポッドキャストが見つからない、または音声リンク切れやメタデータ誤りなど、RSS feedと同期していない場合は？ 🔗
データベースは包括的ですが、新番組をすぐ追加できない場合があります。Googleのcrawlerが新サイトを見つけてindexするのに時間がかかるのと同じです。未登録番組を投稿してご協力ください。
制作者がRSS feedを変更して当社の検出が遅れたり、feed自体にerrorがある場合もあります。Google結果に古いページや404が残るのと同様です。メタデータの誤りはhello@listennotes.comへご報告ください。通常は数分で修正します。self-service toolで修正することもできます。良き市民としてご協力を :)
10. データベースを最新の状態に保つ方法は？ 🔗
新しいポッドキャストは4つの方法で探します。
- 公開ポッドキャストを探すcrawlerを24時間稼働。
- ポッドキャスター自身が新番組を投稿。毎日数百件届きます。
- スタッフが未登録番組を手作業で追加。毎月2,000,000人以上がlistennotes.comを利用し、未登録番組を投稿できます。すべて人が確認し、偽番組は除外します。
- 大手ホスティングサービスがPodcast APIと連携し、番組を直接投稿。
全RSS feedを常時確認します。最近聴かれた番組の新エピソードは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利用者に適用されます。当社データを使う画面のうち1画面に「Powered by Listen Notes」を表示すればよく、すべての画面には不要です。
ENTERPRISEではロゴ表示不要です。
HTML埋め込みplayerとListen APIは別製品です。有料APIプランでも埋め込みplayerのロゴは削除できません。
13. 提携について電話で相談できますか？ 🔗
Listen APIはself-service向けです。数分で機能と使い方を理解できないなら、当社のdesignやdocumentationに改善の余地があります。
提携について電話での相談が本当に必要な場合は、まずhello@listennotes.comへご連絡ください。
14. no-codeプラットフォームでListen APIを使えますか？ 🔗
再生可能なポッドキャスト、エピソード、クリップ、playlistをサイトやブログへ埋め込むだけならListen APIは不要です。WordPress、Blogger、Ghost、Google Sites、Tumblr、その他多くの公開プラットフォームへ簡単に埋め込めます。
15. Podcast APIの言語別ライブラリはありますか？ 🔗
16. Listen NotesはAPI利用者からどのような情報を収集しますか？ 🔗
APIリクエストを当社serverへ直接送るdeviceについて、必要最小限の情報だけを収集します。1) IP address、2) user-agent、3) endpointとparameterです。実質的にはNginx access logの1行だけです。
一般的なポッドキャストアプリでは、APIリクエストは利用者のアプリではなく開発者のserverから送られます。serverがproxyになるため、当社が把握するのはserverのIP、user-agent、endpointとparameterのみで、アプリの利用者について他の情報は分かりません。
17. Listen APIにレート制限（毎秒N件など）はありますか？ 🔗
はい。各endpointに妥当なレート制限があります。正しく利用していれば、制限の存在に気づかないかもしれません。
本格的なREST APIにはレート制限が不可欠です。Googleで「api rate limit」を検索してください。制限がなければDDoSや、誤ったloopによる大量リクエストで簡単に停止します。2017年から運営してきた経験上、これは予想以上に起きます。1人の誤利用で他の利用者に影響を与えないための仕組みです。
FREEは低め、PROは高め、ENTERPRISEは最高の制限です。計算負荷に応じてendpointごとに異なります。新規利用者の制限は比較的低く、時間とともに引き上げられます。
18. DMCAやGDPRなどに基づく削除依頼に対応していますか？ 🔗
はい。コンテンツ削除依頼に対応します。詳細:
利用者からの削除依頼はDELETE /podcasts/{id}で当社へ転送するか、hello@listennotes.comへ案内してください。