DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
הגדרת משימות YouTube Organic
מכניס לתור את התוצאות המדורגות עבור מילת מפתח ב-YouTube, ומחזיר id של משימה ב-tasks[0].id. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. התאום החי עונה מיד ופשוט יותר לשאילתה בודדת; השתמשו בתור כשהקבוצה תארך יותר מקריאת כלי אחת.
מראה תמחור
- מדידה: עלות תגובה מדווחת.
- אומדן בקשת ייחוס: 0.02 דולר ארה״ב.
- מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.
זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.
- סוג: array (object | null)[]
- blockסוג: integer | null
_depth עומק פענוח שדה אופציונלי מספר בלוקי התוצאות ב-SERP ערך ברירת מחדל: 20 ערך מרבי: 700 הערה: חשבונכם יחויב עבור כל SERP המכיל עד 20 בלוקי תוצאות; לכן, הגדרת עומק בלוקים מעל 20 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-20 תוצאות; אם עומק הבלוקים שצוין גבוה ממספר התוצאות בתגובה, ההפרש יוחזר אוטומטית ליתרת חשבונכם
- deviceסוג: string | null
סוג המכשיר שדה אופציונלי החזרת תוצאות עבור סוג מכשיר מסוים ערכים זמינים: desktop, mobile
- keywordסוג: string
מילת מפתח שדה חובה אפשר לציין עד 700 תווים בשדה keyword כל %## יפוענח (והתו ‘+’ יפענח לרווח) אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”; אם אתם צריכים להשתמש בתו “+” ב-keyword, ציינו אותו כ-“%2B”; מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-API של DataForSEO במאמר מרכז העזרה הזה
- 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
מערכת ההפעלה של המכשיר שדה אופציונלי אם מציינים desktop בשדה device, בחרו מבין הערכים הבאים: windows, macos ערך ברירת מחדל: windows אם מציינים mobile בשדה device, בחרו מבין הערכים הבאים: android, ios ערך ברירת מחדל: android
- pingbackסוג: string | null
_url כתובת URL להתראה על השלמת משימה שדה אופציונלי כשהמשימה תושלם, נודיע לכם באמצעות בקשת GET שתישלח לכתובת ה-URL שציינתם אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה. דוגמה: http://your-server.com/pingscript?id=$id http://your-server.com/pingscript?id=$id&tag=$tag הערה: תווים מיוחדים ב-pingback_url יקודדו ב-urlencoded; לדוגמה, התו # יקודד ל-%23 מידע נוסף במרכז העזרה
- postbackסוג: string | null
_data סוג הנתונים של postback_url שדה חובה אם מציינים postback_url מתאים לסוג הנתונים שיישלח לשרת שלכם ערך אפשרי: advanced
- postbackסוג: string | null
_url כתובת URL להחזרת תוצאות המשימה שדה אופציונלי כשהמשימה תושלם, נשלח בקשת POST עם התוצאות שלה דחוסות בפורמט gzip אל postback_url שציינתם אפשר להשתמש במחרוזת ‘$id’ כמשתנה $id וב-‘$tag’ כמשתנה $tag מקודד ב-urlencoded. נעדכן את הערכים הנדרשים לפני שליחת הבקשה. דוגמה: http://your-server.com/postbackscript?id=$id http://your-server.com/postbackscript?id=$id&tag=$tag הערה: תווים מיוחדים ב-postback_url יקודדו ב-urlencoded; לדוגמה, התו # יקודד ל-%23 מידע נוסף במרכז העזרה
- priorityסוג: integer | null
עדיפות המשימה שדה אופציונלי יכול לקבל את הערכים הבאים: 1 – עדיפות ביצוע רגילה (מוגדרת כברירת מחדל) 2 – עדיפות ביצוע גבוהה תחויבו בתשלום נוסף עבור משימות בעדיפות ביצוע גבוהה. אפשר לחשב את העלות בעמוד התמחור.
- searchסוג: string | null
_param פרמטרים נוספים של שאילתת החיפוש שדה אופציונלי דוגמה: sp=EgIQAg%253D%253D
- tagסוג: string | null
מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך tag שציינתם תמצאו באובייקט data של התגובה
- סוג: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostResponseInfo200
- סוג: number | null פורמט: doublecost
סך עלות המשימות, בדולר ארה״ב
- סוג: integer | nullstatus
_code קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן
- סוג: string | nullstatus
_message הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן
- סוג: array (object | null)[] | nulltasks
מערך משימות
- סוג: object | null · Response36Afe1097B20_SerpYoutubeOrganicTaskPostTaskInfo
- costסוג: number | null פורמט: double
סך עלות המשימות, בדולר ארה״ב
- dataסוג: object | null
מכיל את אותם הפרמטרים שציינתם בבקשת POST
- propertyסוג: object | null
Name
- idסוג: string | null
מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID
- pathסוג: array (string | null)[] | null
נתיב URL
- resultסוג: object | null
מערך התוצאותבמקרה הזה, הערך יהיה null
- 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/organic/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"language_code": "en",
"location_code": 2840,
"keyword": "audi"
}
]'
{
"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": null
}
]
}