Felo API PlatformFelo API Platform
כל ה-endpoints של DataForSEO
v0.2.0-beta
OpenAPI 3.1.0

LLM Mentions בזמן אמת

Felo API Support
MIT
שרת:https://openapi.felo.ai
ספריות לקוח
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO פעולות

LLM Mentions בזמן אמת

​

התשובות הבודדות שבהן עוזר הזכיר את היעד שלכם. מחזיר total_count, current_offset, search_after_token ו-items — דפדפו עם הטוקן, לא עם offset, אחרי הדפים הראשונים. ⚠️ target הוא מערך של אובייקטים, כל אחד {"domain": "..."} או {"keyword": "..."}; מחרוזת בודדת נדחית כסוג שגוי, ומערך של מחרוזות נדחה עם 'Each target item must be an object'. שדות הסינון מגיעים מ-get_dataforseo_ai_llm_mentions_available_filters. התגובה עטופה במעטפת של DataForSEO: הנתונים ב-tasks[0].result, והתוצאה ב-tasks[0].status_code — גם בקשה שנדחתה מחזירה HTTP 200. לספירות ולא לאזכורים עצמם השתמשו ב-post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

מראה תמחור

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

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

גוף
חובה
application/json
  • סוג: array object[]
    • target
      סוג: array object[]
      חובה

      מערך של אובייקטים המכילים ישויות יעד שדה חובה אפשר לציין עד 10 ישויות (אובייקטים) בשדה target ישות יעד אחת יכולה להכיל דומיין אחד או מילת מפתח אחת והפרמטרים הנלווים להם.דוגמאות: מערך target עם ישות דומיין [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] מערך target עם ישות מילת מפתח [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] מערך target עם כמה ישויות [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]

        • domain
          סוג: string
          חובה

          דומיין היעד שדה חובה אם לא מציינים keyword אפשר לציין עד 63 תווים בשדה domain; יש לציין דומיין בלי https:// ובלי www.

        • include_subdomains
          סוג: boolean

          מציין אם תתי-הדומיינים של דומיין היעד ייכללו בחיפוש שדה אופציונלי אם מוגדר ל-true, תתי-הדומיינים ייכללו בחיפוש ערך ברירת מחדל: false

        • keyword
          סוג: string

          מילת המפתח של היעד שדה חובה אם לא מציינים domain אפשר לציין עד 250 תווים בשדה keyword כל קידודי %## יפענחו (גם התו ‘+’ יפענח לרווח) אם אתם צריכים להשתמש בתו “%” ב-keyword, ציינו אותו כ-“%25”; אם אתם צריכים להשתמש בתו “+” ב-keyword, ציינו אותו כ-“%2B”. מידע נוסף על הכללים והמגבלות של השדות keyword ו-keywords ב-DataForSEO API מופיע במאמר מרכז העזרה הזה

        • match_type
          סוג: string

          סוג התאמת מילת מפתח יעד — מגדיר כיצד מילת המפתח שצוינה מותאמת. שדה אופציונלי. ערכים אפשריים: word_match — חיפוש טקסט מלא אחר מונחים התואמים את מילת המפתח המקורית שצוינה, עם מילים נוספות לפני, אחרי או בתוך הביטוי (למשל, חיפוש "light" יחזיר תוצאות עם "light bulb", "light switch"); partial_match — חיפוש תת-מחרוזת שמוצא כל מופע המכיל את רצף התווים שצוין, גם אם הוא מופיע בתוך מילה ארוכה יותר (למשל, חיפוש "light" יחזיר תוצאות עם "lighting", "highlight"); ערך ברירת מחדל: word_match.

        • search_filter
          סוג: string

          מסנן חיפוש הישויות: include או exclude; ברירת המחדל היא include.

        • search_scope
          סוג: array string[]

          היקף החיפוש. ישויות דומיין: any, sources, search_results. ישויות מילת מפתח: any, question, answer, brand_entities, fan_out_queries. ברירת מחדל: any.

    • filters
      סוג: array

      מערך פרמטרים לסינון תוצאות — שדה אופציונלי. אפשר להוסיף כמה מסננים בבת אחת (עד 8). יש להגדיר אופרטור לוגי and או or בין התנאים. האופרטורים הנתמכים: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. אפשר להשתמש באופרטור % עם like ו-not_like כדי להתאים כל מחרוזת של אפס תווים או יותר. דוגמה: ["ai_search_volume",">","1000"]. הרשימה המלאה של המסננים האפשריים זמינה כאן.

    • language_code
      סוג: string

      קוד שפת החיפוש שדה אופציונלי אם משתמשים בשדה הזה, אין צורך לציין language_name; אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_code שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages ערך ברירת מחדל: en הערה: נתוני chat_gpt זמינים רק עבור en

    • language_name
      סוג: string

      השם המלא של שפת החיפוש שדה אופציונלי אם משתמשים בשדה הזה, אין צורך לציין language_code; אם לא מציינים את השדה הזה, ייעשה שימוש ב-language_code עם הערך en כברירת מחדל; אפשר לקבל את רשימת השפות הזמינות של מנוע החיפוש עם language_name שלהן על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages הערה: נתוני chat_gpt זמינים רק באנגלית

    • limit
      סוג: integer

      מספר האובייקטים המרבי המוחזר. שדה אופציונלי. ערך ברירת מחדל: 100. ערך מרבי: 1000.

    • location_code
      סוג: integer

      קוד מיקום החיפוש שדה אופציונלי אם משתמשים בשדה הזה, אין צורך לציין location_name אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_code שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages ערך ברירת מחדל: 2840 הערה: נתוני chat_gpt זמינים רק עבור 2840

    • location_name
      סוג: string

      השם המלא של מיקום החיפוש שדה אופציונלי אם משתמשים בשדה הזה, אין צורך לציין location_code אם לא מציינים את השדה הזה, ייעשה שימוש ב-location_code עם הערך 2840 כברירת מחדל; אפשר לקבל את רשימת המיקומים הזמינים של מנוע החיפוש עם location_name שלהם על ידי שליחת בקשה נפרדת אל https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages הערה: נתוני chat_gpt זמינים רק עבור ארצות הברית

    • offset
      סוג: integer

      היסט במערך התוצאות של נתוני האזכורים המוחזרים. שדה אופציונלי. ערך ברירת מחדל: 0. דוגמה: אם מציינים את הערך 10, עשרת אובייקטי האזכורים הראשונים במערך התוצאות יושמטו והנתונים יסופקו עבור האובייקטים העוקבים; הערה: הערך המרבי הוא 9,000, השתמשו ב-search_after_token כדי להוסיף תוצאות בהיסט.

    • order_by
      סוג: array string[]

      כללי מיון תוצאות. שדה אופציונלי. אפשר להשתמש באותם ערכים כמו במערך filters כדי למיין את התוצאות. סוגי מיון אפשריים: asc — התוצאות ימוינו בסדר עולה; desc — התוצאות ימוינו בסדר יורד. יש להשתמש בפסיק כדי להגדיר סוג מיון. דוגמה: ["ai_search_volume,desc"]. שימו לב שלא ניתן להגדיר יותר משלושה כללי מיון בבקשה אחת, ויש להפריד בין כמה כללי מיון בפסיק.

    • platform
      סוג: string

      פלטפורמת היעד שדה אופציונלי ערכים אפשריים: chat_gpt, google ערך ברירת מחדל: google הערה: הנתונים המוחזרים תלויים בפלטפורמה שנבחרה הערה 2:נתוני chat_gpt זמינים רק עבור ארצות הברית ובאנגלית

    • search_after_token
      סוג: string

      טוקן לבקשות המשך. שדה אופציונלי. מסופק בשדה המקביל בתגובה לכל בקשה; השתמשו בפרמטר זה כדי להימנע מפסקי זמן בעת ניסיון לקבל יותר מ-20,000 תוצאות בבקשה אחת; ציון ערך search_after_token ייחודי ממערך התגובה יניב את תוצאות ההמשך של המשימה הראשונית. ערכי search_after_token ייחודיים לכל משימת המשך; הערה: אם search_after_token מצוין בבקשה, כל שאר הפרמטרים צריכים להיות זהים לבקשה הקודמת.

    • tag
      סוג: string

      מזהה משימה מוגדר על ידי המשתמש שדה אופציונלי מגבלת התווים היא 255 אפשר להשתמש בפרמטר הזה כדי לזהות את המשימה ולהתאים אותה לתוצאה את ערך ה-tag שציינתם תמצאו באובייקט data של התגובה

