v0.2.0-beta

OpenAPI 3.1.0

Live-LLM-Mentions – aggregierte Metriken

Felo API Support

MIT

Server

https://openapi.felo.ai

Client-Bibliotheken

Shell Curl

DataForSEO

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

DataForSEO Operationen

post/v1/beta/dataforseo/ai_optimization/llm_mentions/aggregated_metrics/live

Live-LLM-Mentions – aggregierte Metriken

Wie oft Assistenten Ihr Ziel erwähnen, als Summen statt einzelner Antworten: total und items. ⚠️ target ist ein Array von Objekten, jeweils {"domain": "..."} oder {"keyword": "..."}; ein bloßer String wird als falscher Typ abgelehnt und ein Array aus Strings mit 'Each target item must be an object'. Filterfelder stammen aus get_dataforseo_ai_llm_mentions_available_filters. Eingebettet in die DataForSEO-Hülle: Daten in tasks[0].result, Ergebnis in tasks[0].status_code – eine abgelehnte Anfrage gibt dennoch HTTP 200 zurück. Dies ist die zentrale Sichtbarkeitskennzahl; post_dataforseo_ai_llm_mentions_search_live zeigt die Antworten dahinter, und post_dataforseo_ai_llm_mentions_cross_metrics_live vergleicht mehrere Ziele auf einmal.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.101.
Referenz-Kundenmultiplikator: 1.0. Nicht erneut auf einen bereits abgerechneten Kundenbetrag anwenden.

Nur Referenzmetadaten, kein Kontenangebot, kein garantierter Preis und keine Ausgabenobergrenze. Ressourcen-Credits sind keine Felo-Credits. Endgültige Abrechnungen richten sich nach den Felo-Abrechnungsbelegen.

Body

erforderlich

application/json

Typ: array object[]
- target
  Typ: array object[]
  erforderlich
  
  Array aus Objekten mit Ziel-Entitäten. Pflichtfeld. Im Feld target können Sie bis zu 10 Entitäten (Objekte) angeben. Eine Ziel-Entität kann entweder eine Domain oder ein Keyword samt zugehörigen Parametern enthalten. Beispiele: target-Array mit einer Domain-Entität [{"domain": "en.wikipedia.org", "search_filter": "exclude"}] target-Array mit einer Keyword-Entität [{"keyword": "bmw", "search_scope": ["question"], "match_type ": "partial_match"}] target-Array mit mehreren Entitäten [{"domain": "en.wikipedia.org", "search_filter": "exclude"}, {"keyword": "bmw", "match_type ": "partial_match", "search_scope": ["answer"]}]
  
  domain
  Typ: string
  erforderlich
  
  Ziel-Domain. Pflichtfeld, wenn Sie kein keyword angeben. Im Feld domain können Sie bis zu 63 Zeichen angeben; eine Domain sollte ohne https:// und www. angegeben werden.
  
  include_subdomains
  Typ: boolean
  
  Gibt an, ob die Subdomains der Ziel-Domain in die Suche einbezogen werden. Optionales Feld. Wenn auf true gesetzt, werden die Subdomains in die Suche einbezogen. Standardwert: false.
  
  keyword
  Typ: string
  
  Ziel-Keyword. Pflichtfeld, wenn Sie keine domain angeben. Im Feld keyword können Sie bis zu 250 Zeichen angeben. Alle %## werden dekodiert (das Zeichen ‘+’ wird zudem in ein Leerzeichen dekodiert). Wenn Sie das Zeichen “%” für Ihr keyword verwenden müssen, geben Sie es als “%25” an; wenn Sie das Zeichen “+” für Ihr keyword verwenden müssen, geben Sie es als “%2B” an. Weitere Informationen zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs finden Sie in diesem Help-Center-Artikel.
  
  match_type
  Typ: string
  
  Übereinstimmungstyp des Ziel-Keywords. Optionales Feld. word_match – Volltextsuche nach Begriffen, die dem angegebenen Seed-Keyword entsprechen, mit zusätzlichen Wörtern davor, danach oder innerhalb der Schlüsselphrase (z. B. liefert die Suche nach “light” Ergebnisse mit “light bulb”, “light switch”); partial_match – Teilstringsuche, die alle Vorkommen der angegebenen Zeichenfolge findet, auch wenn sie in einem längeren Wort vorkommt (z. B. liefert die Suche nach “light” Ergebnisse mit “lighting”, “highlight”); mögliche Werte: word_match, partial_match. Standardwert: word_match.
  
  search_filter
  Typ: string
  
  Entitätssuchfilter: include oder exclude; Standard ist include.
  
  search_scope
  Typ: array string[]
  
  Suchbereich. Domain-Entitäten: any, sources, search_results. Keyword-Entitäten: any, question, answer, brand_entities, fan_out_queries. Standard: any.
