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

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

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

​

הקהל של Google Trends מאחורי מילת מפתח: פילוח גיל ומגדר על פני אותו חלון שבו משתמש post_dataforseo_keywords_trends_explore_live, עם אותם ארגומנטים של type ותאריך. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. זול כמו אחיו. בשביל איפה ולא מי, השתמשו ב-post_dataforseo_keywords_trends_subregion_interests_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_KeywordsDataDataforseoTrendsDemographyLiveResponseInfo
    • cost
      סוג: number | null פורמט: double

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

                    סוג הרכיב

                  • demography
                    סוג: object | null · Response36Afe1097B20_Demography

                    פילוח דמוגרפי של נתוני פופולריות מילות מפתח עבור כל מונח שצוין
                    כולל נתוני פופולריות של מילות מפתח לפי גיל ומין

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

                      התפלגות פופולריות מילות מפתח לפי גיל

                      • keyword
                        סוג: string | null

                        מילת המפתח הרלוונטית שעבורה מסופקים הנתונים הדמוגרפיים

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

                        מכיל טווח גילאים וערכי פופולריות של מילת המפתח המתאימים

                        • type
                          סוג: string | null

                          סוג הרכיב

                        • value
                          סוג: integer | null

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

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

                      התפלגות פופולריות מילות מפתח לפי מין

                      • keyword
                        סוג: string | null

                        מילת המפתח הרלוונטית שעבורה מסופקים הנתונים הדמוגרפיים

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

                        מכיל טווח גילאים וערכי פופולריות של מילת המפתח המתאימים

                        • type
                          סוג: string | null

                          סוג הרכיב

                        • value
                          סוג: integer | null

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

                  • demography_comparison
                    סוג: object | null · Response36Afe1097B20_DemographyComparisonInfo

                    השוואה של נתונים דמוגרפיים על פופולריות מילות מפתח עבור הפרמטרים שצוינו
                    כולל נתוני פופולריות של מילות מפתח לפי גיל ומין
                    אם ציינתם מילת מפתח אחת, הערך יהיה null

                    • age
                      סוג: object | null

                      סוג הרכיב

                      • propertyName
                        סוג: array (integer | null)[] | null
                    • gender
                      סוג: object | null

                      סוג הרכיב

                      • propertyName
                        סוג: array (integer | 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/demography/live
curl https://openapi.felo.ai/v1/beta/dataforseo/keywords_data/dataforseo_trends/demography/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]",
              "demography": "[Max Depth Exceeded]",
              "demography_comparison": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Setting Live ‘DataForSEO Trends Demography’ Tasks