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

הערכת תנועה מרוכזת

שרת:https://openapi.felo.ai
ספריות לקוח

DataForSEO

​

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

הערכת תנועה מרוכזת

​

תנועה אורגנית מוערכת עבור דומיינים רבים בקריאה אחת. אין כאן פרמטר limit, אך התמחור לפי קריאה ולא לפי פריט, לכן שלחו את כל הרשימה בבת אחת. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. המחיר לפי קריאה, וכך מדרגים רשימת מתחרים בזול לפני שמוציאים קריאות לכל דומיין על המעניינים. הגרסה ההיסטורית היא post_dataforseo_labs_google_historical_bulk_traffic_live.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת עיון: 0.1356 דולר ארה״ב.
  • מכפיל לקוח לעיון: 1.0. אין להחיל אותו בשנית על סכום לקוח שכבר נקבע.

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

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

      התעלמות ממילות מפתח דומות מאוד
      שדה אופציונלי
      אם הערך הוא true, יוחזרו רק מילות המפתח הליבה וכל מילות המפתח הדומות מאוד יוחרגו;
      ברירת מחדל: false

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

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

      הערה: אם מערך item_types מכיל סוגי פריטים שונים מ-organic, התוצאות ימוינו לפי סוג הפריט הראשון במערך

      ערכים אפשריים:
      ["organic", "paid", "featured_snippet", "local_pack"]
      ברירת מחדל:
      ["organic", "paid"]

    • language_code
      סוג: string | null

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

    • language_name
      סוג: string | null

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

    • location_code
      סוג: integer | null

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

    • location_name
      סוג: string | null

      השם המלא של המיקום
      אם תשתמשו בשדה זה, אין צורך לציין location_code
      אפשר לקבל את רשימת המיקומים הזמינים עם location_name שלהם באמצעות בקשה נפרדת אל
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
      התעלמו משדה זה כדי לקבל תוצאות עבור כל המיקומים הזמינים
      דוגמה:
      United Kingdom

    • tag
      סוג: string | null

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

    • targets
      סוג: array string[]

      דומיינים, תת-דומיינים ודפי אינטרנט של יעד
      שדה חובה
      אפשר לציין דומיינים, תת-דומיינים ודפי אינטרנט בשדה זה;
      יש לציין דומיינים ותת-דומיינים ללא https:// וללא www.;
      יש לציין דפים בכתובת URL מוחלטת, כולל https:// ו-www.;
      אפשר להגדיר עד 1000 דומיינים, תת-דומיינים או דפי אינטרנט

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_DataforseoLabsGoogleBulkTrafficEstimationLiveTaskInfo
        • 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

          מערך תוצאות

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

            מערך של פריטים עם נתוני הערכת תנועה רלוונטיים

            • metrics
              סוג: object | null · Response36Afe1097B20_BulkMetricsBundleInfo

              נתוני תנועה הנוגעים לדומיין שצוין

              • featured_snippet
                סוג: object | null · Response36Afe1097B20_BulkMetricsInfo

                נתוני תנועה מתוצאות הקטע המוביל ב-Google SERP

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

                  ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין

                • etv
                  סוג: number | null

                  נפח תנועה מוערך
                  תנועה אורגנית חודשית מוערכת לדומיין
                  מחושב כמכפלה של ערכי CTR (שיעור הקלקה) ונפח החיפוש של כל מילות המפתח שהדומיין מדורג בהן
                  מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

              • local_pack
                סוג: object | null · Response36Afe1097B20_BulkMetricsInfo

                נתוני תנועה מתוצאות החבילה המקומית ב-SERP

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

                  ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין

                • etv
                  סוג: number | null

                  נפח תנועה מוערך
                  תנועה אורגנית חודשית מוערכת לדומיין
                  מחושב כמכפלה של ערכי CTR (שיעור הקלקה) ונפח החיפוש של כל מילות המפתח שהדומיין מדורג בהן
                  מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

              • organic
                סוג: object | null · Response36Afe1097B20_BulkMetricsInfo

                נתוני תנועה מחיפוש אורגני

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

                  ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין

                • etv
                  סוג: number | null

                  נפח תנועה מוערך
                  תנועה אורגנית חודשית מוערכת לדומיין
                  מחושב כמכפלה של ערכי CTR (שיעור הקלקה) ונפח החיפוש של כל מילות המפתח שהדומיין מדורג בהן
                  מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

              • paid
                סוג: object | null · Response36Afe1097B20_BulkMetricsInfo

                נתוני תנועה מחיפוש בתשלום

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

                  ספירה כוללת של תוצאות SERP אורגניות המכילות את הדומיין

                • etv
                  סוג: number | null

                  נפח תנועה מוערך
                  תנועה אורגנית חודשית מוערכת לדומיין
                  מחושב כמכפלה של ערכי CTR (שיעור הקלקה) ונפח החיפוש של כל מילות המפתח שהדומיין מדורג בהן
                  מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

            • se_type
              סוג: string | null

              סוג מנוע החיפוש

            • target
              סוג: string | null

              דומיין יעד במערך POST

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

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

          • language_code
            סוג: string | null

            קוד שפה במערך POST
            אם אין נתונים, הערך הוא null

          • location_code
            סוג: integer | null

            קוד מיקום במערך POST
            אם אין נתונים, הערך הוא null

          • se_type
            סוג: string | null

            סוג מנוע החיפוש

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

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

        • 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/dataforseo_labs/google/bulk_traffic_estimation/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/bulk_traffic_estimation/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      "dataforseo.com",
      "cnn.com",
      "forbes.com"
    ],
    "location_code": 2840,
    "language_code": "en",
    "item_types": [
      "organic",
      "paid"
    ]
  }
]'
{
  "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": [
        {
          "se_type": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "target": null,
              "metrics": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}
Bulk Traffic Estimation