- initial_dataset_filters
  Typ: array
  
  Array von Filterausdrücken, die vor der Aggregation angewendet werden. Optionales Feld. Sie können dieses Array verwenden, um Ausdrücke zu filtern, die vor der Aggregation auf die Rohdatenbank der Erwähnungen angewendet werden, um die zum Ergebnis beitragenden Zeilen zu begrenzen; Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter). Zwischen den Bedingungen sollten Sie einen logischen Operator and oder or setzen. Die folgenden Operatoren werden unterstützt: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Mit like und not_like können Sie den Operator % verwenden, um beliebige Zeichenfolgen mit null oder mehr Zeichen abzugleichen. Beispiel: ["ai_search_volume",">","1000"]. Die vollständige Liste der möglichen Filter ist hier verfügbar. Weitere Informationen zu den Filtern des initialen Datensatzes finden Sie in diesem Help-Center-Artikel.
- internal_list_limit
  Typ: integer
  
  Maximale Anzahl von Elementen in internen Arrays. Optionales Feld. Mit diesem Feld können Sie die Anzahl der Elemente in den folgenden Arrays begrenzen: sources_domain, search_results_domain. Mindestwert: 1. Höchstwert: 20. Standardwert: 10.
- language_code
  Typ: string
  
  Sprachcode der Suche. Optionales Feld. Wenn Sie dieses Feld verwenden, müssen Sie language_name nicht angeben; die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Standardwert: en. Hinweis: chat_gpt-Daten sind nur für en verfügbar.
- language_name
  Typ: string
  
  Vollständiger Name der Suchsprache. Optionales Feld. Wenn Sie dieses Feld verwenden, müssen Sie language_code nicht angeben; wenn Sie dieses Feld nicht angeben, wird standardmäßig der language_code mit dem Wert en verwendet; die Liste der verfügbaren Sprachen der Suchmaschine mit ihrem language_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Hinweis: chat_gpt-Daten sind nur für Englisch verfügbar.
- location_code
  Typ: integer
  
  Standortcode der Suche. Optionales Feld. Wenn Sie dieses Feld verwenden, müssen Sie location_name nicht angeben. Die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_code erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Standardwert: 2840. Hinweis: chat_gpt-Daten sind nur für 2840 verfügbar.
- location_name
  Typ: string
  
  Vollständiger Name des Suchstandorts. Optionales Feld. Wenn Sie dieses Feld verwenden, müssen Sie location_code nicht angeben. Wenn Sie dieses Feld nicht angeben, wird standardmäßig der location_code mit dem Wert 2840 verwendet; die Liste der verfügbaren Standorte der Suchmaschine mit ihrem location_name erhalten Sie durch eine separate Anfrage an https://api.dataforseo.com/v3/ai_optimization/llm_mentions/locations_and_languages. Hinweis: chat_gpt-Daten sind nur für die Vereinigten Staaten verfügbar.
