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

מתחרים

אתרים החולקים דומיינים מפנים עם target אחד, מדורגים לפי כמה הם חולקים. כל שורה נותנת target, rank ו-intersections — מספר הדומיינים המקשרים המשותפים. main_domain, exclude_large_domains ו-exclude_internal_backlinks קובעים מה נספר. אלה מתחרים בגרף הקישורים, לא מתחרים בחיפוש; עבור האחרונים השתמשו ב-post_dataforseo_labs_google_serp_competitors_live. כדי לראות את הדומיינים המשותפים בפועל השתמשו ב-post_dataforseo_backlinks_domain_intersection_live.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- exclude_internal_backlinks
  סוג: boolean | null
  
  מציין אם קישורים נכנסים פנימיים מתתי-דומיינים אל target יוחרגו מהתוצאות
  שדה אופציונלי
  אם מוגדר ל-true, התוצאות לא יכללו נתונים על קישורים נכנסים פנימיים מתתי-דומיינים של אותו דומיין כמו target
  אם מוגדר ל-false, הקישורים הפנימיים ייכללו בתוצאות
  ערך ברירת מחדל: true
- exclude_large_domains
  סוג: boolean | null
  
  מציין אם דומיין גדול יופיע בתוצאות
  שדה אופציונלי
  אם מוגדר ל-true, התוצאות מהדומיין הגדול (google.com, amazon.com וכו') יושמטו;
  ערך ברירת מחדל: 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 כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["rank",">","100"]
  
  [["target","like","%forbes%"], "and", [["rank",">","100"],"or",["intersections",">","5"]]]
  
  הרשימה המלאה של המסננים האפשריים זמינה כאן.
  
  אובייקט ריק
- limit
  סוג: integer | null
  
  המספר המרבי של דומיינים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 100
  הערך המרבי: 1000
- main_domain
  סוג: boolean | null
  
  מציין אם רק הדומיין הראשי של target ייכלל בחיפוש
  שדה אופציונלי
  אם מוגדר ל-true, רק הדומיין הראשי ייכלל בחיפוש;
  ערך ברירת מחדל: true
- offset
  סוג: integer | null
  
  היסט במערך התוצאות של הדומיינים המוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 0
  אם מציינים את הערך 10, עשרת הדומיינים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור העמודים העוקבים
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc — התוצאות ימוינו בסדר עולה
  desc — התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["rank,desc"]
  שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להפריד בין כמה כללי מיון בפסיק
  דוגמה:
  ["intersections,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 של התגובה
- target
  סוג: string
  
  דומיין, תת-דומיין או עמוד שעבורם מתקבלים דומיינים מתחרים
  שדה חובה
  יש לציין דומיין או תת-דומיין בלי https:// ובלי www.
  יש לציין עמוד בכתובת URL מוחלטת (כולל http:// או https://)

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

מערך הפריטים

intersections
סוג: integer | null

מציין את מספר החפיפות של קישורים נכנסים עם ה-target שצוין במערך POST

rank
סוג: integer | null

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

target
סוג: string | null

דומיין מתחרה

type
סוג: string | null

סוג הרכיב

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

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

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

curl https://openapi.felo.ai/v1/beta/dataforseo/backlinks/competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "dataforseo.com",
    "filters": [
      "rank",
      ">",
      100
    ],
    "order_by": [
      "rank,desc"
    ],
    "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": [
        {
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "type": null,
              "target": null,
              "rank": null,
              "intersections": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

מתחרים

אימותRequired

DataForSEO

מתחרים

מראה תמחור