DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
YouTube Subtitles Advanced — חי
מחזיר מסלול כתוביות של סרטון YouTube אחד ב-YouTube, באופן סינכרוני. מחזיר keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count ו-items. advanced היא ברירת המחדל; בחרו regular כשמעניינת רק הרשימה המדורגת, ו-html רק כדי לבדוק מה הפרסר השמיט. עטוף במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — בקשה שנדחתה עדיין מחזירה HTTP 200.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- deviceסוג: string | null
סוג המכשיר שדה אופציונלי הערך היחיד: desktop
- languageסוג: string | null
_code קוד שפת מנוע החיפוש שדה חובה אם לא מציינים language_name אם משתמשים בשדה הזה, אין צורך לציין language_name אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: en
- languageסוג: string | null
_name השם המלא של שפת מנוע החיפוש שדה חובה אם לא מציינים language_code אם משתמשים בשדה הזה, אין צורך לציין language_code אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: English
- locationסוג: integer | null
_code קוד מיקום מנוע החיפוש שדה חובה אם לא מציינים location_name אם משתמשים בשדה הזה, אין צורך לציין location_name אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/locations דוגמה: 2840
- locationסוג: string | null
_name השם המלא של מיקום מנוע החיפוש שדה חובה אם לא מציינים location_code אם משתמשים בשדה הזה, אין צורך לציין location_code אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/locations דוגמה: United States
- osסוג: string | null
מערכת ההפעלה של המכשיר שדה אופציונלי בחרו מבין הערכים הבאים: windows, macos ערך ברירת מחדל: windows
- subtitlesסוג: string | null
_language קוד השפה של הטקסט המקורי אפשר לקבל את קוד השפה מתוצאת YouTube Video Info
- subtitlesסוג: string | null
_translate _language קוד השפה של הטקסט המתורגם ערכים אפשריים: "az", "ay", "ak", "sq", "am", "en", "ar", "hy", "as", "af", "eu", "be", "bn", "my", "bg", "bs", "bho", "cy", "hu", "vi", "haw", "ht", "gl", "lg", "el", "ka", "gn", "gu", "gd", "da", "fy", "zu", "iw", "ig", "yi", "id", "ga", "is", "es", "it", "yo", "kk", "kn", "ca", "qu", "rw", "ky", "zh-Hant", "zh-Hans", "ko", "co", "xh", "ku", "km", "lo", "la", "lv", "ln", "lt", "lb", "mk", "mg", "ms", "ml", "dv", "mt", "mi", "mr", "mn", "und", "de", "ne", "nl", "no", "ny", "or", "om", "pa", "fa", "pl", "pt", "ps", "ro", "ru", "sm", "sa", "ceb", "nso", "sr", "si", "sd", "sk", "sl", "so", "sw", "su", "tg", "th", "ta", "tt", "te", "ti", "ts", "tr", "tk", "uz", "ug", "uk", "ur", "fil", "fi", "fr", "ha", "hi", "hmn", "hr", "cs", "sv", "sn", "ee", "eo", "et", "st", "jv", "ja", "kri"
- tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך tag שציינתם תמצאו באובייקט data של התגובה
- videoסוג: string
_id מזהה הסרטון שדה חובה אפשר למצוא את מזהה הסרטון בכתובת ה-URL או בפריט 'youtube_video' בתוצאת YouTube Organic דוגמה: Y8Wu4rSNJms
- סוג: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpYoutubeVideoSubtitlesLiveAdvancedTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: array (object | null)[] | null
מערך תוצאות
- categoryסוג: string | null
הקטגוריה שאליה משתייך הסרטוןהערה: השדה הזה מיושן ותמיד מחזיר null
- checkסוג: string | null
_url כתובת URL ישירה לתוצאות מנוע החיפושאפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות
- datetimeסוג: string | null
התאריך והשעה שבהם התוצאה התקבלהבפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”דוגמה:2019-11-15 12:57:46 +00:00
- itemסוג: array (string | null)[] | null
_types סוגי תוצאות חיפוש ב-SERPמכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP.פריט אפשרי:youtube_subtitles
- itemsסוג: array (object | null)[] | null
רכיבי תוצאות החיפוש שנמצאו ב-SERP
- durationסוג: number | null
_time משך הכתוביות בשניות
- endסוג: number | null
_time השנייה שבה מסתיים הטקסט עם הכתוביות
- rankסוג: integer | null
_absolute דירוג מוחלט ב-SERP עבור דומיין היעד
מיקום מוחלט מבין כל הרכיבים ב-SERP - rankסוג: integer | null
_group דירוג קבוצה ב-SERP
מיקום בתוך קבוצה של רכיבים עם ערכיtypeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - startסוג: number | null
_time השנייה שבה מתחיל הטקסט עם הכתוביות
- textסוג: string | null
טקסט מתורגם בכתוביות
- typeסוג: string | null
סוג הרכיב
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות המוחזרות במערך items
- languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- originסוג: string | null
_language קוד השפה של הטקסט המקורי
- seסוג: string | null
_domain דומיין מנוע החיפוש במערך POST
- spellסוג: object | null · Response36Afe1097B20_SpellInfo
תיקון אוטומטי של מנוע החיפושאם מנוע החיפוש סיפק תוצאות למילת מפתח שתוקנה, נציין את מילת המפתח שתוקנה על ידי מנוע החיפוש ואת סוג התיקון האוטומטי
- keywordסוג: string | null
מילת מפתח שהתקבלה כתוצאה מתיקון אוטומטי של מנוע החיפוש התוצאות יסופקו עבור מילת המפתח המתוקנת
- typeסוג: string | null
סוג התיקון האוטומטי ערכים אפשריים: did_you_mean, showing_results_for, no_results_found_for, including_results_for הערה: Yahoo ו-Yandex תומכים רק בסוג התיקון האוטומטי הבא: including_results_for
- subtitlesסוג: integer | null פורמט: int64
_count מספר הכתוביות בסרטון
- titleסוג: string | null
כותרת הסרטון
- translateסוג: string | null
_language קוד השפה של הטקסט המתורגם
- unsupportedסוג: boolean | null
_language מציין אם השפה אינה נתמכת במערכת
- videoסוג: string | null
_id מזהה הסרטון שהתקבל במערך POST
- resultסוג: integer | null פורמט: int64
_count מספר הפריטים במערך result
- statusסוג: integer | null
_code קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- statusסוג: string | null
_message הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- timeסוג: string | null
זמן ביצוע, בשניות
- סוג: integer | null פורמט: int64tasks
_count מספר המשימות במערך tasks
- סוג: integer | null פורמט: int64tasks
_error מספר המשימות במערך tasks שהוחזרו עם שגיאה
- סוג: string | nulltime
זמן ביצוע כולל, בשניות
- סוג: string | nullversion
הגרסה הנוכחית של ה-API
application/json - 400
לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.
- 401
נדרש מפתח API תקף של Felo.
- 402
לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.
- 403
החשבון אינו מורשה לבצע את הפעולה הזו.
- 429
הגעתם למגבלת בקשות או לתקרת הוצאה.
- 502
השירות לא הצליח להשלים את הבקשה.
- 503
שירות ה-API או החיוב אינו זמין באופן זמני.
- 504
השירות פג בזמן הטיפול בבקשה.
- default
תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/video_subtitles/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "Y8Wu4rSNJms"
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": [
{
"video_id": null,
"se_domain": null,
"location_code": null,
"language_code": null,
"check_url": null,
"datetime": null,
"spell": {
"keyword": null,
"type": null
},
"item_types": [
null
],
"unsupported_language": null,
"translate_language": null,
"origin_language": null,
"category": null,
"subtitles_count": null,
"title": null,
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"text": null,
"start_time": null,
"end_time": null,
"duration_time": null
}
]
}
]
}
]
}