- platform
  Typ: string
  
  Zielplattform. Optionales Feld. Mögliche Werte: chat_gpt, google. Standardwert: google. Hinweis: Die zurückgegebenen Daten hängen von der ausgewählten Plattform ab. Hinweis Nr. 2: chat_gpt-Daten sind nur für die Vereinigten Staaten und Englisch verfügbar.
- tag
  Typ: string
  
  Benutzerdefinierte Aufgaben-ID. Optionales Feld. Das Zeichenlimit beträgt 255. Mit diesem Parameter können Sie die Aufgabe identifizieren und dem Ergebnis zuordnen. Den angegebenen Wert tag finden Sie im data-Objekt der Antwort.

Antworten

200
Typ: object

Erfolgreiche Antwort
cost
Typ: number

Gesamtkosten der Aufgaben in USD

status_code
Typ: integer

Allgemeiner Statuscode. Die vollständige Liste der Antwortcodes finden Sie hier. Hinweis: Wir empfehlen dringend, ein geeignetes System zur Behandlung zugehöriger Ausnahme- oder Fehlerbedingungen zu entwickeln.

status_message
Typ: string

Allgemeine Informationsmeldung. Die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier.

tasks
Typ: array string[]

Array der Aufgaben

tasks_count
Typ: integer

Die Anzahl der Aufgaben im tasks-Array

tasks_error
Typ: integer

Die Anzahl der Aufgaben im tasks-Array, die mit einem Fehler zurückgegeben wurden

tasks.cost
Typ: number

Kosten der Aufgabe in USD

tasks.data
Typ: object

Enthält dieselben Parameter, die Sie in der POST-Anfrage angegeben haben

tasks.id
Typ: string

Aufgaben-ID. Eindeutige Aufgaben-ID in unserem System im UUID-Format.

tasks.path
Typ: array string[]

URL-Pfad

tasks.result
Typ: array string[]

Array der Ergebnisse

tasks.result_count
Typ: integer

Anzahl der Elemente im Ergebnis-Array

tasks.result.items
Typ: array string[]

Ergebnis-Array einzelner Seiten mit detaillierten Erwähnungsmetriken für jede der gefundenen Top-Seiten; in diesem Fall gleich null

tasks.result.total
Typ: object

Zusammenfassung der aggregierten Erwähnungsmetriken. Enthält die insgesamt aggregierten LLM-Erwähnungsmetriken über alle gefundenen Domains, gruppiert nach verschiedenen Dimensionen.

tasks.result.total.brand_entities_category
Typ: array string[]

Daten zu Markenentitäten, die für das Ziel relevant sind. Array aus Objekten mit Daten zu Kategorien von Markenentitäten, die in Suchergebnissen zu LLM-Abfragen erscheinen.

tasks.result.total.brand_entities_category.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.brand_entities_category.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.brand_entities_category.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension. In diesem Fall zeigt das Feld eine gefundene Kategorie der Markenentität an.

tasks.result.total.brand_entities_category.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf die spezifische Domain erwähnt wurden.

tasks.result.total.brand_entities_category.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.brand_entities_title
Typ: array string[]

Daten zu Markenentitäten, die für das Ziel relevant sind. Array aus Objekten mit Daten zu Titeln von Markenentitäten, die in Suchergebnissen zu LLM-Abfragen erscheinen.

tasks.result.total.brand_entities_title.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.brand_entities_title.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.brand_entities_title.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension. In diesem Fall zeigt das Feld einen gefundenen Titel der Markenentität an.

tasks.result.total.brand_entities_title.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf die spezifische Domain erwähnt wurden.

tasks.result.total.brand_entities_title.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.language
Typ: array string[]

Sprachbasierte Gruppierung. Array aus Objekten mit Erwähnungsmetriken, segmentiert nach Inhaltssprache.

tasks.result.total.language.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.language.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.language.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.total.language.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf diesen spezifischen Gruppierungsschlüssel erwähnt wurden.

tasks.result.total.language.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.location
Typ: array string[]

