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

post/v1/beta/dataforseo/backlinks/domain_intersection/live

הצטלבות דומיינים

הדומיינים שמקשרים לכמה יעדים בבת אחת. ⚠️ targets כאן הוא אובייקט שממופתח לפי מיקום — {"1": "a.com", "2": "b.com"} — ולא המערך שנקודות הקצה בכמות מקבלות. exclude_targets מסיר אתרים מההשוואה. כל שורה נושאת domain_intersection ו-summary לכל יעד. השתמשו בזה כדי למצוא מי מקשר למתחרים שלכם אבל לא אליכם. המקבילה ברמת העמוד היא post_dataforseo_backlinks_page_intersection_live.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- backlinks_filters
 סוג: array (object | null)[] | null
 
 סינון הקישורים הנכנסים של target
 שדה אופציונלי
 אפשר להשתמש בשדה זה כדי לסנן את הקישורים הנכנסים הראשוניים שייכללו במערך הנתונים עבור מדדים מצטברים של target
 אפשר לסנן את הקישורים הנכנסים לפי כל השדות הזמינים בתגובה של נקודת הקצה הזו
 באמצעות פרמטר זה, אפשר לכלול בתגובה רק קישורים נכנסים מסוג dofollow וליצור מערך נתונים גמיש של קישורים נכנסים לחישוב המדדים עבורו
 דוגמה:
 "backlinks_filters": [["dofollow", "=", true]]
 
 אובייקט ריק
- backlinks_status_type
 סוג: string | null
 
 קביעת הקישורים הנכנסים שיוחזרו וייספרו
 שדה אופציונלי
 אפשר להשתמש בשדה זה כדי לבחור אילו קישורים נכנסים יוחזרו וישמשו למדדים מצטברים של targets;
 ערכים אפשריים:
 all — כל הקישורים הנכנסים יוחזרו וייספרו;
 live — קישורים נכנסים שנמצאו בבדיקה האחרונה יוחזרו וייספרו;
 lost — קישורים נכנסים שאבדו יוחזרו וייספרו;
 
 ערך ברירת מחדל: live
- exclude_internal_backlinks
 סוג: boolean | null
 
 מציין אם הקישורים הנכנסים מתת-דומיינים של target מוחרגים
 שדה אופציונלי
 אם מוגדר ל-false, הקישורים הנכנסים מתת-דומיינים של target יושמטו ולא תקבלו את אותו דומיין בתגובה;
 ערך ברירת מחדל: true
- exclude_targets
 סוג: array string[] | null
 
 דומיינים, תתי-דומיינים או עמודים שברצונכם להחריג
 שדה אופציונלי
 אפשר לציין עד 10 דומיינים, תתי-דומיינים או עמודים
 אם משתמשים במערך הזה, התוצאות יכללו את הדומיינים המפנים שמקשרים אל targets אך לא מקשרים אל exclude_targets
 דוגמה:
 "exclude_targets": [ "bbc.com", "https://www.apple.com/iphone/*", "https://dataforseo.com/apis/*"]
- filters
 סוג: array (object | null)[] | null
 
 מערך פרמטרים לסינון תוצאות
 שדה אופציונלי
 אפשר להוסיף כמה מסננים בבת אחת (עד 8)
 יש להגדיר אופרטור לוגי and או or בין התנאים
 האופרטורים הנתמכים:
 regex, not_regex, =, <>, in, not_in, like, not_like, ilike, not_ilike, match, not_match
 אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר
 דוגמה:
 ["1.internal_links_count",">","1"]
 
 [["2.referring_pages",">","2"], "and", ["1.backlinks",">","10"]]
 
 [["1.first_seen",">","2017-10-23 11:31:45 +00:00"], "and", [["2.target","like","%dataforseo.com%"],"or",["1.referring_domains",">","10"]]]
 
 הרשימה המלאה של המסננים האפשריים זמינה כאן.
 
 אובייקט ריק
- include_indirect_links
 סוג: boolean | null
 
 מציין אם קישורים עקיפים אל targets ייכללו בתוצאות
 שדה אופציונלי
 אם מוגדר ל-true, התוצאות יכללו נתונים על קישורים עקיפים שמצביעים על עמוד שמפנה מחדש אל יעד, או על עמוד קנוני
 אם מוגדר ל-false, המערכת תתעלם מקישורים עקיפים
 ערך ברירת מחדל: true
- include_subdomains
 סוג: boolean | null
 
 מציין אם תתי-הדומיינים של target ייכללו בחיפוש
 שדה אופציונלי
 אם מוגדר ל-false, המערכת תתעלם מתתי-הדומיינים
 ערך ברירת מחדל: true
- internal_list_limit
 סוג: integer | null
 
 המספר המרבי של פריטים במערכים פנימיים
 שדה אופציונלי
 אפשר להשתמש בשדה הזה כדי להגביל את מספר הפריטים במערכים הבאים:
 referring_links_tld
 referring_links_types
 referring_links_attributes
 referring_links_platform_types
 referring_links_semantic_locations
 
 ערך ברירת מחדל: 10
 הערך המרבי: 1000
- intersection_mode
 סוג: string | null
 
 מציין אם להצליב קישורים נכנסים
 שדה אופציונלי
 השתמשו בשדה הזה כדי להצליב או למזג תוצאות עבור הדומיינים שצוינו
 ערכים אפשריים: all, partial
 all — התוצאות מבוססות על כל הקישורים הנכנסים;
 partial — התוצאות מבוססות רק על הקישורים הנכנסים החופפים;
 ערך ברירת מחדל: all
