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/dataforseo_labs/google/relevant_pages/live

עמודים רלוונטיים

אילו עמודים באתר target מזכים אותו בדירוגים, לפי נפח התנועה שהם מביאים. עימוד עם limit, offset ו-offset_token; השתמשו בטוקן לאחר העמודים הראשונים. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. השתמשו בו כדי למצוא את העמודים ששווה להגן עליהם או להרחיב. למילות המפתח שמאחוריהם השתמשו ב-post_dataforseo_labs_google_kw_for_site_live; ולעמודים שמרוויחים קישורים ולא דירוגים, post_dataforseo_backlinks_domain_pages_summary_live.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- filters
  סוג: array (object | null)[] | null
  
  מערך פרמטרים לסינון תוצאות
  שדה אופציונלי
  אפשר להוסיף כמה מסננים בבת אחת (עד 8 מסננים)
  יש להגדיר אופרטור לוגי and או or בין התנאים
  האופרטורים הנתמכים:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in
  
  דוגמה:
  ["metrics.paid.count",">",0]
  
  [["metrics.organic.count",">",50],"and",["metrics.organic.pos_1","<>",0]]
  
  [[""metrics.organic.count",">",50"], "and", [["metrics.organic.pos_1","<>",0],"or",["metrics.organic.pos_2_3","<>",0]]]
  למידע נוסף על מסננים ראו Dataforseo Labs - Filters או מדריך מרכז העזרה
  
  אובייקט ריק
- historical_serp_mode
  סוג: string | null
  
  מצב איסוף נתונים
  שדה אופציונלי
  אפשר להשתמש בשדה זה כדי לסנן את התוצאות;
  סוגי סינון אפשריים:
  live — החזרת מדדים עבור SERP שבהם ל-target שצוין יש כיום תוצאות דירוג;
  lost — החזרת מדדים עבור SERP שבהם ל-target שצוין היו בעבר תוצאות דירוג, אך לא היו לו אותן בבדיקה האחרונה;
  all — החזרת מדדים לשני סוגי ה-SERP.
  ברירת מחדל: live
- ignore_synonyms
  סוג: boolean | null
  
  התעלמות ממילות מפתח דומות מאוד
  שדה אופציונלי
  אם הערך הוא true, יוחזרו רק מילות מפתח ליבתיות וכל מילות המפתח הדומות מאוד יוחרגו;
  ערך ברירת מחדל: false
- include_clickstream_data
  סוג: boolean | null
  
  הכללה או החרגה של נתונים ממדדי clickstream בתוצאה
  שדה אופציונלי
  אם הפרמטר מוגדר ל-true, תקבלו את השדות clickstream_etv, clickstream_gender_distribution ו-clickstream_age_distribution עם נתוני clickstream בתגובה
  ערך ברירת מחדל: false
  כשהפרמטר הזה מופעל, תחויבו במחיר כפול עבור הבקשה
  
  מידע נוסף על אופן חישוב מדדי clickstream מופיע במאמר במרכז העזרה
- item_types
  סוג: array string[] | null
  
  הצגת תוצאות לפי סוג פריט
  שדה אופציונלי
  מציין את סוג תוצאות החיפוש שנכללות בתגובה
  
  הערה: אם מערך item_types מכיל סוגי פריטים שונים מ-organic, התוצאות ימוינו לפי סוג הפריט הראשון במערך; לא תוכלו למיין ולסנן תוצאות לפי סוגי תוצאות חיפוש שלא נכללו בתגובה.
  
  ערכים אפשריים:
  ["organic", "paid", "featured_snippet", "local_pack"]
  ערך ברירת מחדל:
  ["organic", "paid"]
- language_code
  סוג: string | null
  
  קוד שפה
  שדה אופציונלי
  אם תשתמשו בשדה זה, אין צורך לציין language_name
  אפשר לקבל את רשימת השפות הזמינות עם language_code שלהן באמצעות בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  התעלמו משדה זה כדי לקבל תוצאות עבור כל השפות הזמינות
  דוגמה:
  en
- language_name
  סוג: string | null
  
  השם המלא של השפה
  שדה אופציונלי
  אם תשתמשו בשדה זה, אין צורך לציין language_code
  אפשר לקבל את רשימת השפות הזמינות עם language_name שלהן באמצעות בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  התעלמו משדה זה כדי לקבל תוצאות עבור כל השפות הזמינות
  דוגמה:
  English
- limit
  סוג: integer | null
  
  המספר המרבי של דפים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 100
  ערך מרבי: 1000
- location_code
  סוג: integer | null
  
  קוד מיקום
  שדה אופציונלי
  אם תשתמשו בשדה זה, אין צורך לציין location_name
  אפשר לקבל את רשימת המיקומים הזמינים עם location_code שלהם באמצעות בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  התעלמו משדה זה כדי לקבל תוצאות עבור כל המיקומים הזמינים
  דוגמה:
  2840
- location_name
  סוג: string | null
  
  השם המלא של המיקום
  שדה אופציונלי
  אם תשתמשו בשדה זה, אין צורך לציין location_code
  אפשר לקבל את רשימת המיקומים הזמינים עם location_name שלהם באמצעות בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  התעלמו משדה זה כדי לקבל תוצאות עבור כל המיקומים הזמינים
  דוגמה:
  United Kingdom
