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

הצעות למילות מפתח

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

DataForSEO

​

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

DataForSEO פעולות

הצעות למילות מפתח

​

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

מראה תמחור

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

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

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

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

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

      מערך פרמטרים לסינון תוצאות
      שדה אופציונלי
      אפשר להוסיף כמה מסננים בבת אחת (עד 8 מסננים)
      יש להגדיר אופרטור לוגי and או or בין התנאים
      האופרטורים הנתמכים:
      regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
      אפשר להשתמש באופרטור % עם like ו-not_like, וכן ilike ו-not_ilike, כדי להתאים כל מחרוזת של אפס תווים או יותר
      דוגמה:
      ["keyword_info.search_volume",">",0]
      [["keyword_info.search_volume","in",[0,1000]],
      "and",
      ["keyword_info.competition_level","=","LOW"]]      [["keyword_info.search_volume",">",100],
      "and",
      [["keyword_info.cpc","<",0.5],
      "or",
      ["keyword_info.high_top_of_page_bid","<=",0.5]]]
      למידע נוסף על מסננים ראו Dataforseo Labs - Filters או מדריך מרכז העזרה

      אובייקט ריק
    • ignore_synonyms
      סוג: boolean | null

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

    • include_clickstream_data
      סוג: boolean | null

      כלילה או החרגה של נתונים ממדדים מבוססי Clickstream בתגובה
      שדה אופציונלי
      אם הפרמטר מוגדר ל-true, תקבלו את השדות clickstream_keyword_info, keyword_info_normalized_with_clickstream ו-keyword_info_normalized_with_bing בתגובה
      ברירת מחדל: false
      כשהפרמטר מופעל, תחויבו במחיר כפול עבור הבקשה

      מידע נוסף על אופן חישוב המדדים מבוססי Clickstream מופיע במאמר במרכז העזרה

    • include_seed_keyword
      סוג: boolean | null

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

    • include_serp_info
      סוג: boolean | null

      כלילת נתונים מ-SERP עבור כל מילת מפתח
      שדה אופציונלי
      אם הערך הוא true, נחזיר מערך serp_info המכיל נתוני SERP (מספר תוצאות חיפוש, כתובת URL רלוונטית ותכונות SERP) עבור כל מילת מפתח בתגובה
      ברירת מחדל: false

    • keyword
      סוג: string

      keyword
      שדה חובה
      קידוד UTF-8
      מילות המפתח יומרו לאותיות קטנות;

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

    • language_code
      סוג: string | null

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

    • language_name
      סוג: string | null

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

    • limit
      סוג: integer | null

      המספר המרבי של מילות מפתח מוחזרות
      שדה אופציונלי
      ברירת מחדל: 100
      הערך המרבי: 1000

    • 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

    • offset
      סוג: integer | null

      היסט במערך התוצאות של מילות המפתח המוחזרות
      שדה אופציונלי
      ערך ברירת מחדל: 0
      אם תציינו את הערך 10, עשר מילות המפתח הראשונות במערך התוצאות יושמטו והנתונים יסופקו עבור מילות המפתח העוקבות
      הערה: אנו ממליצים להשתמש בפרמטר הזה רק כשמאחזרים עד 10,000 תוצאות
      לאחזור יותר מ-10,000 תוצאות, השתמשו ב-offset_token במקום.

    • offset_token
      סוג: string | null

      טוקן היסט לבקשות המשך
      שדה אופציונלי
      מסופק בשדה הזהה בתגובה לכל בקשה;
      השתמשו בפרמטר הזה כדי להימנע מפסקי זמן כשמנסים לקבל יותר מ-10,000 תוצאות בבקשה אחת;
      אם תציינו את ערך offset_token הייחודי ממערך התגובה, תקבלו את התוצאות הבאות של המשימה הראשונית;
      ערכי offset_token ייחודיים לכל משימת המשך
      הערה: אם מצוין offset_token בבקשה, כל שאר הפרמטרים למעט limit לא יילקחו בחשבון בעת עיבוד המשימה.
      מידע נוסף על הפרמטר הזה במרכז העזרה שלנו

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

      כללי מיון תוצאות
      שדה אופציונלי
      אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
      סוגי מיון אפשריים:
      asc - התוצאות ימוינו בסדר עולה
      desc - התוצאות ימוינו בסדר יורד
      הפסיק משמש כמפריד
      דוגמה:
      ["keyword_info.competition,desc"]
      כלל ברירת מחדל:
      ["keyword_info.search_volume,desc"]
      שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
      יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
      דוגמה:
      ["keyword_info.search_volume,desc","keyword_info.cpc,desc"]

    • tag
      סוג: string | null

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

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

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

            • avg_backlinks_info
              סוג: object | null · Response36Afe1097B20_AvgBacklinksInfo

              נתוני קישורים נכנסים עבור מילת המפתח שהוחזרה
              אובייקט זה מספק את המספר הממוצע של קישורים נכנסים, עמודים מפנים ודומיינים, וכן את ערכי הדירוג הממוצעים בקרב 10 עמודי האינטרנט המובילים שמדורגים אורגנית עבור מילת המפתח

              • backlinks
                סוג: number | null

                מספר קישורים נכנסים ממוצע

              • dofollow
                סוג: number | null

                מספר ממוצע של קישורי dofollow

              • last_updated_time
                סוג: string | null

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

              • main_domain_rank
                סוג: number | null

                דירוג דומיין ראשי ממוצע
                מידע נוסף על המדד ונוסחת החישוב שלו במאמר הזה במרכז העזרה

              • rank
                סוג: number | null

                דירוג ממוצע
                מידע נוסף על המדד ונוסחת החישוב שלו במאמר מרכז העזרה הזה

              • referring_domains
                סוג: number | null

                מספר ממוצע של דומיינים מפנים

              • referring_main_domains
                סוג: number | null

                מספר ממוצע של דומיינים ראשיים מפנים

              • referring_pages
                סוג: number | null

                מספר ממוצע של דפים מפנים

              • se_type
                סוג: string | null

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

            • clickstream_keyword_info
              סוג: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              נתוני זרימת קליקים עבור מילת המפתח שהוחזרה
              כדי לאחזר תוצאות עבור שדה זה, יש להגדיר את הפרמטר include_clickstream_data ל-true

              • age_distribution
                סוג: object | null

                התפלגות מדדים מבוססי Clickstream לפי גיל
                מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

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

                  Signed 64-bit integers (long type).

              • gender_distribution
                סוג: object | null

                התפלגות מדדים מוערכים מבוססי Clickstream לפי מגדר
                מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

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

                  Signed 64-bit integers (long type).

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

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

                שיעור נפח חיפוש חודשי ממוצע
                מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com

            • keyword
              סוג: string | null

              רעיון מילת המפתח שהוחזר

            • keyword_info
              סוג: object | null · Response36Afe1097B20_KeywordInfo

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

              • categories
                סוג: array integer[] | null

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

              • competition
                סוג: number | null

                תחרות
                מייצג את הכמות היחסית של תחרות הקשורה למילת המפתח הנתונה. הערך מבוסס על נתוני Google Ads ויכול לנוע בין 0 ל-1 (כולל)

              • competition_level
                סוג: string | null

                רמת תחרות
                מייצג את הרמה היחסית של תחרות הקשורה למילת המפתח הנתונה ב-SERP ממומן בלבד;
                ערכים אפשריים: LOW, MEDIUM, HIGH
                אם רמת התחרות אינה ידועה, הערך הוא null;
                מידע נוסף על המדד במאמר מרכז העזרה הזה

              • cpc
                סוג: number | null

                עלות לקליקה
                מייצג את העלות הממוצעת לקליקה (בדולר ארה״ב) ששולמה היסטורית עבור מילת המפתח

              • high_top_of_page_bid
                סוג: number | null

                ההצעה המקסימלית להצגת המודעה בראש העמוד הראשון
                מציין ערך הגדול מכ-80% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
                הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST

              • last_updated_time
                סוג: string | null

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

              • low_top_of_page_bid
                סוג: number | null

                ההצעה המינימלית להצגת המודעה בראש העמוד הראשון
                מציין ערך הגדול מכ-20% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
                הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • se_type
                סוג: string | null

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

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

                שיעור נפח חיפוש חודשי ממוצע
                מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com

              • search_volume_trend
                סוג: object | null · Response36Afe1097B20_SearchVolumeTrend

                שינויים במגמת נפח החיפוש
                מייצג את השינוי בנפח החיפוש באחוזים לעומת התקופה הקודמת

                • monthly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת החודש הקודם

                • quarterly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת הרבעון הקודם

                • yearly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת השנה הקודמת

            • keyword_info_normalized_with_bing
              סוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              מכיל נפח חיפוש של מילת מפתח מנורמל לנפח החיפוש ב-Bing

              • is_normalized
                סוג: boolean | null

                מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • search_volume
                סוג: integer | null

                שיעור נפח החיפוש הנוכחי של מילת מפתח

            • keyword_info_normalized_with_clickstream
              סוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

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

              • is_normalized
                סוג: boolean | null

                מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • search_volume
                סוג: integer | null

                שיעור נפח החיפוש הנוכחי של מילת מפתח

            • keyword_properties
              סוג: object | null · Response36Afe1097B20_KeywordProperties

              מידע נוסף על מילת המפתח

              • core_keyword
                סוג: string | null

                מילת המפתח הראשית בקבוצה
                מכיל את מילת המפתח הראשית בקבוצה שנקבעת על ידי אלגוריתם אשכול המילים הנרדפות
                אם הערך הוא null, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword

              • detected_language
                סוג: string | null

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

              • is_another_language
                סוג: boolean | null

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

              • keyword_difficulty
                סוג: integer | null

                רמת הקושי לדירוג בעשרת התוצאות האורגניות הראשונות עבור מילת מפתח
                מציין את הסיכוי להיכנס לעשרת התוצאות האורגניות הראשונות עבור מילת מפתח בסולם לוגריתמי מ-0 עד 100;
                מחושב על ידי ניתוח, בין היתר, של פרופילי קישורים של 10 העמודים הראשונים ב-SERP;
                מידע נוסף על המדד במדריך מרכז העזרה הזה

              • se_type
                סוג: string | null

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

              • synonym_clustering_algorithm
                סוג: string | null

                האלגוריתם ששימש לזיהוי מילים נרדפות
                ערכים אפשריים:
                keyword_metrics - מציין את האלגוריתם המבוסס על פרמטרי keyword_info
                text_processing - מציין את האלגוריתם המבוסס על טקסט
                אם הערך הוא null, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword

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

                מספר המילים במילת המפתח
                מציין מכמה מילים מורכבת מילת המפתח

            • language_code
              סוג: string | null

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

            • location_code
              סוג: integer | null

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

            • se_type
              סוג: string | null

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

            • search_intent_info
              סוג: object | null · Response36Afe1097B20_SearchIntentInfo

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

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

                כוונות חיפוש משלימות
                ערכים אפשריים: informational, navigational, commercial, transactional

              • last_updated_time
                סוג: string | null

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

              • main_intent
                סוג: string | null

                כוונת החיפוש הראשית
                ערכים אפשריים: informational, navigational, commercial, transactional

              • se_type
                סוג: string | null

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

            • serp_info
              סוג: object | null · Response36Afe1097B20_SerpInfo

              נתוני SERP
              הערך יהיה null אם לא הגדרתם את השדה include_serp_info ל-true במערך POST או אם אין נתוני SERP עבור מילת מפתח זו במסד הנתונים שלנו

              • check_url
                סוג: string | null

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

              • last_updated_time
                סוג: string | null

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

              • previous_updated_time
                סוג: string | null

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

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

                מספר תוצאות החיפוש עבור מילת המפתח שהוחזרה

              • se_type
                סוג: string | null

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

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

                סוגי תוצאות החיפוש ב-SERP
                מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP
                סוגי פריטים אפשריים:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                הערה שהתוצאות בפועל יוחזרו רק עבור רכיבי organic, paid, featured_snippet ו-local_pack

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

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

          • language_code
            סוג: string | null

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

          • location_code
            סוג: integer | null

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

          • offset
            סוג: integer | null

            ערך ההיסט הנוכחי

          • offset_token
            סוג: string | null

            טוקן היסט לבקשות עוקבות
            אפשר להשתמש במחרוזת שמסופקת בשדה הזה כדי לקבל את התוצאות העוקבות של המשימה הראשונית;
            הערה: ערכי offset_token ייחודיים לכל משימה עוקבת

          • se_type
            סוג: string | null

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

          • seed_keyword
            סוג: string | null

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

          • seed_keyword_data
            סוג: object | null · Response36Afe1097B20_KeywordDataInfo

            נתוני מילת מפתח עבור מילת המפתח הראשונית
            השדות באובייקט זה זהים לאלה של מערך items

            • avg_backlinks_info
              סוג: object | null · Response36Afe1097B20_AvgBacklinksInfo

              נתוני קישורים נכנסים עבור מילת המפתח שהוחזרה
              אובייקט זה מספק את המספר הממוצע של קישורים נכנסים, עמודים מפנים ודומיינים, וכן את ערכי הדירוג הממוצעים בקרב 10 עמודי האינטרנט המובילים שמדורגים אורגנית עבור מילת המפתח

              • backlinks
                סוג: number | null

                מספר קישורים נכנסים ממוצע

              • dofollow
                סוג: number | null

                מספר ממוצע של קישורי dofollow

              • last_updated_time
                סוג: string | null

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

              • main_domain_rank
                סוג: number | null

                דירוג דומיין ראשי ממוצע
                מידע נוסף על המדד ונוסחת החישוב שלו במאמר הזה במרכז העזרה

              • rank
                סוג: number | null

                דירוג ממוצע
                מידע נוסף על המדד ונוסחת החישוב שלו במאמר מרכז העזרה הזה

              • referring_domains
                סוג: number | null

                מספר ממוצע של דומיינים מפנים

              • referring_main_domains
                סוג: number | null

                מספר ממוצע של דומיינים ראשיים מפנים

              • referring_pages
                סוג: number | null

                מספר ממוצע של דפים מפנים

              • se_type
                סוג: string | null

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

            • clickstream_keyword_info
              סוג: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

              נתוני זרימת קליקים עבור מילת המפתח שהוחזרה
              כדי לאחזר תוצאות עבור שדה זה, יש להגדיר את הפרמטר include_clickstream_data ל-true

              • age_distribution
                סוג: object | null

                התפלגות מדדים מבוססי Clickstream לפי גיל
                מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

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

                  Signed 64-bit integers (long type).

              • gender_distribution
                סוג: object | null

                התפלגות מדדים מוערכים מבוססי Clickstream לפי מגדר
                מידע נוסף על אופן חישוב המדד זמין במאמר מרכז העזרה הזה

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

                  Signed 64-bit integers (long type).

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

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

                שיעור נפח חיפוש חודשי ממוצע
                מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com

            • keyword
              סוג: string | null

              רעיון מילת המפתח שהוחזר

            • keyword_info
              סוג: object | null · Response36Afe1097B20_KeywordInfo

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

              • categories
                סוג: array integer[] | null

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

              • competition
                סוג: number | null

                תחרות
                מייצג את הכמות היחסית של תחרות הקשורה למילת המפתח הנתונה. הערך מבוסס על נתוני Google Ads ויכול לנוע בין 0 ל-1 (כולל)

              • competition_level
                סוג: string | null

                רמת תחרות
                מייצג את הרמה היחסית של תחרות הקשורה למילת המפתח הנתונה ב-SERP ממומן בלבד;
                ערכים אפשריים: LOW, MEDIUM, HIGH
                אם רמת התחרות אינה ידועה, הערך הוא null;
                מידע נוסף על המדד במאמר מרכז העזרה הזה

              • cpc
                סוג: number | null

                עלות לקליקה
                מייצג את העלות הממוצעת לקליקה (בדולר ארה״ב) ששולמה היסטורית עבור מילת המפתח

              • high_top_of_page_bid
                סוג: number | null

                ההצעה המקסימלית להצגת המודעה בראש העמוד הראשון
                מציין ערך הגדול מכ-80% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
                הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST

              • last_updated_time
                סוג: string | null

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

              • low_top_of_page_bid
                סוג: number | null

                ההצעה המינימלית להצגת המודעה בראש העמוד הראשון
                מציין ערך הגדול מכ-20% מההצעות הנמוכות ביותר שבהן הוצגו מודעות (בהתבסס על סטטיסטיקות Google Ads למפרסמים)
                הערך עשוי להשתנות בהתאם למיקום שצוין בבקשת POST

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • se_type
                סוג: string | null

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

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

                שיעור נפח חיפוש חודשי ממוצע
                מייצג את המספר (המשוער) של חיפושים ברעיון מילת המפתח הנתון ב-google.com

              • search_volume_trend
                סוג: object | null · Response36Afe1097B20_SearchVolumeTrend

                שינויים במגמת נפח החיפוש
                מייצג את השינוי בנפח החיפוש באחוזים לעומת התקופה הקודמת

                • monthly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת החודש הקודם

                • quarterly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת הרבעון הקודם

                • yearly
                  סוג: integer | null

                  שינוי בנפח החיפוש באחוזים לעומת השנה הקודמת

            • keyword_info_normalized_with_bing
              סוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

              מכיל נפח חיפוש של מילת מפתח מנורמל לנפח החיפוש ב-Bing

              • is_normalized
                סוג: boolean | null

                מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • search_volume
                סוג: integer | null

                שיעור נפח החיפוש הנוכחי של מילת מפתח

            • keyword_info_normalized_with_clickstream
              סוג: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

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

              • is_normalized
                סוג: boolean | null

                מידע מילת המפתח מנורמל אם הערך true, הערכים מנורמלים עם נתוני Bing

              • last_updated_time
                סוג: string | null

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

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

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

                • month
                  סוג: integer | null

                  חודש

                • search_volume
                  סוג: integer | null

                  שיעור נפח חיפוש חודשי ממוצע

                • year
                  סוג: integer | null

                  שנה

              • search_volume
                סוג: integer | null

                שיעור נפח החיפוש הנוכחי של מילת מפתח

            • keyword_properties
              סוג: object | null · Response36Afe1097B20_KeywordProperties

              מידע נוסף על מילת המפתח

              • core_keyword
                סוג: string | null

                מילת המפתח הראשית בקבוצה
                מכיל את מילת המפתח הראשית בקבוצה שנקבעת על ידי אלגוריתם אשכול המילים הנרדפות
                אם הערך הוא null, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword

              • detected_language
                סוג: string | null

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

              • is_another_language
                סוג: boolean | null

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

              • keyword_difficulty
                סוג: integer | null

                רמת הקושי לדירוג בעשרת התוצאות האורגניות הראשונות עבור מילת מפתח
                מציין את הסיכוי להיכנס לעשרת התוצאות האורגניות הראשונות עבור מילת מפתח בסולם לוגריתמי מ-0 עד 100;
                מחושב על ידי ניתוח, בין היתר, של פרופילי קישורים של 10 העמודים הראשונים ב-SERP;
                מידע נוסף על המדד במדריך מרכז העזרה הזה

              • se_type
                סוג: string | null

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

              • synonym_clustering_algorithm
                סוג: string | null

                האלגוריתם ששימש לזיהוי מילים נרדפות
                ערכים אפשריים:
                keyword_metrics - מציין את האלגוריתם המבוסס על פרמטרי keyword_info
                text_processing - מציין את האלגוריתם המבוסס על טקסט
                אם הערך הוא null, מסד הנתונים שלנו אינו מכיל מילות מפתח שהאלגוריתם המתאים יכול היה לזהות כנרדפות ל-keyword

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

                מספר המילים במילת המפתח
                מציין מכמה מילים מורכבת מילת המפתח

            • language_code
              סוג: string | null

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

            • location_code
              סוג: integer | null

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

            • se_type
              סוג: string | null

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

            • search_intent_info
              סוג: object | null · Response36Afe1097B20_SearchIntentInfo

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

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

                כוונות חיפוש משלימות
                ערכים אפשריים: informational, navigational, commercial, transactional

              • last_updated_time
                סוג: string | null

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

              • main_intent
                סוג: string | null

                כוונת החיפוש הראשית
                ערכים אפשריים: informational, navigational, commercial, transactional

              • se_type
                סוג: string | null

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

            • serp_info
              סוג: object | null · Response36Afe1097B20_SerpInfo

              נתוני SERP
              הערך יהיה null אם לא הגדרתם את השדה include_serp_info ל-true במערך POST או אם אין נתוני SERP עבור מילת מפתח זו במסד הנתונים שלנו

              • check_url
                סוג: string | null

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

              • last_updated_time
                סוג: string | null

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

              • previous_updated_time
                סוג: string | null

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

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

                מספר תוצאות החיפוש עבור מילת המפתח שהוחזרה

              • se_type
                סוג: string | null

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

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

                סוגי תוצאות החיפוש ב-SERP
                מכיל את סוגי תוצאות החיפוש (items) שנמצאו ב-SERP
                סוגי פריטים אפשריים:
                answer_box, app, carousel, multi_carousel, featured_snippet, google_flights, google_reviews, third_party_reviews, google_posts, images, jobs, knowledge_graph, local_pack, hotels_pack, map, organic, paid, people_also_ask, related_searches, people_also_search, shopping, top_stories, twitter, video, events, mention_carousel, recipes, top_sights, scholarly_articles, popular_products, podcasts, questions_and_answers, find_results_on, stocks_box, visual_stories, commercial_units, local_services, google_hotels, math_solver, currency_box, product_considerations, found_on_web, short_videos, refine_products, explore_brands, perspectives, discussions_and_forums, compare_sites, courses, ai_overview;
                הערה שהתוצאות בפועל יוחזרו רק עבור רכיבי organic, paid, featured_snippet ו-local_pack

          • 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/keyword_suggestions/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keyword_suggestions/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "phone",
    "location_code": 2840,
    "language_code": "en",
    "include_serp_info": true,
    "include_seed_keyword": true,
    "limit": 1
  }
]'

{
  "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,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
            "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
            "clickstream_keyword_info": "[Max Depth Exceeded]",
            "keyword_properties": "[Max Depth Exceeded]",
            "serp_info": "[Max Depth Exceeded]",
            "avg_backlinks_info": "[Max Depth Exceeded]",
            "search_intent_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "offset": null,
          "offset_token": null,
          "items": [
            {
              "se_type": null,
              "keyword": null,
              "location_code": null,
              "language_code": null,
              "keyword_info": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_bing": "[Max Depth Exceeded]",
              "keyword_info_normalized_with_clickstream": "[Max Depth Exceeded]",
              "clickstream_keyword_info": "[Max Depth Exceeded]",
              "keyword_properties": "[Max Depth Exceeded]",
              "serp_info": "[Max Depth Exceeded]",
              "avg_backlinks_info": "[Max Depth Exceeded]",
              "search_intent_info": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Keyword Suggestions