תגובות
  • 200
    סוג: object

    תגובה מוצלחת

    • cost
      סוג: number

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

    • status_code
      סוג: integer

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

    • status_message
      סוג: string

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

    • tasks
      סוג: array string[]

      מערך משימות

    • tasks_count
      סוג: integer

      מספר המשימות במערך tasks

    • tasks_error
      סוג: integer

      מספר המשימות במערך tasks שהוחזרו עם שגיאה

    • tasks.cost
      סוג: number

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

    • tasks.data
      סוג: object

      מכיל את אותם הפרמטרים שציינתם בבקשת POST

    • tasks.id
      סוג: string

      מזהה המשימה מזהה משימה ייחודי במערכת שלנו בפורמט UUID

    • tasks.path
      סוג: array string[]

      נתיב URL

    • tasks.result
      סוג: array string[]

      מערך תוצאות

    • tasks.result_count
      סוג: integer

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

    • tasks.result.current_offset
      סוג: integer

      מספר אובייקטי האזכורים המושמטים במערך items

    • tasks.result.items
      סוג: array string[]

      מכיל נתוני אזכורים רלוונטיים

    • tasks.result.items_count
      סוג: integer

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

    • tasks.result.items.ai_search_volume
      סוג: integer

      שיעור נפח החיפוש הנוכחי ב-AI של מילת מפתח מידע נוסף על המדד הזה כאן

    • tasks.result.items.answer
      סוג: string

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

    • tasks.result.items.brand_entities
      סוג: array string[]

      מערך ישויות מותגים — מכיל מידע על מותגים המוזכרים בתגובה

    • tasks.result.items.brand_entities.category
      סוג: string

      קטגוריית המותג

    • tasks.result.items.brand_entities.position
      סוג: integer

      המיקום בתוצאות

    • tasks.result.items.brand_entities.title
      סוג: string

      שם המותג

    • tasks.result.items.fan_out_queries
      סוג: array string[]

      מערך שאילתות הסתעפות — מכיל שאילתות חיפוש קשורות הנגזרות מהשאילתה הראשית כדי לספק תגובה מקיפה יותר

    • tasks.result.items.first_response_at
      סוג: string

      התאריך והשעה שבהם נתוני התגובה נרשמו לראשונה בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”. דוגמה: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.language_code
      סוג: string

      קוד שפה במערך POST

    • tasks.result.items.last_response_at
      סוג: string

      התאריך והשעה שבהם נתוני התגובה עודכנו לאחרונה בפורמט UTC: “yyyy-mm-dd hh-mm-ss +00:00”. דוגמה: 2025-10-21 06:25:30 +00:00

    • tasks.result.items.location_code
      סוג: integer

      קוד מיקום במערך POST

    • tasks.result.items.model_name
      סוג: string

      שם מודל ה-AI שממנו נשלפו הנתונים. הערה: עבור סוג הפלטפורמה google, הערך תמיד google_ai_overview

    • tasks.result.items.monthly_searches
      סוג: array string[]

      שיעורי נפח חיפוש AI חודשיים — מערך אובייקטים עם שיעורי נפח חיפוש AI בחודש מסוים בשנה

    • tasks.result.items.monthly_searches.month
      סוג: integer

      חודש

    • tasks.result.items.monthly_searches.search_volume
      סוג: integer

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

    • tasks.result.items.monthly_searches.year
      סוג: integer

      שנה

    • tasks.result.items.platform
      סוג: string

      הפלטפורמה שהתקבלה במערך POST

    • tasks.result.items.question
      סוג: string

      שאלה רלוונטית

    • tasks.result.items.search_results
      סוג: array string[]

      מערך תוצאות חיפוש — כל פלטי חיפוש האינטרנט שהמודל אחזר בעת חיפוש מידע, כולל כפילויות ורשומות שלא נעשה בהן שימוש

    • tasks.result.items.search_results.breadcrumb
      סוג: string

      נתיב ניווט (breadcrumb)

    • tasks.result.items.search_results.description
      סוג: string

      תיאור התוצאה

    • tasks.result.items.search_results.domain
      סוג: string

      דומיין התוצאה

    • tasks.result.items.search_results.position
      סוג: integer

      המיקום בתוצאות

    • tasks.result.items.search_results.publication_date
      סוג: string

      התאריך והשעה שבהם התוצאה פורסמה, בפורמט: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. דוגמה: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.search_results.title
      סוג: string

      כותרת התוצאה

    • tasks.result.items.search_results.url
      סוג: string

      כתובת ה-URL של התוצאה

    • tasks.result.items.sources
      סוג: array string[]

      מערך מקורות — המקורות שהמודל ציטט או הסתמך עליהם בתשובתו הסופית

    • tasks.result.items.sources.domain
      סוג: string

      דומיין המקור

    • tasks.result.items.sources.markdown
      סוג: string

      תוכן הרכיב בפורמט markdown — תוכן התוצאה מעוצב בשפת הסימון markdown

    • tasks.result.items.sources.position
      סוג: integer

      המיקום בתוצאות

    • tasks.result.items.sources.publication_date
      סוג: string

      התאריך והשעה שבהם התוצאה פורסמה, בפורמט: “year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes”. דוגמה: 2019-11-15 12:57:46 +00:00

    • tasks.result.items.sources.snippet
      סוג: string

      תיאור המקור

    • tasks.result.items.sources.source_name
      סוג: string

      שם המקור

    • tasks.result.items.sources.thumbnail
      סוג: string

      תמונה ממוזערת של המקור

    • tasks.result.items.sources.title
      סוג: string

      כותרת המקור

    • tasks.result.items.sources.url
      סוג: string

      כתובת ה-URL של המקור

    • tasks.result.search_after_token
      סוג: string

      טוקן לבקשות המשך — ציון search_after_token ייחודי בעת הגדרת משימה חדשה יניב את תוצאות ההמשך של המשימה הראשונית; ערכי search_after_token ייחודיים לכל משימת המשך

    • tasks.result.total_count
      סוג: integer

      סך כל התוצאות הרלוונטיות לבקשה

    • tasks.status_code
      סוג: integer

      קוד הסטטוס של המשימה שנוצר על ידי DataForSEO; יכול להיות בטווח הבא: 10000-60000 את הרשימה המלאה של קודי התגובה אפשר למצוא כאן

    • tasks.status_message
      סוג: string

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

    • tasks.time
      סוג: string

      זמן ביצוע, בשניות

    • time
      סוג: string

      זמן ביצוע, בשניות

    • version
      סוג: string

      הגרסה הנוכחית של ה-API

    application/json
  • 400

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

  • 401

    נדרש מפתח API תקף של Felo.

  • 402

    לא ניתן להמשיך את הבקשה משום שדרישת חיוב אינה מתקיימת.

  • 403

    החשבון אינו מורשה לבצע את הפעולה הזו.

  • 429

    הגעתם למגבלת בקשות או לתקרת הוצאה.

  • 502

    השירות לא הצליח להשלים את הבקשה.

  • 503

    שירות ה-API או החיוב אינו זמין באופן זמני.

  • 504

    השירות פג בזמן הטיפול בבקשה.

  • default

    תגובת שגיאה; תגובות מעבר מהמעלה הזרם עשויות להשתמש בפורמטים של הספק

    application/json
