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 אחד, שורה לכל קישור. מחזיר total_count, items_count, items ו-search_after_token לדפדוף — השתמשו בו ולא ב-offset אחרי העמודים הראשונים. mode ו-custom_mode שולטים בקיבוץ, backlinks_status_type בוחר חי, אבוד או הכול. לספירות ולא לשורות השתמשו ב-post_dataforseo_backlinks_summary_live; לדומיינים המקשרים מקובצים, post_dataforseo_backlinks_referring_domains_live.

מראה תמחור

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

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

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

      קביעת הקישורים הנכנסים שיוחזרו וייספרו
      שדה אופציונלי
      אפשר להשתמש בשדה זה כדי לבחור אילו קישורים נכנסים יוחזרו וישמשו למדדים מצטברים של target;
      ערכים אפשריים:
      all — כל הקישורים הנכנסים יוחזרו וייספרו;
      live — קישורים נכנסים שנמצאו בבדיקה האחרונה יוחזרו וייספרו;
      lost — קישורים נכנסים שאבדו יוחזרו וייספרו;

      ערך ברירת מחדל: live

    • custom_mode
      סוג: object | null

      סוג קיבוץ התוצאות המפורטות
      שדה אופציונלי
      אפשר להשתמש באובייקט הזה כדי לקבל מספר מסוים של קישורים נכנסים לכל field
      אם משתמשים ב-custom_mode, המערכת תתעלם מ-mode
      דוגמה:
      "custom_mode": {"field": "domain", "value": 100}

      • propertyName
        סוג: object | null
    • exclude_internal_backlinks
      סוג: boolean | null

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

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

      מערך פרמטרים לסינון תוצאות
      שדה אופציונלי
      אפשר להוסיף כמה מסננים בבת אחת (עד 8)
      יש להגדיר אופרטור לוגי and או or בין התנאים
      האופרטורים הנתמכים:
      =, <>, in, not_in, like, not_like, ilike, not_ilike, regex, not_regex, match, not_match
      אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
      דוגמה:
      ["rank",">","80"]

      [["page_from_rank",">","55"],
      "and",
      ["dofollow","=",true]]

      [["first_seen",">","2017-10-23 11:31:45 +00:00"],
      "and",
      [["anchor","like","%seo%"],"or",["text_pre","like","%seo%"]]]

      הרשימה המלאה של המסננים האפשריים זמינה כאן.

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

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

    • limit
      סוג: integer | null

      המספר המרבי של קישורים נכנסים מוחזרים
      שדה אופציונלי

      ערך ברירת מחדל: 100
      הערך המרבי: 1000

    • mode
      סוג: string | null

      סוג קיבוץ התוצאות
      שדה אופציונלי
      סוגי קיבוץ אפשריים:
      as_is — מחזיר את כל הקישורים הנכנסים
      one_per_domain — מחזיר קישור נכנס אחד לכל דומיין
      one_per_anchor — מחזיר קישור נכנס אחד לכל עוגן

      ערך ברירת מחדל: as_is

    • offset
      סוג: integer | null

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

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

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

      כללי מיון תוצאות
      שדה אופציונלי
      אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
      סוגי מיון אפשריים:
      asc — התוצאות ימוינו בסדר עולה
      desc — התוצאות ימוינו בסדר יורד
      יש להשתמש בפסיק כדי להגדיר סוג מיון
      דוגמה:
      ["rank,desc"]
      שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
      יש להפריד בין כמה כללי מיון בפסיק
      דוגמה:
      ["domain_from_rank,desc","page_from_rank,asc"]

    • rank_scale
      סוג: string | null

      מגדיר את הסקאלה שבה מחושבים ומוצגים הערכים rank, domain_from_rank ו-page_from_rank
      שדה אופציונלי

      אפשר להשתמש בפרמטר הזה כדי לבחור אם ערכי הדירוג מוצגים בסקאלה של 0–100 או 0–1000

      ערכים אפשריים:
      one_hundred — ערכי הדירוג מוצגים בסקאלה של 0–100
      one_thousand — ערכי הדירוג מוצגים בסקאלה של 0–1000

      ערך ברירת מחדל: one_thousand

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

    • search_after_token
      סוג: string | null

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

    • tag
      סוג: string | null

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

    • target
      סוג: string

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

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

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

    • status_code
      סוג: integer | null

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

    • status_message
      סוג: string | null

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

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

      מערך משימות

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

          מערך תוצאות

          • custom_mode
            סוג: object | null

            מצב מותאם אישית שצוין במערך POST

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

            מכיל נתוני קישורים נכנסים ודומיינים מפנים רלוונטיים

            • alt
              סוג: string | null

              הטקסט החלופי של התמונה
              השדה הזה יהיה null אם ה-type של הקישור הנכנס אינו image

            • anchor
              סוג: string | null

              טקסט העוגן של הקישור הנכנס

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

              מאפייני הקישור של הקישורים המפנים
              דוגמה:
              nofollow

            • backlink_spam_score
              סוג: integer | null

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

            • dofollow
              סוג: boolean | null

              מציין אם הקישור הנכנס הוא dofollow
              אם false, הקישור הנכנס הוא nofollow

            • domain_from
              סוג: string | null

              הדומיין שמפנה לדומיין היעד או לדף האינטרנט

            • domain_from_country
              סוג: string | null

              קוד מדינה ISO של הדומיין המפנה

            • domain_from_ip
              סוג: string | null

              כתובת ה-IP של הדומיין המפנה

            • domain_from_is_ip
              סוג: boolean | null

              מציין אם הדומיין הוא IP
              אם true, הדומיין מתפקד ככתובת IP ואין לו שם דומיין

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

              סוגי הפלטפורמות של הדומיין המפנה

              ערכים אפשריים: cms, blogs, ecommerce, message-boards, wikis, news, organization

            • domain_from_rank
              סוג: integer | null

              דירוג הדומיין של הדומיין המפנה
              domain_from_rank מחושב לפי שיטת דירוג הצמתים במסד נתונים מקושר — עיקרון שמשמש באלגוריתם Google PageRank המקורי
              מידע נוסף על המדד ואופן החישוב שלו במאמר מרכז העזרה הזה

            • domain_to
              סוג: string | null

              הדומיין שאליו הקישור הנכנס מצביע

            • first_seen
              סוג: string | null

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

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

              מציין את המספר הכולל של קישורים נכנסים מהדומיין הזה
              לדוגמה, אם mode מוגדר ל-one_per_domain, השדה הזה יציין את המספר הכולל של קישורים נכנסים שמגיעים מהדומיין הזה

            • image_url
              סוג: string | null

              כתובת URL של התמונה
              כתובת ה-URL שמובילה לתמונה במשאב המקורי או באחסון של DataForSEO (אם המקור המקורי אינו זמין)

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

              נתיב קישור עקיף
              מציין כתובת URL או רצף כתובות URL שמובילים אל url_to

              • status_code
                סוג: integer | null

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

              • type
                סוג: string | null

                סוג הרכיב

              • url
                סוג: string | null

                כתובת ה-URL של הקישור העקיף

            • is_broken
              סוג: boolean | null

              מציין אם הקישור הנכנס שבור
              אם true, הקישור הנכנס מצביע לדף שמחזיר קוד סטטוס 4xx או 5xx

            • is_indirect_link
              סוג: boolean | null

              מציין אם הקישור הנכנס הוא קישור עקיף
              אם true, הקישור הנכנס הוא קישור עקיף שמצביע לדף שמפנה אל url_to, או שמצביע לעמוד קנוני

            • is_lost
              סוג: boolean | null

              מציין אם הקישור הנכנס הוסר
              אם true, הקישור הנכנס או הדף כולו הוסר

            • is_new
              סוג: boolean | null

              מציין אם הקישור הנכנס חדש
              אם true, הקישור הנכנס נמצא בדף בביקור האחרון של הסורק שלנו

            • item_type
              סוג: string | null

              סוג הקישור
              ערכים אפשריים:
              anchor, image, meta, canonical, alternate, redirect

            • last_seen
              סוג: string | null

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

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

              מספר הקישורים הנכנסים הזהים שנמצאו בדף המפנה

            • original
              סוג: boolean | null

              מציין אם הקישור הנכנס היה קיים בדף המפנה כשהסורק שלנו ביקר בו לראשונה

            • page_from_encoding
              סוג: string | null

              קידוד התווים של הדף המפנה
              דוגמה:
              utf-8

            • page_from_external_links
              סוג: integer | null

              מספר הקישורים החיצוניים שנמצאו בדף המפנה

            • page_from_internal_links
              סוג: integer | null

              מספר הקישורים הפנימיים שנמצאו בדף המפנה

            • page_from_language
              סוג: string | null

              שפת הדף המפנה
              בפורמט ISO 639-1
              דוגמה:
              en

            • page_from_rank
              סוג: integer | null

              דירוג העמוד של הדף המפנה
              page_from_rank מחושב לפי שיטת דירוג הצמתים במסד נתונים מקושר — עיקרון שמשמש באלגוריתם Google PageRank המקורי
              מידע נוסף על המדד ואופן החישוב שלו במאמר מרכז העזרה הזה

            • page_from_size
              סוג: integer | null

              גודל הדף המפנה, בבייטים
              דוגמה:
              63357

            • page_from_status_code
              סוג: integer | null

              קוד סטטוס HTTP שהדף המפנה מחזיר
              דוגמה:
              200

            • page_from_title
              סוג: string | null

              הכותרת של הדף המפנה

            • prev_seen
              סוג: string | null

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

            • rank
              סוג: integer | null

              דירוג הקישור הנכנס
              הדירוג שהקישור הנכנס הנתון מעביר ל-target
              rank מחושב לפי שיטת דירוג הצמתים במסד נתונים מקושר — עיקרון שמשמש באלגוריתם Google PageRank המקורי
              מידע נוסף על המדד ואופן החישוב שלו במאמר מרכז העזרה הזה

            • ranked_keywords_info
              סוג: object | null · Response36Afe1097B20_RankedKeywordsInfo
              • page_from_keywords_count_top_10
                סוג: integer | null פורמט: int64

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

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

                Signed 64-bit integers (long type).

            • semantic_location
              סוג: string | null

              מציין את האלמנט הסמנטי ב-HTML שבו נמצא הקישור הנכנס
              את הרשימה המלאה של האלמנטים הסמנטיים אפשר למצוא כאן
              דוגמאות:
              article, section, summary

            • text_post
              סוג: string | null

              מקטע אחרי טקסט העוגן

            • text_pre
              סוג: string | null

              מקטע לפני טקסט העוגן

            • tld_from
              סוג: string | null

              דומיין ברמה העליונה של כתובת ה-URL המפנה

            • type
              סוג: string | null

              סוג הרכיב

            • url_from
              סוג: string | null

              כתובת ה-URL של הדף שבו נמצא הקישור הנכנס

            • url_from_https
              סוג: boolean | null

              מציין אם כתובת ה-URL המפנה מאובטחת ב-HTTPS
              אם true, כתובת ה-URL המפנה מאובטחת ב-HTTPS

            • url_to
              סוג: string | null

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

            • url_to_https
              סוג: boolean | null

              מציין אם כתובת ה-URL שאליה הקישור הנכנס מצביע מאובטחת ב-HTTPS
              אם true, כתובת ה-URL מאובטחת ב-HTTPS

            • url_to_redirect_target
              סוג: string | null

              כתובת ה-URL של יעד ההפניה
              דף היעד שאליו ההפניה מצביעה

            • url_to_spam_score
              סוג: integer | null

              ציון הספאם של הדף שאליו מפנה הקישור
              אם הערך הוא null, הסורק שלנו עדיין לא ביקר בעמוד שאליו הקישור מצביע;
              מידע נוסף על אופן חישוב המדד בעמוד מרכז העזרה הזה

            • url_to_status_code
              סוג: integer | null

              קוד הסטטוס של הדף שאליו מפנה הקישור
              אם הערך הוא null, הסורק שלנו עדיין לא ביקר בעמוד שאליו הקישור מצביע
              דוגמה:
              200

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

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

          • mode
            סוג: string | null

            המצב שצוין במערך POST

          • search_after_token
            סוג: string | null

            טוקן לבקשות עוקבות
            כשמציינים את search_after_token הייחודי בעת הגדרת משימה חדשה, תקבלו את התוצאות העוקבות של המשימה הראשונית;
            ערכי search_after_token ייחודיים לכל משימה עוקבת

          • 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/backlinks/backlinks/live
curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/backlinks/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "mode": "as_is",
    "filters": [
      "dofollow",
      "=",
      true
    ],
    "limit": 5
  }
]'

{
  "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": [
        {
          "target": null,
          "mode": null,
          "custom_mode": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "domain_from": null,
              "url_from": null,
              "url_from_https": null,
              "domain_to": null,
              "url_to": null,
              "url_to_https": null,
              "tld_from": null,
              "is_new": null,
              "is_lost": null,
              "backlink_spam_score": null,
              "rank": null,
              "page_from_rank": null,
              "domain_from_rank": null,
              "domain_from_platform_type": [
                "[Max Depth Exceeded]"
              ],
              "domain_from_is_ip": null,
              "domain_from_ip": null,
              "domain_from_country": null,
              "page_from_external_links": null,
              "page_from_internal_links": null,
              "page_from_size": null,
              "page_from_encoding": null,
              "page_from_language": null,
              "page_from_title": null,
              "page_from_status_code": null,
              "first_seen": null,
              "prev_seen": null,
              "last_seen": null,
              "item_type": null,
              "attributes": [
                "[Max Depth Exceeded]"
              ],
              "dofollow": null,
              "original": null,
              "alt": null,
              "image_url": null,
              "anchor": null,
              "text_pre": null,
              "text_post": null,
              "semantic_location": null,
              "links_count": null,
              "group_count": null,
              "is_broken": null,
              "url_to_status_code": null,
              "url_to_spam_score": null,
              "url_to_redirect_target": null,
              "ranked_keywords_info": "[Max Depth Exceeded]",
              "is_indirect_link": null,
              "indirect_link_path": [
                "[Max Depth Exceeded]"
              ]
            }
          ],
          "search_after_token": null
        }
      ]
    }
  ]
}

פעולה מוצלחת

Backlinks