- limit
 סוג: integer | null
 
 המספר המרבי של תוצאות מוחזרות
 שדה אופציונלי
 ערך ברירת מחדל: 100
 הערך המרבי: 1000
- offset
 סוג: integer | null
 
 היסט במערך התוצאות המוחזרות
 שדה אופציונלי
 ערך ברירת מחדל: 0
 אם מציינים את הערך 10, עשרת הקישורים הנכנסים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור הקישורים הנכנסים העוקבים
- order_by
 סוג: array string[] | null
 
 כללי מיון תוצאות
 שדה אופציונלי
 אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
 סוגי מיון אפשריים:
 asc — התוצאות ימוינו בסדר עולה
 desc — התוצאות ימוינו בסדר יורד
 יש להשתמש בפסיק כדי להגדיר סוג מיון
 דוגמה:
 ["backlinks,desc"]
 שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
 יש להפריד בין כמה כללי מיון בפסיק
 דוגמה:
 ["backlinks,desc","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
 
 מידע נוסף על אופן הפעולה של הפרמטר הזה ועל חישוב מדדי הדירוג זמין במאמר מרכז העזרה הזה
- tag
 סוג: string | null
 
 מזהה משימה מוגדר על ידי המשתמש
 שדה אופציונלי
 מגבלת התווים היא 255
 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
 את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה
- targets
 סוג: object | null
 
 דומיינים, תתי-דומיינים או עמודים שעבורם מתקבלים קישורים
 שדה חובה
 אפשר להגדיר עד 20 דומיינים, תתי-דומיינים או עמודים
 יש לציין דומיין או תת-דומיין בלי https:// ובלי www.
 יש לציין עמוד בכתובת URL מוחלטת (כולל http:// או https://)
 דוגמה:
 "targets": { "1": "http://planet.postgresql.org/", "2": "http://gborg.postgresql.org/" }
 
 propertyName
 סוג: string | null

תגובות

200
סוג: object | null · Response36Afe1097B20_BacklinksDomainIntersectionLiveResponseInfo
cost
סוג: number | null פורמט: double

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

מכיל את הדומיינים שמקשרים לכל ה-targets ממערך POST

domain_intersection
סוג: object | null

מכיל נתונים על דומיינים שמקשרים ליעדים המתאימים שצוינו במערך POST
הנתונים מסופקים באובייקטים נפרדים המתאימים לדומיינים, תתי-דומיינים או דפים שצוינו באובייקט targets

propertyName
סוג: object | null · Response36Afe1097B20_BacklinksDomainIntersection
backlinks
סוג: integer | null פורמט: int64

מציין את מספר הקישורים הנכנסים

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

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

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

מספר הקישורים הנכנסים השבורים

broken_pages
סוג: integer | null

מספר הדפים השבורים

first_seen
סוג: string | null

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

lost_date
סוג: string | null

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

rank
סוג: integer | null

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

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

מספר הדומיינים המפנים

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

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

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

מספר כתובות ה-IP המפנות

referring_links_attributes
סוג: object | null

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

propertyName
סוג: integer | null

Integer numbers.

referring_links_countries
סוג: object | null

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

referring_links_platform_types
סוג: object | null

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

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

propertyName
סוג: integer | null

Integer numbers.

referring_links_semantic_locations
סוג: object | null

מיקומים סמנטיים של הקישורים המפנים
מציין את האלמנטים הסמנטיים ב-HTML שבהם נמצאים הקישורים המפנים ואת מספר הקישורים לכל מיקום סמנטי
את הרשימה המלאה של האלמנטים הסמנטיים אפשר למצוא כאן

propertyName
סוג: integer | null

Integer numbers.

referring_links_tld
סוג: object | null

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

propertyName
סוג: integer | null

Integer numbers.

referring_links_types
סוג: object | null

סוגי הקישורים המפנים
מציין את סוגי הקישורים המפנים ואת מספר הקישורים לכל סוג
ערכים אפשריים:
anchor, image, link, meta, canonical, alternate, redirect

propertyName
סוג: integer | null

Integer numbers.

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

מספר הדומיינים הראשיים המפנים

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

מספר הדומיינים הראשיים שמצביעים לפחות קישור nofollow אחד ל-target

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

מציין את מספר הדפים שמצביעים ל-target

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

מספר הדפים המפנים שמצביעים לפחות קישור nofollow אחד ל-target

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

מספר תתי-הרשתות המפנות

target
סוג: string | null

הדומיין שמקשר ליעד המתאים ממערך POST

type
סוג: string | null

סוג הרכיב

summary
סוג: object | null · Response36Afe1097B20_IntersectionSummaryInfo

מכיל את סיכום החפיפות בין דומיינים

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

המספר הכולל של חיתוכים

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

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

targets
סוג: object | null

דומיינים, תתי-דומיינים או דפי אינטרנט של יעד במערך POST

propertyName
סוג: string | null
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

post/v1/beta/dataforseo/backlinks/domain_intersection/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": {
      "1": "moz.com",
      "2": "ahrefs.com"
    },
    "include_subdomains": false,
    "exclude_targets": [
      "semrush.com"
    ],
    "limit": 5,
    "order_by": [
      "1.backlinks,desc"
    ],
    "exclude_internal_backlinks": true
  }
]'

הצגת סכמה

{
  "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": [
        {
          "targets": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "domain_intersection": null,
              "summary": "[Max Depth Exceeded]"
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

הצטלבות דומיינים

אימותRequired

DataForSEO

הצטלבות דומיינים

מראה תמחור