Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

YouTube Organic מתקדם — חי

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

YouTube Organic מתקדם — חי

​

מחזיר את התוצאות המדורגות עבור מילת מפתח ב-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.002 דולר ארה״ב.
  • מכפיל לקוח לייחוס: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

זהו מטא-נתון לעיון בלבד, לא הצעת מחיר לחשבון, לא מחיר מובטח ולא תקרת הוצאה. קרדיטי משאבים אינם קרדיטים של Felo. החיוב הסופי נעשה לפי רשומות החיוב של Felo.

גוף
application/json
  • סוג: array (object | null)[]
    • block_depth
      סוג: integer | null

      עומק פענוח שדה אופציונלי מספר בלוקי התוצאות ב-SERP ערך ברירת מחדל: 20 ערך מרבי: 200 הערה: חשבונכם יחויב עבור כל SERP המכיל עד 20 תוצאות; לכן, הגדרת עומק בלוקים מעל 20 עשויה לגרום לחיובים נוספים אם מנוע החיפוש מחזיר יותר מ-20 תוצאות; אם עומק הבלוקים שצוין גבוה ממספר התוצאות בתגובה, ההפרש יוחזר אוטומטית ליתרת חשבונכם

    • device
      סוג: string | null

      סוג המכשיר שדה אופציונלי החזרת תוצאות עבור סוג מכשיר מסוים ערכים זמינים: desktop, mobile

    • keyword
      סוג: string

      מילת מפתח שדה חובה אפשר לציין עד 700 תווים בשדה keyword כל %## יפוענח (והתו ‘+’ יפענח לרווח) אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”; אם אתם צריכים להשתמש בתו “+” ב-keyword, ציינו אותו כ-“%2B”; מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-API של DataForSEO במאמר מרכז העזרה הזה

    • language_code
      סוג: string | null

      קוד שפת מנוע החיפוש שדה חובה אם לא מציינים language_name אם משתמשים בשדה הזה, אין צורך לציין language_name אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: en

    • language_name
      סוג: string | null

      השם המלא של שפת מנוע החיפוש שדה חובה אם לא מציינים language_code אם משתמשים בשדה הזה, אין צורך לציין language_code אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/languages דוגמה: English

    • location_code
      סוג: integer | null

      קוד מיקום מנוע החיפוש שדה חובה אם לא מציינים location_name אם משתמשים בשדה הזה, אין צורך לציין location_name אפשר לקבל את רשימת המיקומים הזמינים של מנועי החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/serp/youtube/locations דוגמה: 2840

    • location_name
      סוג: string | null

      השם המלא של מיקום מנוע החיפוש שדה חובה אם לא מציינים 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

    • search_param
      סוג: string | null

      פרמטרים נוספים של שאילתת החיפוש שדה אופציונלי דוגמה: sp=EgIQAg%253D%253D

    • tag
      סוג: string | null

      מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך tag שציינתם תמצאו באובייקט data של התגובה

תגובות
  • 200
    סוג: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedResponseInfo
    • cost
      סוג: number | null פורמט: double

      סך עלות המשימות, בדולר ארה״ב

    • status_code
      סוג: integer | null

      קוד סטטוס כללי את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • status_message
      סוג: string | null

      הודעה אינפורמטיבית כללית את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

    • tasks
      סוג: array (object | null)[] | null

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_SerpYoutubeOrganicLiveAdvancedTaskInfo
        • cost
          סוג: number | null פורמט: double

          סך עלות המשימות, בדולר ארה״ב

        • data
          סוג: object | null

          מכיל את אותם הפרמטרים שציינתם בבקשת POST

          • propertyName
            סוג: object | null
        • id
          סוג: string | null

          מזהה משימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

        • path
          סוג: array (string | null)[] | null

          נתיב URL

        • result
          סוג: array (object | null)[] | null

          מערך תוצאות

          • check_url
            סוג: string | null

            כתובת URL ישירה לתוצאות מנוע החיפוש אפשר להשתמש בה כדי לוודא שסיפקנו תוצאות מדויקות

          • datetime
            סוג: string | null

            התאריך והשעה שבהם התוצאה התקבלה בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00” דוגמה: 2019-11-15 12:57:46 +00:00

          • item_types
            סוג: array (string | null)[] | null

            סוגי תוצאות חיפוש ב-SERP מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP. סוגי פריטים אפשריים: youtube_channel, youtube_video, youtube_video_paid, youtube_playlist

          • items
            סוג: array (object | null)[] | null

            רכיבי תוצאות החיפוש שנמצאו ב-SERP

            • block_name
              סוג: string | null

              שם הבלוק ב-SERP
              דוגמה:
              "People also watched"

            • block_rank
              סוג: integer | null

              דירוג הבלוק ב-SERP
              מיקום מבין כל הבלוקים ב-SERP

            • channel_id
              סוג: string | null

              מזהה הערוץ

            • rank_absolute
              סוג: integer | null

              דירוג מוחלט ב-SERP עבור הדומיין היעד
              מיקום מוחלט מבין כל הרכיבים ב-SERP

            • rank_group
              סוג: integer | null

              דירוג קבוצה ב-SERP
              מיקום בתוך קבוצת רכיבים עם ערכי type זהים
              מיקומים של רכיבים עם ערכי type שונים מושמטים מ-rank_group

            • type
              סוג: string | null

              סוג הרכיב

            • url
              סוג: string | null

              כתובת URL של הערוץ

          • items_count
            סוג: integer | null פורמט: int64

            מספר התוצאות המוחזרות במערך items

          • keyword
            סוג: string | null

            מילת מפתח שהתקבלה במערך POST מילת המפתח מוחזרת עם פענוח %## (התו '+' יפענח לרווח)

          • language_code
            סוג: string | null

            קוד שפה במערך POST

          • location_code
            סוג: integer | null

            קוד מיקום במערך POST

          • se_domain
            סוג: string | null

            דומיין מנוע החיפוש במערך POST

          • se_results_count
            סוג: integer | null פורמט: int64

            מספר התוצאות הכולל ב-SERP

          • 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

        • result_count
          סוג: integer | null פורמט: int64

          מספר הפריטים במערך result

        • status_code
          סוג: integer | null

          קוד הסטטוס של המשימה נוצר על ידי DataForSEO ויכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

        • status_message
          סוג: string | null

          הודעה אינפורמטיבית של המשימה את הרשימה המלאה של ההודעות האינפורמטיביות הכלליות אפשר למצוא כאן

        • time
          סוג: string | null

          זמן ביצוע, בשניות

    • tasks_count
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks

    • tasks_error
      סוג: integer | null פורמט: int64

      מספר המשימות במערך tasks שהוחזרו עם שגיאה

    • time
      סוג: string | null

      זמן ביצוע כולל, בשניות

    • version
      סוג: string | null

      הגרסה הנוכחית של ה-API

    application/json
  • 400

    לא ניתן היה לעבד את הבקשה. בדקו את פרמטרי הבקשה.

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/dataforseo/serp/youtube/organic/live/advanced
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/youtube/organic/live/advanced \
  --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": [
        {
          "keyword": null,
          "se_domain": null,
          "location_code": null,
          "language_code": null,
          "check_url": null,
          "datetime": null,
          "spell": {
            "keyword": null,
            "type": null
          },
          "item_types": [
            null
          ],
          "se_results_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "rank_group": null,
              "rank_absolute": null,
              "block_rank": null,
              "block_name": null,
              "channel_id": null,
              "url": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Live YouTube Organic Advanced