v0.2.0-beta

OpenAPI 3.1.0

Live-LLM-Mentions – aggregierte Metriken über mehrere Ziele

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

Live-LLM-Mentions – aggregierte Metriken über mehrere Ziele

Vergleicht Erwähnungsmetriken über mehrere Ziele in einem Aufruf, gruppiert nach aggregation_key. Nimmt targets als Liste von Ziel-Arrays entgegen statt des einzelnen target seiner Geschwister – die Formen unterscheiden sich, und eine Verwechslung wird als unbekanntes Feld abgelehnt. ⚠️ 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. post_dataforseo_ai_llm_mentions_aggregated_metrics_live einmal pro Ziel auszuführen kostet pro Aufruf dasselbe, daher verwenden Sie dies, wenn es auf den Vergleich selbst ankommt.

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[]
- targets
  Typ: array object[]
  erforderlich
  
  Array aus Objekten mit Ziel-Entitäten und Aggregationsschlüsseln. Pflichtfeld. Sie können bis zu 10, aber nicht weniger als 2 Zielparametersätze angeben, jeweils mit ihrem aggregation_key; Beispiel für ein targets-Array mit mehreren Entitäten: [{"aggregation_key":"bmw","target":[{"domain":"en.wikipedia.org","search_filter":"exclude"},{"keyword":"m5","match_type":"partial_match","search_scope":["answer"]}]},{"aggregation_key":"mercedes","target":[{"domain":"www.mercedes-benz.com","search_filter":"exclude"},{"keyword":"GLC","match_type":"word_match"}]}]
  
  aggregation_key
  Typ: string
  erforderlich
  
  Aggregationsschlüssel für die Gruppierung der Ergebnisse. Pflichtfeld. Gruppiert Ergebnisse für den Vergleich und dient als Bezeichnung für die Gruppe; im Feld aggregation_key können Sie bis zu 250 Zeichen angeben.
  
  target
  Typ: array object[]
  erforderlich
  
  Array aus Objekten mit Ziel-Entitäten. Pflichtfeld. Ein einzelnes Ziel kann bis zu 10 Domain- und/oder Keyword-Entitäten enthalten.
  
  domain
  Typ: string
  erforderlich
  
  Zieldomain. 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 zusätzlich in ein Leerzeichen dekodiert). Wenn Sie das Zeichen „%“ für Ihr Keyword benötigen, geben Sie es als „%25“ an; wenn Sie das Zeichen „+“ benötigen, geben Sie es als „%2B“ an. Mehr zu Regeln und Einschränkungen der Felder keyword und keywords in DataForSEO-APIs erfahren Sie in diesem Help-Center-Artikel.
  
  match_type
  Typ: string
  
  Ziel-Keyword-Übereinstimmungstyp; definiert, wie das angegebene Keyword abgeglichen wird. Optionales Feld. Mögliche Werte: word_match – Volltextsuche nach Begriffen, die dem angegebenen Seed-Keyword entsprechen, wobei zusätzliche Wörter vor, nach oder innerhalb der Schlüsselphrase enthalten sein können (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 enthalten ist (z. B. liefert die Suche nach „light“ Ergebnisse mit „lighting“, „highlight“); 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: 10. Standardwert: 5.
- 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[]

Enthält relevante Erwähnungsdaten

tasks.result.items.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.items.brand_entities_category.ai_search_volume
Typ: integer

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

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

Aktuelle AI-Impressionen eines Keywords

tasks.result.items.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.items.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.items.brand_entities_category.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.items.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.items.brand_entities_title.ai_search_volume
Typ: integer

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

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

Aktuelle AI-Impressionen eines Keywords

tasks.result.items.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.items.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.items.brand_entities_title.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.items.key
Typ: string

Aggregationsschlüssel, empfangen in einem POST-Array

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

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

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

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

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

Aktuelle AI-Impressionen eines Keywords

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

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.items.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.items.language.type
Typ: string

Typ des Elements = 'group_element'

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

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

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

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

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

Aktuelle AI-Impressionen eines Keywords

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

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.items.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.items.location.type
Typ: string

Typ des Elements = 'group_element'

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

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

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

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

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

Aktuelle AI-Impressionen eines Keywords

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

Gruppierungsbezeichner. Der spezifische Bezeichner für die Gruppierungsdimension.

tasks.result.items.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.items.platform.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.items.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.items.search_results_domain.ai_search_volume
Typ: integer

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

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

Aktuelle AI-Impressionen eines Keywords

tasks.result.items.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.items.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.items.search_results_domain.type
Typ: string

Typ des Elements = 'group_element'

tasks.result.items.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.items.sources_domain.ai_search_volume
Typ: integer

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

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

Aktuelle AI-Impressionen eines Keywords

tasks.result.items.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.items.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.items.sources_domain.type
Typ: string

Typ des Elements = 'group_element'

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

curl https://openapi.felo.ai/v1/beta/dataforseo/ai_optimization/llm_mentions/cross_aggregated_metrics/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "targets": [
      {
        "aggregation_key": "",
        "target": [
          {}
        ]
      }
    ],
    "location_name": "",
    "location_code": 1,
    "language_name": "",
    "language_code": "",
    "platform": "",
    "initial_dataset_filters": [],
    "internal_list_limit": 1,
    "tag": ""
  }
]'

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

Erfolgreiche Antwort

Live-LLM-Mentions – aggregierte Metriken über mehrere Ziele

AuthentifizierungRequired

DataForSEO

Live-LLM-Mentions – aggregierte Metriken über mehrere Ziele

Preisreferenz