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 ו-items. ⚠️ 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_search_live מציג את התשובות שמאחוריו, ו-post_dataforseo_ai_llm_mentions_cross_metrics_live משווה כמה יעדים בבת אחת.

מראה תמחור

  • מדידה: עלות תגובה מדווחת.
  • אומדן בקשת ייחוס: 0.101 דולר ארה״ב.
  • מכפיל לקוח לייחוס: 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, partial_match ערך ברירת מחדל: 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.

    • initial_dataset_filters
      סוג: array

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

    • internal_list_limit
      סוג: integer

      המספר המרבי של פריטים במערכים פנימיים שדה אופציונלי אפשר להשתמש בשדה הזה כדי להגביל את מספר הפריטים במערכים הבאים: sources_domain search_results_domain הערך המזערי: 1 הערך המרבי: 20 ערך ברירת מחדל: 10

    • 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 זמינים רק באנגלית

    • 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 זמינים רק עבור ארצות הברית

    • platform
      סוג: string

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

    • 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.items
      סוג: array string[]

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

    • tasks.result.total
      סוג: object

      סיכום מדדי אזכורים מצטברים מכיל מדדי אזכורי LLM מצטברים ברמה הכללית על פני כל הדומיינים שנמצאו, מקובצים לפי ממדים שונים

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

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

    • tasks.result.total.brand_entities_category.ai_search_volume
      סוג: integer

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

    • tasks.result.total.brand_entities_category.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.brand_entities_category.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ במקרה הזה השדה מציג קטגוריית ישות מותג שנמצאה

    • tasks.result.total.brand_entities_category.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס לדומיין הספציפי

    • tasks.result.total.brand_entities_category.type
      סוג: string

      סוג הפריט = 'group_element'

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

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

    • tasks.result.total.brand_entities_title.ai_search_volume
      סוג: integer

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

    • tasks.result.total.brand_entities_title.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.brand_entities_title.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ במקרה הזה השדה מציג שם של ישות מותג שנמצאה

    • tasks.result.total.brand_entities_title.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס לדומיין הספציפי

    • tasks.result.total.brand_entities_title.type
      סוג: string

      סוג הפריט = 'group_element'

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

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

    • tasks.result.total.language.ai_search_volume
      סוג: integer

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

    • tasks.result.total.language.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.language.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ

    • tasks.result.total.language.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס למפתח הקיבוץ הספציפי הזה

    • tasks.result.total.language.type
      סוג: string

      סוג הפריט = 'group_element'

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

      קיבוץ לפי מיקום מערך של אובייקטים שמכילים מדדי אזכורים מחולקים לפי מיקום גיאוגרפי

    • tasks.result.total.location.ai_search_volume
      סוג: integer

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

    • tasks.result.total.location.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.location.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ

    • tasks.result.total.location.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס למפתח הקיבוץ הספציפי הזה

    • tasks.result.total.location.type
      סוג: string

      סוג הפריט = 'group_element'

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

      קיבוץ לפי פלטפורמה מערך של פריטי קיבוץ שמכילים מדדי אזכורים מחולקים לפי פלטפורמת AI

    • tasks.result.total.platform.ai_search_volume
      סוג: integer

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

    • tasks.result.total.platform.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.platform.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ

    • tasks.result.total.platform.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס למפתח הקיבוץ הספציפי הזה

    • tasks.result.total.platform.type
      סוג: string

      סוג הפריט = 'group_element'

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

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

    • tasks.result.total.search_results_domain.ai_search_volume
      סוג: integer

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

    • tasks.result.total.search_results_domain.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.search_results_domain.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ במקרה הזה השדה מציג שם דומיין שנמצא

    • tasks.result.total.search_results_domain.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס לדומיין הספציפי

    • tasks.result.total.search_results_domain.type
      סוג: string

      סוג הפריט = 'group_element'

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

      דומיינים מובילים של מקורות שנמצאו ורלוונטיים ליעד מערך של אובייקטים שמכילים נתונים על הדומיינים המובילים שמצוטטים כמקורות בתגובות LLM

    • tasks.result.total.sources_domain.ai_search_volume
      סוג: integer

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

    • tasks.result.total.sources_domain.impressions
      סוג: integer

      שיעור החשיפות הנוכחי ב-AI של מילת מפתח

    • tasks.result.total.sources_domain.key
      סוג: string

      מזהה הקיבוץ המזהה הספציפי של ממד הקיבוץ במקרה הזה השדה מציג שם דומיין שנמצא

    • tasks.result.total.sources_domain.mentions
      סוג: integer

      סך אזכורי LLM מספר הפעמים שמילת המפתח או הדומיין של היעד הוזכרו ביחס לדומיין הספציפי

    • tasks.result.total.sources_domain.type
      סוג: string

      סוג הפריט = 'group_element'

    • 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/aggregated_metrics/live
curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "target": [
      {
        "domain": "en.wikipedia.org"
      }
    ]
  }
]'

{
  "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": {},
  "tasks.result.total.location": [
    "string"
  ],
  "tasks.result.total.location.type": "string",
  "tasks.result.total.location.key": "string",
  "tasks.result.total.location.mentions": 1,
  "tasks.result.total.location.ai_search_volume": 1,
  "tasks.result.total.location.impressions": 1,
  "tasks.result.total.language": [
    "string"
  ],
  "tasks.result.total.language.type": "string",
  "tasks.result.total.language.key": "string",
  "tasks.result.total.language.mentions": 1,
  "tasks.result.total.language.ai_search_volume": 1,
  "tasks.result.total.language.impressions": 1,
  "tasks.result.total.platform": [
    "string"
  ],
  "tasks.result.total.platform.type": "string",
  "tasks.result.total.platform.key": "string",
  "tasks.result.total.platform.mentions": 1,
  "tasks.result.total.platform.ai_search_volume": 1,
  "tasks.result.total.platform.impressions": 1,
  "tasks.result.total.sources_domain": [
    "string"
  ],
  "tasks.result.total.sources_domain.type": "string",
  "tasks.result.total.sources_domain.key": "string",
  "tasks.result.total.sources_domain.mentions": 1,
  "tasks.result.total.sources_domain.ai_search_volume": 1,
  "tasks.result.total.sources_domain.impressions": 1,
  "tasks.result.total.search_results_domain": [
    "string"
  ],
  "tasks.result.total.search_results_domain.type": "string",
  "tasks.result.total.search_results_domain.key": "string",
  "tasks.result.total.search_results_domain.mentions": 1,
  "tasks.result.total.search_results_domain.ai_search_volume": 1,
  "tasks.result.total.search_results_domain.impressions": 1,
  "tasks.result.total.brand_entities_title": [
    "string"
  ],
  "tasks.result.total.brand_entities_title.type": "string",
  "tasks.result.total.brand_entities_title.key": "string",
  "tasks.result.total.brand_entities_title.mentions": 1,
  "tasks.result.total.brand_entities_title.ai_search_volume": 1,
  "tasks.result.total.brand_entities_title.impressions": 1,
  "tasks.result.total.brand_entities_category": [
    "string"
  ],
  "tasks.result.total.brand_entities_category.type": "string",
  "tasks.result.total.brand_entities_category.key": "string",
  "tasks.result.total.brand_entities_category.mentions": 1,
  "tasks.result.total.brand_entities_category.ai_search_volume": 1,
  "tasks.result.total.brand_entities_category.impressions": 1,
  "tasks.result.items": [
    "string"
  ]
}

תגובה מוצלחת

Live LLM Mentions Aggregated Metrics