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

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

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 Subregion Interests’ בזמן אמת

​

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

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת עיון: 0.0024 דולר ארה״ב.
  • מכפיל לקוח לעיון: 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
      הימנעו מסימנים ותווים מיוחדים (למשל תווי UTF ואימוג'ים);
      אם תציינו תווים שאינם לטיניים, תקבלו נתונים עבור המדינות שבהן הם משמשים

      מידע נוסף על הכללים והמגבלות של השדות 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_KeywordsDataDataforseoTrendsSubregionInterestsLiveResponseInfo
    • cost
      סוג: number | null פורמט: double

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

      • סוג: object | null · Response36Afe1097B20_KeywordsDataDataforseoTrendsSubregionInterestsLiveTaskInfo
        • 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_DataforseoTrendsSubregionInterestsElementItem
                • סוג: object · Response36Afe1097B20_DataforseoTrendsSubregionInterestsElementItem
                  • type
                    מזהה מבחין
                    סוג: string | null

                    סוג הרכיב

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

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

                    • keyword
                      סוג: string | null

                      מילת מפתח רלוונטית
                      הנתונים הכלולים ברכיב values מבוססים על מילת מפתח זו

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

                      מכיל נתונים על פופולריות יחסית של מילות מפתח לפי מדינה או אזור

                      • geo_id
                        סוג: string | null

                        מזהה מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_id שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        US-NY

                      • geo_name
                        סוג: string | null

                        שם מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_name שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        Andorra

                      • value
                        סוג: integer | null

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

                  • interests_comparison
                    סוג: object | null · Response36Afe1097B20_InterestsComparison

                    השוואה של נתונים על פופולריות מילות מפתח תת-אזורית עבור הפרמטרים שצוינו
                    אם ציינתם מילת מפתח אחת, הערך יהיה null

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

                      שיעורי פופולריות של מילות מפתח בכל המיקומים
                      הערכים במערך זה מייצגים אחוזים ביחס לערך המרבי בכל המיקומים

                      • geo_id
                        סוג: string | null

                        מזהה מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_id שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        US-NY

                      • geo_name
                        סוג: string | null

                        שם מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_name שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        Andorra

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

                        מכיל נתונים על פופולריות יחסית של מילות מפתח לפי מדינה או אזור

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

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

                      • geo_id
                        סוג: string | null

                        מזהה מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_id שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        US-NY

                      • geo_name
                        סוג: string | null

                        שם מיקום
                        אפשר להשתמש בשדה הזה כדי להתאים תוצאות שהתקבלו לפרמטרי המיקום שצוינו בבקשה
                        ראו את הרשימה המלאה של המיקומים הזמינים עם geo_name שלהם כאן או באמצעות בקשה נפרדת אל https://api.dataforseo.com/v3/keywords_data/dataforseo_trends/locations
                        דוגמה:
                        Andorra

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

                        מכיל נתונים על פופולריות יחסית של מילות מפתח לפי מדינה או אזור

                  • 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/subregion_interests/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/subregion_interests/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "rugby",
      "cricket"
    ],
    "date_from": "2023-01-01",
    "date_to": "2024-01-01",
    "type": "web",
    "location_name": "United States"
  }
]'

{
  "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]",
              "interests": "[Max Depth Exceeded]",
              "interests_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Setting Live ‘DataForSEO Trends Subregion Interests’ Tasks