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 אחר.
אנחנו מציעים מחירים שקופים ותיעוד מלא עם דוגמאות JSON.
אפשר להתחיל ב-FREE בלי כרטיס ובלי שיחת מכירה.
ב-PRO או ENTERPRISE תקבלו תשובה מהירה דרך hello@listennotes.com ישירות מהמייסד וה-CEO.
ייתכן שב-iTunes API חסרים endpoints ונתונים מובנים, תוצאות החיפוש מעטות ולא מדורגות היטב, התנאים מגבילים יותר והתמיכה האנושית מצומצמת יותר.
2. עד כמה מסובך לבנות מסד פודקאסטים? 🔗
בניית מסד פודקאסטים איכותי דורשת עבודה מתמשכת, זמן וכסף לשרתים, מהנדסים ותחזוקה. התחזוקה לטווח ארוך יקרה יותר מההקמה הראשונית.
יש לפחות 3,831,088 פודקאסטים ו-196,732,836 פרקים. עם 3,831,088 פודקאסטים ו-196,732,836 פרקים, זרמי RSS וכתובות שמע משתנים לעיתים קרובות והנתונים דורשים ניקוי אוטומטי וידני מסביב לשעון. חיפוש ב-3,831,088 פודקאסטים וב-196,732,836 פרקים דורש תשתית מורכבת. צריך גם להסיר תוכן מזויף ולשמור על זמינות השרתים.
העלות העיקרית היא עלות ההזדמנות: זמן שמושקע במסד אינו מושקע במוצר שלכם.
Listen API מאפשר להתחיל מיד. יותר מ-2,000,000 משתמשים חודשיים ב-listennotes.com עוזרים לשלוח פודקאסטים חסרים ולתקן נתונים, וכך אנחנו שומרים על מסד איכותי.
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, אבל PRO ו-ENTERPRISE מקבלים עדיפות.
תדברו ישירות עם המייסד וה-CEO של Listen Notes, Inc., שבנה את השירות כולו בעצמו.
6. נשלח המון בקשות API. האם תוכלו לתמוך בהיקף שלנו? 🔗
כיום חברות שולחות עשרות מיליוני בקשות בחודש דרך Listen API. אנחנו יכולים לתמוך בקלות לפחות בפי עשרה מהתעבורה הנוכחית בלי להוסיף שרתים.
אנחנו פועלים לפי שיטות תפעול מומלצות עם ניטור והתראות מקיפים. תקלות נמצאות ומתוקנות במהירות. יש לנו רקורד מצוין של ביצועים וזמינות.
7. האם אפשר לשמור את תגובת ה-API במטמון בצד הלקוח, למשל באפליקציה או בדפדפן? 🔗
כן. תנאי FREE ו-PRO מאפשרים שמירת תגובה במטמון בצד הלקוח, באפליקציה או בדפדפן, אבל בצד השרת אפשר לשמור בקביעות רק podcast/episode ids ו-pub_dates.
אפשר לשמור ולעבד קובצי שמע של פודקאסטים בשרת, למשל ליצירת קטעים או תמלול.
ב-ENTERPRISE אפשר לשמור במטמון את התגובה המלאה בשרתים שלכם.
8. למה כתובות השמע בתגובת ה-API מגיעות מהדומיין listennotes.com? 🔗
איננו מאחסנים שמע בשרתים שלנו, ולכן יוצרי הפודקאסטים ממשיכים לקבל נתוני ניתוח מדויקים, כמו IP ו-user-agent של המאזין.
מכיוון שכתובות שמע משתנות לעיתים קרובות, אנחנו מפנים את הכתובת הקבועה שלנו לכתובת האמיתית באמצעות HTTP 301.
האפליקציה יכולה לשמור במטמון בצד הלקוח את כתובת Listen Notes הקבועה, ואנחנו מוצאים בצד השרת את כתובת השמע הנכונה ועוקבים אחר שינויים.
9. מה עושים אם פודקאסט מסוים חסר או שהנתונים אינם תואמים ל-RSS, למשל שמע שבור או מטא-נתונים שגויים? 🔗
למרות שהמסד שלנו מקיף, ייתכן שלא נמצא תוכנית חדשה מיד, כפי שגם Google זקוקה לזמן כדי למצוא אתר חדש. אפשר לשלוח את התוכנית החסרה.
ייתכן שהיוצר שינה את ה-RSS, שעדיין לא זיהינו את השינוי או שיש שגיאה בזרם. דווחו ל-hello@listennotes.com; בדרך כלל אנחנו מתקנים בתוך דקות. אפשר גם להשתמש בכלי התיקון בשירות עצמי.
10. כיצד אתם שומרים על מסד הפודקאסטים מעודכן? 🔗
אנחנו מוצאים פודקאסטים חדשים בארבע דרכים:
- סורקים מחפשים תוכן ציבורי מסביב לשעון.
- יוצרים שולחים תוכניות חדשות.
- עובדים מוסיפים פודקאסטים חסרים, ויותר מ-2,000,000 משתמשים חודשיים ב-listennotes.com יכולים לשלוח תוכניות חסרות. כל הגשה נבדקת ידנית.
- שירותי אחסון גדולים משלבים את Podcast API שלנו.
אנחנו בודקים את כל זרמי ה-RSS ברציפות. פרקים חדשים של פודקאסטים שנעשה בהם שימוש לאחרונה מופיעים בתוך שעה, בדרך כלל 15–30 דקות; אחרים בתוך 2–4 שעות.
11. מה קורה אם אנחנו מפרים את תנאי השימוש ב-API? 🔗
החשבון יושעה אם תנאי ה-API יופרו. אפשר לערער דרך hello@listennotes.com.
הסיבות הנפוצות ביותר הן יצירת כמה חשבונות לעקיפת מכסת FREE, במיוחד עם כתובות אימייל זמניות, ושמירת רוב נתוני התגובה במטמון בצד השרת. הקפידו לעמוד בתנאים.
12. האם צריך להציג את הלוגו של Listen Notes גם בתוכנית בתשלום? 🔗
כן. תנאי ה-API חלים על כל משתמשי FREE ו-PRO. מספיק להציג "Powered by Listen Notes" במסך אחד שמשתמש בנתונים שלנו, לא בכל מסך. אפשר להציב את הלוגו מתחת לחלק הראשון של הדף.
אין חריגים למשתמשי FREE או PRO, בין אם מדובר במפתח יחיד או בחברה ציבורית. התאמות חד-פעמיות מגדילות את המורכבות ומפחיתות את הזמן לשיפור המוצר.
ייחוס מקור מקובל ב-API של נתונים; למשל Uber מציגה את הלוגו של Google כשהיא משתמשת ב-Google Maps.
ב-ENTERPRISE נוכל להיות גמישים בדרישת הלוגו.
13. האם אפשר לדון בשיתוף הפעולה בטלפון? 🔗
Listen API נועד לשירות עצמי. אם בתוך כמה דקות לא ברור מה הוא עושה וכיצד להשתמש בו, סימן שלא הסברנו מספיק טוב. שאלות אפשר לשלוח תחילה ל-hello@listennotes.com.
תקבלו תשובה מועילה באימייל הרבה יותר מהר מאשר בתיאום שיחת טלפון.
14. האם אפשר להשתמש ב-Listen API בפלטפורמות no-code? 🔗
כן, כל עוד פלטפורמת ה-no-code שבחרתם מאפשרת להתחבר ל-REST API. לדוגמה, אפשר להשתמש ב-Listen API כדי לחפש פודקאסטים באפליקציות Bubble ו-Retool.
אם אתם רק רוצים להטמיע פודקאסטים, פרקים, קטעים או רשימות נגינה, אין צורך ב-API. אפשר להטמיע אותם בקלות ב-WordPress, Blogger, Ghost, Google Sites, Tumblr ופלטפורמות רבות אחרות.
15. האם אתם מספקים ספריות לשפות תכנות שונות? 🔗
16. איזה מידע Listen Notes אוסף ממשתמשי API? 🔗
אנחנו אוספים מידע מינימלי בלבד על המכשיר ששולח בקשות API ישירות: כתובת IP, user-agent, endpoint ופרמטרים. זה למעשה שורה אחת ביומן הגישה של Nginx.
אם שרת המפתח משמש מתווך בין האפליקציה ל-Listen API, אנחנו רואים רק את ה-IP וה-user-agent של השרת ואת ה-endpoint והפרמטרים. איננו יודעים שום דבר נוסף על משתמשי הקצה.
17. האם יש ל-Listen API מגבלות קצב, למשל N בקשות בשנייה? 🔗
כן. ל-endpoints שלנו יש מגבלות קצב סבירות. בשימוש תקין ייתכן שלא תבחינו בהן כלל.
כל REST API רציני זקוק למגבלות כדי למנוע DDoS ולולאות בקשות בשוגג. מאז 2017 ראינו טעויות כאלה לעיתים קרובות מהצפוי, ומשתמש אחד לא צריך לפגוע במערכת כולה.
ל-FREE המגבלה הנמוכה ביותר, ל-PRO גבוהה יותר ול-ENTERPRISE הגבוהה ביותר. המגבלות משתנות לפי עלות החישוב של endpoint, ומגבלות של משתמשים חדשים גדלות עם הזמן.
18. האם אתם מטפלים בבקשות מחיקה לפי DMCA, GDPR וחוקים דומים? 🔗
כן. אנחנו מטפלים בבקשות להסרת תוכן. מידע נוסף:
אפשר להעביר בקשות של משתמשים דרך DELETE /podcasts/{id} או ל-hello@listennotes.com.
19. האם מותר להזרים שמע של פודקאסטים באפליקציה או באתר בעזרת Listen API? 🔗
כן, אפשר להזרים שמע של פודקאסטים באופן חוקי באפליקציה או באתר באמצעות Listen API. מידע נוסף.
אם App Store דוחה את האפליקציה עקב שילוב ה-API, אנחנו כאן כדי לעזור.