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

הגדרת משימות ‘DataForSEO Trends Explore’ בזמן אמת

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

DataForSEO

​

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

DataForSEO פעולות

הגדרת משימות ‘DataForSEO Trends Explore’ בזמן אמת

​

התעניינות לאורך זמן בעבור עד חמישה keywords, עקומת Google Trends. מחזיר keywords, type, location_code, language_code, datetime, items_count ו-items. type בוחר web, news, images, youtube או shopping, ו-date_from/date_to קובעים את החלון. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. Trends נותן התעניינות יחסית, לא נפח מוחלט; לספירות השתמשו ב-post_dataforseo_keywords_gads_search_volume_live.

מראה תמחור

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

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

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

      תאריך התחלה של טווח הזמן
      שדה אופציונלי
      אם לא מציינים את השדה הזה, ייעשה שימוש ביום ובחודש הנוכחיים של השנה הקודמת כברירת מחדל
      הערך המזערי לסוג web: 2004-01-01
      הערך המזערי לסוגים אחרים: 2008-01-01
      פורמט תאריך: "yyyy-mm-dd"
      דוגמה:
      "2019-01-15"

    • date_to
      סוג: string | null

      תאריך סיום של טווח הזמן
      שדה אופציונלי
      אם לא מציינים את השדה הזה, ייעשה שימוש בתאריך של היום כברירת מחדל
      פורמט תאריך: "yyyy-mm-dd"
      דוגמה:
      "2019-01-15"

    • keywords
      סוג: array string[]

      מילות מפתח
      שדה חובה
      המספר המרבי של מילות מפתח שאפשר לציין: 5

      מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO API מופיע במאמר במרכז העזרה

    • location_code
      סוג: integer | null

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

    • location_name
      סוג: string | null

      השם המלא של מיקום מנוע החיפוש
      שדה אופציונלי
      אם לא תשתמשו בשדה הזה, תקבלו תוצאות גלובליות
      אם תשתמשו בשדה הזה, אין צורך לציין location_code
      אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
      שימו לב שהנתונים יסופקו עבור המדינה שאליה שייך ה-location_name שצוין;
      דוגמה:
      United Kingdom

    • tag
      סוג: string | null

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

    • time_range
      סוג: string | null

      טווחי זמן מוגדרים מראש
      שדה אופציונלי
      אם תציינו את הפרמטרים date_from או date_to, השדה הזה ייתעלם בעת הגדרת משימה
      ערכים אפשריים לכל פרמטרי type:
      past_4_hours, past_day, past_7_days, past_30_days, past_90_days, past_12_months, past_5_years

    • type
      סוג: string | null

      סוג הרכיב

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

          מערך תוצאות

          • datetime
            סוג: string | null

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

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

            מכיל את הפופולריות של מילת המפתח ונתונים קשורים

            • סוג: object | null · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                • סוג: object · Response36Afe1097B20_DataforseoTrendsDataforseoTrendsGraphElementItem
                  • type
                    מזהה מבחין
                    סוג: string | null

                    סוג הרכיב

                  • averages
                    סוג: array (integer | null)[] | null
                  • data
                    סוג: array (object | null)[] | null

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

                    • date_from
                      סוג: string | null

                      תאריך ההתחלה של טווח הזמן המתאים
                      בפורמט UTC: "yyyy-mm-dd"

                    • date_to
                      סוג: string | null

                      תאריך הסיום של טווח הזמן המתאים
                      בפורמט UTC: "yyyy-mm-dd"

                    • timestamp
                      סוג: integer | null

                      נקודת זמן בפורמט זמן Unix

                    • values
                      סוג: array (integer | null)[] | null

                      שיעור פופולריות יחסי של מילת המפתח בחותם זמן מסוים
                      מייצג את שיעור הפופולריות של מילת המפתח בטווח הזמן הנתון
                      אם ציינתם יותר ממילת מפתח אחת, הערכים ימוצעו לערך הגבוה ביותר מבין כל מילות המפתח שצוינו
                      ערך 100 הוא שיא הפופולריות של המונח. ערך 50 פירושו שהמונח פופולרי בחצי. ציון 0 פירושו שלא היו מספיק נתונים עבור מונח זה

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

                    מילות מפתח במערך POST

                  • position
                    סוג: integer | null

                    היישור של הרכיב
                    יכול לקבל את הערכים הבאים: 1, 2, 3, 4, וכו'.

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

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

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

            מילות מפתח במערך POST

          • language_code
            סוג: string | null

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

          • location_code
            סוג: integer | null

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

          • type
            סוג: string | null

            סוג הרכיב

        • 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/keywords_data/dataforseo_trends/explore/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/explore/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "iphone 14",
      "samsung s23"
    ],
    "location_code": 2840
  }
]'

{
  "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": [
        {
          "keywords": [
            null
          ],
          "type": null,
          "location_code": null,
          "language_code": null,
          "datetime": null,
          "items_count": null,
          "items": [
            {
              "type": "[Max Depth Exceeded]",
              "position": "[Max Depth Exceeded]",
              "keywords": "[Max Depth Exceeded]",
              "data": "[Max Depth Exceeded]",
              "averages": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Setting Live ‘DataForSEO Trends Explore’ Tasks