Request Example for post/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/search/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {}
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "filters": [],
    "order_by": [
      ""
    ],
    "offset": 1,
    "search_after_token": "",
    "limit": 1,
    "tag": ""
  }
]'

{
  "version": "string",
  "status_code": 1,
  "status_message": "string",
  "time": "string",
  "cost": 1,
  "tasks_count": 1,
  "tasks_error": 1,
  "tasks": [
    "string"
  ],
  "tasks.id": "string",
  "tasks.status_code": 1,
  "tasks.status_message": "string",
  "tasks.time": "string",
  "tasks.cost": 1,
  "tasks.result_count": 1,
  "tasks.path": [
    "string"
  ],
  "tasks.data": {},
  "tasks.result": [
    "string"
  ],
  "tasks.result.total_count": 1,
  "tasks.result.current_offset": 1,
  "tasks.result.search_after_token": "string",
  "tasks.result.items_count": 1,
  "tasks.result.items": [
    "string"
  ],
  "tasks.result.items.platform": "string",
  "tasks.result.items.model_name": "string",
  "tasks.result.items.location_code": 1,
  "tasks.result.items.language_code": "string",
  "tasks.result.items.question": "string",
  "tasks.result.items.answer": "string",
  "tasks.result.items.sources": [
    "string"
  ],
  "tasks.result.items.sources.snippet": "string",
  "tasks.result.items.sources.source_name": "string",
  "tasks.result.items.sources.thumbnail": "string",
  "tasks.result.items.sources.markdown": "string",
  "tasks.result.items.sources.position": 1,
  "tasks.result.items.sources.title": "string",
  "tasks.result.items.sources.domain": "string",
  "tasks.result.items.sources.url": "string",
  "tasks.result.items.sources.publication_date": "string",
  "tasks.result.items.search_results": [
    "string"
  ],
  "tasks.result.items.search_results.description": "string",
  "tasks.result.items.search_results.breadcrumb": "string",
  "tasks.result.items.search_results.position": 1,
  "tasks.result.items.search_results.title": "string",
  "tasks.result.items.search_results.domain": "string",
  "tasks.result.items.search_results.url": "string",
  "tasks.result.items.search_results.publication_date": "string",
  "tasks.result.items.ai_search_volume": 1,
  "tasks.result.items.monthly_searches": [
    "string"
  ],
  "tasks.result.items.monthly_searches.year": 1,
  "tasks.result.items.monthly_searches.month": 1,
  "tasks.result.items.monthly_searches.search_volume": 1,
  "tasks.result.items.first_response_at": "string",
  "tasks.result.items.last_response_at": "string",
  "tasks.result.items.brand_entities": [
    "string"
  ],
  "tasks.result.items.brand_entities.position": 1,
  "tasks.result.items.brand_entities.title": "string",
  "tasks.result.items.brand_entities.category": "string",
  "tasks.result.items.fan_out_queries": [
    "string"
  ]
}

תגובה מוצלחת

Live LLM Mentions