DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
YouTube Video Info מתקדם — חי
מחזיר את המטא-נתונים של סרטון 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.006 דולר ארה״ב.
- מכפיל לקוח לייחוס: 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
- tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך tag שציינתם תמצאו באובייקט data של התגובה
- videoסוג: string
_id מזהה הסרטון שדה חובה אפשר למצוא את מזהה הסרטון בכתובת ה-URL או בפריט 'youtube_video' בתוצאת YouTube Organic דוגמה: vQXvyV0zIP4
- סוג: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpYoutubeVideoInfoLiveAdvancedTaskInfo
- 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
מערך תוצאות
- 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_video_info
- itemsסוג: array (object | null)[] | null
רכיבי תוצאות החיפוש שנמצאו ב-SERP
- categoryסוג: string | null
הקטגוריה שאליה משתייך הסרטון
- channelסוג: string | null
_id המזהה של הערוץ שבו הסרטון מפורסם
- channelסוג: string | null
_logo כתובת ה-URL של העמוד שבו מתארחת תמונת הלוגו של הערוץ
- channelסוג: string | null
_name שם הערוץ שבו הסרטון פורסם
- channelסוג: object | null · Response36Afe1097B20_ChannelSubscribersCount
_subscribers _count מספר המנויים של הערוץ
- countסוג: integer | null פורמט: int64
מספר המנויים
- displayedסוג: string | null
_count מספר המנויים המוצג
מספר המנויים כפי שמוצג ב-YouTube
- channelסוג: string | null
_url כתובת ה-URL של הערוץ שבו הסרטון פורסם
- commentsסוג: integer | null פורמט: int64
_count מספר התגובות בסרטון
- descriptionסוג: string | null
תיאור הסרטון
- durationסוג: string | null
_time משך הווידאו
- durationסוג: integer | null
_time _seconds משך הווידאו בשניות
- isסוג: boolean | null
_embeddable מציין אם ניתן להטמיע את הסרטון
- isסוג: boolean | null
_live מציין אם הסרטון משודר בשידור חי
- keywordsסוג: array (string | null)[] | null
מילות מפתח רלוונטיות לסרטון
ידועות גם כ'תגיות YouTube' - likesסוג: integer | null פורמט: int64
_count מספר הלייקים בסרטון
- publicationסוג: string | null
_date התאריך שבו הסרטון פורסם
- rankסוג: integer | null
_absolute דירוג מוחלט ב-SERP עבור הדומיין היעד
מיקום מוחלט מבין כל הרכיבים ב-SERP - rankסוג: integer | null
_group דירוג קבוצה ב-SERP
מיקום בתוך קבוצת רכיבים עם ערכיtypeזהים
מיקומים של רכיבים עם ערכיtypeשונים מושמטים מ-rank_group - streamingסוג: array (object | null)[] | null
_quality מערך של רכיבים המכילים מידע על כל איכויות הסטרימינג האפשריות של הסרטון
- bitrateסוג: integer | null
- fpsסוג: integer | null
- heightסוג: integer | null
גובה הסרטון בפיקסלים
- labelסוג: string | null
תווית רכיב האיכות
- mimeסוג: string | null
_type - typeסוג: string | null
סוג הרכיב
- widthסוג: integer | null פורמט: int64
רוחב הסרטון בפיקסלים
- subtitlesסוג: array (object | null)[] | null
מערך של רכיבים המתארים מאפיינים של כתוביות בסרטון
- isסוג: boolean | null
_auto _generated מציין אם הכתוביות נוצרות אוטומטית
- isסוג: boolean | null
_translatable מציין אם הכתוביות ניתנות לתרגום
- languageסוג: string | null
שפת הכתוביות
- thumbnailסוג: string | null
_url כתובת ה-URL של העמוד שבו מתארחת תמונת התצוגה המקדימה
- timestampסוג: string | null
התאריך והשעה שבהם התוצאה מפורסמת
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:2022-11-15 12:57:46 +00:00 - titleסוג: string | null
כותרת הסרטון
- typeסוג: string | null
סוג הרכיב
- urlסוג: string | null
כתובת ה-URL של הווידאו
- videoסוג: string | null
_id מזהה הסרטון שהתקבל במערך POST
- viewsסוג: integer | null פורמט: int64
_count מספר הצפיות בסרטון
- itemsסוג: integer | null פורמט: int64
_count מספר התוצאות המוחזרות במערך items
- languageסוג: string | null
_code קוד שפה במערך POST
- locationסוג: integer | null
_code קוד מיקום במערך POST
- 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
- 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_info/live/advanced \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"video_id": "vQXvyV0zIP4"
}
]'
{
"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
],
"items_count": null,
"items": [
{
"type": null,
"rank_group": null,
"rank_absolute": null,
"video_id": null,
"title": null,
"url": null,
"thumbnail_url": null,
"channel_id": null,
"channel_name": null,
"channel_url": null,
"channel_logo": null,
"description": null,
"views_count": null,
"likes_count": null,
"comments_count": null,
"channel_subscribers_count": "[Max Depth Exceeded]",
"publication_date": null,
"timestamp": null,
"keywords": [
"[Max Depth Exceeded]"
],
"category": null,
"is_live": null,
"is_embeddable": null,
"duration_time": null,
"duration_time_seconds": null,
"subtitles": [
"[Max Depth Exceeded]"
],
"streaming_quality": [
"[Max Depth Exceeded]"
]
}
]
}
]
}
]
}