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_pages/live

עמודי הדומיין

העמודים של target אחד שיש להם קישורים נכנסים, עם תצוגת הסורק של כל אחד: main_domain, domain, tld, page, ip, first_visited, prev_visited ו-fetch_time. השתמשו בזה כדי למצוא אילו עמודים באמת צוברים קישורים. לספירות קישורים נכנסים לכל עמוד ולא למטא-נתוני סריקה השתמשו ב-post_dataforseo_backlinks_domain_pages_summary_live.

מראה תמחור

מדידה: עלות תגובה מדווחת.
אומדן בקשת ייחוס: 0.0276 דולר ארה״ב.
מכפיל לקוח לייחוס: 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
  
  קביעת הקישורים הנכנסים שיוחזרו וייספרו
  שדה אופציונלי
  אפשר להשתמש בשדה זה כדי לבחור אילו קישורים נכנסים יוחזרו וישמשו למדדים מצטברים;
  ערכים אפשריים:
  all — כל הקישורים הנכנסים יוחזרו וייספרו;
  live — קישורים נכנסים שנמצאו בבדיקה האחרונה יוחזרו וייספרו;
  lost — קישורים נכנסים שאבדו יוחזרו וייספרו;
  
  ערך ברירת מחדל: live
- exclude_internal_backlinks
  סוג: boolean | null
  
  מציין אם קישורים נכנסים פנימיים מתתי-דומיינים אל target יוחרגו מהתוצאות
  שדה אופציונלי
  אם מוגדר ל-true, התוצאות לא יכללו נתונים על קישורים נכנסים פנימיים מתתי-דומיינים של אותו דומיין כמו target
  אם מוגדר ל-false, הקישורים הפנימיים ייכללו בתוצאות
  ערך ברירת מחדל: true
- 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 כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["meta.internal_links_count",">","1"]
  
  [["meta.external_links_count",">","2"], "and", ["backlinks",">","10"]]
  
  [["first_visited",">","2017-10-23 11:31:45 +00:00"], "and", [["title","like","%seo%"],"or",["referring_domains",">","10"]]]
  
  הרשימה המלאה של המסננים האפשריים זמינה כאן.
  
  אובייקט ריק
- 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
- limit
  סוג: integer | null
  
  המספר המרבי של דפים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 100
  ערך מרבי: 1000