Standortbasierte Gruppierung. Array aus Objekten mit Erwähnungsmetriken, segmentiert nach geografischem Standort.

tasks.result.total.location.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.location.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.location.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.total.location.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf diesen spezifischen Gruppierungsschlüssel erwähnt wurden.

tasks.result.total.location.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.platform
Typ: array string[]

Plattformbasierte Gruppierung. Array aus Gruppenelementen mit Erwähnungsmetriken, segmentiert nach AI-Plattform.

tasks.result.total.platform.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.platform.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.platform.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.total.platform.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf diesen spezifischen Gruppierungsschlüssel erwähnt wurden.

tasks.result.total.platform.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.search_results_domain
Typ: array string[]

Gefundene Top-Domains der Suchergebnisse, die für das Ziel relevant sind. Array aus Objekten mit Daten zu Top-Domains, die in Suchergebnissen zu LLM-Abfragen erscheinen.

tasks.result.total.search_results_domain.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.search_results_domain.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.search_results_domain.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension. In diesem Fall zeigt das Feld einen gefundenen Domainnamen an.

tasks.result.total.search_results_domain.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf die spezifische Domain erwähnt wurden.

tasks.result.total.search_results_domain.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.total.sources_domain
Typ: array string[]

Gefundene Top-Quelldomains, die für das Ziel relevant sind. Array aus Objekten mit Daten zu Top-Domains, die als Quellen in LLM-Antworten zitiert werden.

tasks.result.total.sources_domain.ai_search_volume
Typ: integer

Aktuelles AI-Suchvolumen eines Keywords. Weitere Informationen zu dieser Metrik finden Sie hier.

tasks.result.total.sources_domain.impressions
Typ: integer

Aktuelle AI-Impressionen eines Keywords

tasks.result.total.sources_domain.key
Typ: string

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension. In diesem Fall zeigt das Feld einen gefundenen Domainnamen an.

tasks.result.total.sources_domain.mentions
Typ: integer

Gesamtzahl der LLM-Erwähnungen. Die Anzahl der Male, die das Ziel-Keyword oder die Ziel-Domain in Bezug auf die spezifische Domain erwähnt wurden.

tasks.result.total.sources_domain.type
Typ: string

Typ des Elements = 'group_element'

tasks.status_code
Typ: integer

Statuscode der von DataForSEO generierten Aufgabe; kann im folgenden Bereich liegen: 10000-60000. Die vollständige Liste der Antwortcodes finden Sie hier.

tasks.status_message
Typ: string

Informationsmeldung der Aufgabe. Die vollständige Liste der allgemeinen Informationsmeldungen finden Sie hier.

tasks.time
Typ: string

Ausführungszeit in Sekunden

time
Typ: string

Ausführungszeit in Sekunden

version
Typ: string

Die aktuelle Version der API
application/json
400

Die Anfrage konnte nicht verarbeitet werden. Prüfen Sie die Anfrageparameter.
401

Ein gültiger Felo-API-Schlüssel ist erforderlich.
402

Die Anfrage kann nicht fortgesetzt werden, da eine Abrechnungsvoraussetzung nicht erfüllt ist.
403

Das Konto ist für diesen Vorgang nicht berechtigt.
429

Ein Anfrage- oder Ausgabenlimit wurde erreicht.
502

Der Dienst konnte die Anfrage nicht abschließen.
503

Die API oder der Abrechnungsdienst ist vorübergehend nicht verfügbar.
504

Beim Verarbeiten der Anfrage ist eine Zeitüberschreitung aufgetreten.
default

Fehlerantwort; Upstream-Passthrough-Antworten können Anbieterformate verwenden

application/json

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"
      }
    ]
  }
]'

Schema anzeigen

{
  "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"
  ]
}

Erfolgreiche Antwort

Live-LLM-Mentions – aggregierte Metriken

AuthentifizierungRequired

DataForSEO

Live-LLM-Mentions – aggregierte Metriken

Preisreferenz