v0.2.0-beta

OpenAPI 3.1.0

מתחרי SERP

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

מתחרי SERP

הדומיינים שמדורגים לצדכם עבור קבוצה של keywords, עם מספר המילים המשותפות. מחזיר se_type, seed_keywords, total_count, items_count ו-items. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. ⚠️ אלו מתחרי חיפוש, שנקבעים לפי דירוגים משותפים. המקבילה בגרף הקישורים היא post_dataforseo_backlinks_competitors_live, ושתי הרשימות לרוב חולקות — וזה כשלעצמו מאלף.

מראה תמחור

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

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

גוף

application/json

סוג: array (object | null)[]
- filters
  סוג: array (object | null)[] | null
  
  מערך פרמטרים לסינון תוצאות
  שדה אופציונלי
  אפשר להוסיף כמה מסננים בבת אחת (עד 8 מסננים)
  יש להגדיר אופרטור לוגי and או or בין התנאים
  האופרטורים הנתמכים:
  regex, not_regex, <, <=, >, >=, =, <>, in, not_in, match, not_match, ilike, not_ilike, like, not_like
  אפשר להשתמש באופרטור % עם like ו-not_like, וכן ilike ו-not_ilike, כדי להתאים כל מחרוזת של אפס תווים או יותר
  דוגמה:
  ["median_position","in",[1,10]]
  
  [["median_position","in",[1,10]],"and",["domain","not_like","%wikipedia.org%"]]
  
  [["domain","not_like","%wikipedia.org%"], "and", [["relevant_serp_items",">",0],"or",["median_position","in",[1,10]]]]
  למידע נוסף על מסננים ראו Dataforseo Labs - Filters או מדריך מרכז העזרה
  
  אובייקט ריק
- include_subdomains
  סוג: boolean | null
  
  מציין אם תת-הדומיינים ייכללו בחיפוש
  שדה אופציונלי
  אם הערך הוא false, המערכת תתעלם מתת-הדומיינים
  ערך ברירת מחדל: true
- item_types
  סוג: array string[] | null
  
  סוג תוצאות החיפוש
  מציין את סוג תוצאות החיפוש שנכללות בתגובה
  שדה אופציונלי
  
  ערכים אפשריים:
  ["organic", "paid", "featured_snippet", "local_pack"]
  ערך ברירת מחדל:
  ["organic", "paid"]
- keywords
  סוג: array string[]
  
  מערך מילות מפתח
  שדה חובה
  התוצאות יתבססו על מילות המפתח שתציינו במערך הזה
  קידוד UTF-8;
  מילות המפתח יומרו לאותיות קטנות;
  אפשר לציין לכל היותר 200 מילות מפתח
  
  מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO API מופיע במאמר במרכז העזרה
- language_code
  סוג: string | null
  
  מזהה שפה ייחודי
  שדה חובה אם לא מציינים language_name
  הערה: יש לציין language_name או language_code
  אפשר לקבל את רשימת השפות הזמינות עם פרמטרי language_code שלהן על ידי שליחת בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  דוגמה:
  en
- language_name
  סוג: string
  
  השם המלא של השפה
  שדה חובה אם לא מציינים language_code
  הערה: יש לציין language_name או language_code
  אפשר לקבל את רשימת השפות הזמינות עם פרמטרי language_name שלהן על ידי שליחת בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  דוגמה:
  English
- limit
  סוג: integer | null
  
  המספר המרבי של דומיינים מוחזרים
  שדה אופציונלי
  ערך ברירת מחדל: 100
  הערך המרבי: 1000
- location_code
  סוג: integer
  
  מזהה מיקום ייחודי
  שדה חובה אם לא מציינים location_name
  הערה: יש לציין location_name או location_code
  אפשר לקבל את רשימת המיקומים הזמינים עם פרמטרי location_code שלהם על ידי שליחת בקשה נפרדת אל
  https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages
  דוגמה:
  2840
- location_name
  סוג: string
  
  השם המלא של המיקום
  שדה חובה אם לא מציינים location_code
  הערה: יש לציין location_name או 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 - התוצאות ימוינו בסדר יורד
  הפסיק משמש כמפריד
  דוגמה:
  ["avg_position,asc"]
  כלל ברירת מחדל:
  ["rating,desc"]
  שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת
  יש להשתמש בפסיק כדי להפריד בין כמה כללי מיון
  דוגמה:
  ["avg_position,asc","etv,desc"]
- tag
  סוג: string | null
  
  מזהה משימה מוגדר על ידי המשתמש
  שדה אופציונלי
  מגבלת התווים היא 255
  אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה
  את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות

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

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

status_code
סוג: integer | null

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

status_message
סוג: string | null

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

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

מערך משימות

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

מכיל מתחרי SERP שזוהו ונתונים קשורים

avg_position
סוג: number | null פורמט: float

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

domain
סוג: string | null

שם הדומיין של מתחרה ה-SERP שזוהה

etv
סוג: number | null

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

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

מספר מילות המפתח שצוינו שלהן לדומיין יש מיקומים ב-SERP

keywords_positions
סוג: object | null

מיקומי מילות מפתח
מיקומי ה-SERP שהדומיין הקשור מחזיק ב-SERP עבור מילות המפתח שצוינו

propertyName
סוג: array (integer | null)[] | null
median_position
סוג: number | null

המיקום החציוני של הדומיין עבור מילות המפתח שצוינו
החציון של הערכים במערך keywords_positions

rating
סוג: number | null

הפער בין מיקומי מילות המפתח המקסימליים האפשריים למיקומים בפועל
מייצג את שיעור הנראות היחסי של הדומיין ב-SERP עבור מילות המפתח שצוינו
מחושב כ-sum(100-keywords_positions)

relevant_serp_items
סוג: integer | null

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

se_type
סוג: string | null

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

visibility
סוג: number | null

שיעור נראות ב-SERP
מייצג את שיעור הנראות של האתר בהתבסס על מיקומי ה-SERP של מילות המפתח שצוינו
מילות מפתח עם מיקומים בטווח 1 עד 10 מקבלות אינדקס נראות מ-1 עד 0.1, בהתאמה
למילות מפתח עם מיקומים בטווח 11 עד 20 יש אינדקס נראות קבוע של 0.05
למילות מפתח עם מיקומים מ-20 עד 100 יש אינדקס נראות השווה ל-0

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

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

language_code
סוג: string | null

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

location_code
סוג: integer | null

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

se_type
סוג: string | null

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

seed_keywords
סוג: array (string | null)[] | 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/dataforseo_labs/google/serp_competitors/live

curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/serp_competitors/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keywords": [
      "phone"
    ],
    "language_name": "English",
    "location_code": 2840,
    "item_types": [
      "organic"
    ],
    "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": [
        {
          "se_type": null,
          "seed_keywords": [
            null
          ],
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "domain": null,
              "avg_position": null,
              "median_position": null,
              "rating": null,
              "etv": null,
              "keywords_count": null,
              "visibility": null,
              "relevant_serp_items": null,
              "keywords_positions": null
            }
          ]
        }
      ]
    }
  ]
}

פעולה מוצלחת

מתחרי SERP

אימותRequired

DataForSEO

מתחרי SERP

מראה תמחור