- offset
  סוג: integer | null
  
  היסט במערך התוצאות של דפים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 0
  אם תציינו את הערך 10, עשרת הדפים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור הדפים העוקבים
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc — התוצאות ימוינו בסדר עולה
  desc — התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["page_summary.backlinks,desc"]
  שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להפריד בין כמה כללי מיון בפסיק
  דוגמה:
  ["page_summary.backlinks,desc","page_summary.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 של התגובה
- target
  סוג: string
  
  דומיין או תת-דומיין
  שדה חובה
  יש לציין דומיין או תת-דומיין בלי https:// ובלי www.
  דוגמה:
  forbes.com

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

מערך הפריטים

content_encoding
סוג: string | null

סוג הקידוד

domain
סוג: string | null

דומיין
הדומיין שבו נמצא הדף

encoded_size
סוג: integer | null

גודל הדף לאחר קידוד
מציין את גודל הדף המקודד, בבייטים

fetch_time
סוג: string | null

התאריך והשעה העדכניים ביותר שבהם הסורק שלנו ביקר בדף
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:
2017-01-24 13:20:59 +00:00

first_visited
סוג: string | null

התאריך והשעה של הביקור הראשון בדף
התאריך והשעה שבהם הסורק שלנו ביקר בדף הזה בפעם הראשונה
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:
2017-01-24 13:20:59 +00:00

ip
סוג: string | null

כתובת IP

location
סוג: string | null

כותרת Location
מציין את כתובת ה-URL שאליה יש להפנות את הדף, אם קיימת

main_domain
סוג: string | null

דומיין האתר הראשי
דומיין האתר הראשי אינו כולל תתי-דומיינים

media_type
סוג: string | null

סוגי המדיה המשמשים להצגת דף

meta
סוג: object | null · Response36Afe1097B20_BacklinksPageMeta

מטא-נתונים של הדף

canonical
סוג: string | null

עמוד קנוני

charset
סוג: string | null

קידוד תווים
דוגמאות:
utf-8

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

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

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

תג h1
התוכן של תגי h1

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

תג h2
התוכן של תגי h2

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

תג h3
התוכן של תגי h3

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

התוכן של תגי alt

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

מספר התמונות בדף

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

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

language
סוג: string | null

שפת תוכן הדף
דוגמה:
en

page_spam_score
סוג: integer | null

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

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

סוג הפלטפורמה

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

פרטי CMS

social_media_tags
סוג: object | null
propertyName
סוג: string | null
technologies
סוג: object | null

טכנולוגיות האתר

propertyName
סוג: string | null
title
סוג: string | null

כותרת העמוד

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

מספר המילים בדף

page
סוג: string | null

כתובת ה-URL של הדף
כתובת ה-URL של הדף הרלוונטי

page_summary
סוג: object | null · Response36Afe1097B20_PageSummary

מכיל נתוני קישורים נכנסים עבור הדף הזה

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

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

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

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

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

מספר קישורים נכנסים שבורים
מספר הקישורים הנכנסים השבורים שמצביעים ל-page

broken_pages
סוג: integer | null

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

first_seen
סוג: string | null

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

lost_date
סוג: string | null

התאריך והשעה שבהם הקישור הנכנס האחרון לעמוד זה אבד
מציין את התאריך והשעה שבהם הסורק שלנו ביקר בעמוד והוא החזיר קוד סטטוס 4xx או 5xx, או שהקישור הנכנס האחרון הוסר
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:
2017-01-24 13:20:59 +00:00

rank
סוג: integer | null

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

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

מציין את מספר הדומיינים המפנים

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

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

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

מספר כתובות ה-IP המפנות
מספר כתובות IP שמצביעות לדף הזה

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

Signed 64-bit integers (long type).

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

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

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

Signed 64-bit integers (long type).

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

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

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

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

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

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

prev_visited
סוג: string | null

התאריך הקודם לתאריך העדכני ביותר שבו הסורק שלנו ביקר בדף
בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”
דוגמה:
2017-01-24 13:20:59 +00:00

server
סוג: string | null

גרסת השרת

size
סוג: integer | null

מציין את גודל הדף, בבייטים

status_code
סוג: integer | null

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

tld
סוג: string | null

דומיין ברמה העליונה
דומיין ברמה העליונה באזור השורש של DNS

type
סוג: string | null

סוג הרכיב

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

מספר הפריטים במערך items

target
סוג: string | null

target במערך 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

post/v1/beta/dataforseo/backlinks/domain_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/domain_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "forbes.com",
    "limit": 5,
    "filters": [
      [
        "page_summary.backlinks",
        ">",
        5
      ],
      "and",
      [
        "page",
        "like",
        "%sites%"
      ]
    ]
  }
]'

הצגת סכמה

{
  "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,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "main_domain": null,
              "domain": null,
              "tld": null,
              "page": null,
              "ip": null,
              "first_visited": null,
              "prev_visited": null,
              "fetch_time": null,
              "status_code": null,
              "location": null,
              "size": null,
              "encoded_size": null,
              "content_encoding": null,
              "media_type": null,
              "server": null,
              "meta": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "social_media_tags": "[Max Depth Exceeded]"
              },
              "page_summary": {
                "0": "[",
                "1": "M",
                "2": "a",
                "3": "x",
                "4": " ",
                "5": "D",
                "6": "e",
                "7": "p",
                "8": "t",
                "9": "h",
                "10": " ",
                "11": "E",
                "12": "x",
                "13": "c",
                "14": "e",
                "15": "e",
                "16": "d",
                "17": "e",
                "18": "d",
                "19": "]",
                "referring_main_domains_nofollow": "[Max Depth Exceeded]",
                "referring_links_tld": "[Max Depth Exceeded]",
                "referring_links_types": "[Max Depth Exceeded]",
                "referring_links_attributes": "[Max Depth Exceeded]",
                "referring_links_platform_types": "[Max Depth Exceeded]",
                "referring_links_semantic_locations": "[Max Depth Exceeded]",
                "referring_links_countries": "[Max Depth Exceeded]"
              }
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

עמודי הדומיין

אימותRequired

DataForSEO

עמודי הדומיין

מראה תמחור