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 פעולות

מילות מפתח לאתר

​

מילות המפתח שדומיין target מדורג עבורן. מחזיר se_type, target, 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)[]
    • 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, כדי להתאים כל מחרוזת של אפס תווים או יותר
      שימו לב שאי אפשר לסנן את התוצאות לפי relevance
      דוגמה:
      ["keyword_info.search_volume",">",0]
      למידע נוסף על מסננים ראו Dataforseo Labs - Filters או מדריך מרכז העזרה

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

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

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

    • include_serp_info
      סוג: boolean | null

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

    • include_subdomains
      סוג: boolean | null

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

    • 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

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

    • location_name
      סוג: string

      השם המלא של המיקום
      שדה חובה אם לא מציינים location_code
      הערה: יש לציין location_name או 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 - התוצאות ימוינו בסדר יורד
      יש להשתמש בפסיק כדי להגדיר פרמטר מיון

      כלל ברירת מחדל:
      ["relevance,desc"]
      הערך relevance משמש ככלל המיון המוגדר כברירת מחדל כדי לספק את רעיונות מילות המפתח הקרובים ביותר. אנו ממליצים להשתמש בכלל המיון הזה כדי לקבל מונחי חיפוש רלוונטיים במיוחד. שימו לב ש-relevance הוא רק מזהה מערכת פנימי שלנו, ולכן אי אפשר להשתמש בו כמסנן, ולא תמצאו את השדה הזה במערך result. ציון הרלוונטיות מבוסס על עיקרון דומה לזה שבנקודת הקצה the Keywords For Keywords.שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
      יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
      דוגמה:
      ["relevance,desc","keyword_info.search_volume,desc"]

    • tag
      סוג: string | null

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

    • target
      סוג: string

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

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

          • location_code
            סוג: integer | null

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

          • offset
            סוג: integer | null

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

          • offset_token
            סוג: string | null

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

          • se_type
            סוג: string | null

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

          • target
            סוג: string | null

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

          • 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/keywords_for_site/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/keywords_for_site/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "apple.com",
    "language_code": "en",
    "location_code": 2840,
    "include_serp_info": true,
    "include_subdomains": true,
    "filters": [
      "serp_info.se_results_count",
      ">",
      0
    ],
    "limit": 3
  }
]'

{
  "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,
          "target": null,
          "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]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

Keywords For Site