- offset
  סוג: integer | null
  
  היסט במערך התוצאות של דפים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 0
  אם תציינו את הערך 10, עשרת הדפים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור הדפים העוקבים
- order_by
  סוג: array string[] | null
  
  כללי מיון תוצאות
  שדה אופציונלי
  אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות
  סוגי מיון אפשריים:
  asc - התוצאות ימוינו בסדר עולה
  desc - התוצאות ימוינו בסדר יורד
  יש להשתמש בפסיק כדי להגדיר סוג מיון
  דוגמה:
  ["metrics.paid.etv,asc"]
  הערה: לא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
  דוגמה:
  ["metrics.organic.etv,desc","metrics.paid.count,asc"]
  
  כלל ברירת מחדל:
  ["metrics.organic.count,desc"]
  הערה: אם מערך item_types מכיל סוגי פריטים שונים מ-organic, התוצאות ימוינו לפי סוג הפריט הראשון במערך
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה
- target
  סוג: string
  
  דומיין
  שדה חובה
  שם הדומיין של אתר היעד
  יש לציין את הדומיין ללא https:// וללא www.

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

עמודים רלוונטיים ונתונים קשורים

metrics
סוג: object | null

דירוגים ומדדי תנועה עבור העמוד הרלוונטי

propertyName
סוג: object · Response36Afe1097B20_DataforseoLabsMetricsInfo
clickstream_age_distribution
סוג: object | null

התפלגות מדדים מבוססי clickstream לפי גיל
כדי לקבל תוצאות עבור שדה זה, יש להגדיר את הפרמטר include_clickstream_data ל-true
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה

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

Signed 64-bit integers (long type).

clickstream_etv
סוג: number | null פורמט: double

נפח תנועה מוערך בהתבסס על נתוני clickstream
מחושב כמכפלה של שיעור הקלקה וערכי נפח החיפוש ב-clickstream של כל מילות המפתח שהדומיין מדורג עבורן
כדי לקבל תוצאות עבור שדה זה, יש להגדיר את הפרמטר include_clickstream_data ל-true
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה

clickstream_gender_distribution
סוג: object | null

התפלגות מדדים מוערכים מבוססי clickstream לפי מין
כדי לקבל תוצאות עבור שדה זה, יש להגדיר את הפרמטר include_clickstream_data ל-true
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה

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

Signed 64-bit integers (long type).

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

הספירה הכוללת של תוצאות SERP אורגניות המכילות את הדומיין או תת-הדומיין

estimated_paid_traffic_cost
סוג: number | null

העלות המוערכת של המרת תנועת חיפוש אורגנית לממומנת
מייצג את העלות החודשית המוערכת (בדולרים) של הפעלת מודעות עבור כל מילות המפתח בקטגוריה שהדומיין או תת-הדומיין מדורג בהם
המדד מחושב כמכפלה של ערכי etv אורגניים ו-cpc ממומנים, ומציין את העלות של הבאת נפח התנועה האורגנית החודשי המוערך באמצעות פרסום PPC בחיפוש Google
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה

etv
סוג: number | null

נפח תנועה מוערך
תנועה אורגנית חודשית מוערכת לדומיין או לתת-הדומיין
מחושב כמכפלה של ערכי CTR (שיעור הקלקה) ונפח החיפוש של כל מילות המפתח בקטגוריה שהדומיין או תת-הדומיין מדורג בהם
מידע נוסף על אופן חישוב המדד במאמר מרכז העזרה הזה

is_down
סוג: integer | null

הדירוג ירד
מציין כמה רכיבים מדורגים של היעד שצוין ירדו

is_lost
סוג: integer | null

רכיבים מדורגים שאבדו
מציין כמה רכיבים מדורגים של היעד שצוין הוצגו בעבר ב-SERP אך לא נמצאו בבדיקה האחרונה

is_new
סוג: integer | null

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

is_up
סוג: integer | null

הדירוג עלה
מציין כמה רכיבים מדורגים של היעד שצוין עלו

pos_1
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #1

pos_11_20
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #11-20

pos_2_3
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #2-3

pos_21_30
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #21-30

pos_31_40
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #31-40

pos_4_10
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #4-10

pos_41_50
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #41-50

pos_51_60
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #51-60

pos_61_70
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #61-70

pos_71_80
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #71-80

pos_81_90
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #81-90

pos_91_100
סוג: integer | null

מספר תוצאות ה-SERP האורגניות שבהן הדומיין או תת-הדומיין מדורג #91-100

page_address
סוג: string | null

כתובת URL מוחלטת של העמוד הרלוונטי

se_type
סוג: string | null

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

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

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

language_code
סוג: string | null

קוד שפה במערך POST
אם אין נתונים, הערך הוא null

location_code
סוג: integer | null

קוד מיקום במערך POST
אם אין נתונים, הערך הוא null

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

post/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/relevant_pages/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": "amazon.com",
    "language_name": "English",
    "location_code": 2840,
    "filters": [
      [
        "metrics.organic.pos_1",
        "<>",
        0
      ],
      "or",
      [
        "metrics.organic.pos_2_3",
        "<>",
        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,
          "items": [
            {
              "se_type": null,
              "page_address": null,
              "metrics": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

עמודים רלוונטיים

אימותRequired

DataForSEO

עמודים רלוונטיים

מראה תמחור