v0.2.0-beta

OpenAPI 3.1.0

Live-LLM-Mentions

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

Live-LLM-Mentions

Die einzelnen Antworten, in denen ein Assistent Ihr Ziel erwähnt hat. Gibt total_count, current_offset, search_after_token und items zurück – blättern Sie mit dem Token, nicht mit offset, über die ersten Seiten hinaus. ⚠️ 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. Für Anzahlen statt der Erwähnungen selbst verwenden Sie post_dataforseo_ai_llm_mentions_aggregated_metrics_live.

Preisreferenz

Abrechnung: Gemeldete Antwortkosten.
Referenzschätzung pro Anfrage: USD 0.701.
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
  
  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.
- filters
  Typ: array
  
  Array von Parametern zum Filtern der Ergebnisse. Optionales Feld. Sie können mehrere Filter gleichzeitig hinzufügen (maximal 8 Filter). Zwischen den Bedingungen müssen Sie einen logischen Operator and oder or setzen. Folgende Operatoren werden unterstützt: =, , in, not_in, like, not_like, ilike, not_ilike, match, not_match. Mit dem Operator % können Sie bei like und not_like beliebige Zeichenfolgen mit null oder mehr Zeichen abgleichen. Beispiel: ["ai_search_volume",">","1000"]. Die vollständige Liste möglicher Filter finden Sie hier.
- 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.
- limit
  Typ: integer
  
  Maximale Anzahl zurückgegebener Objekte. Optionales Feld. Standardwert: 100. Maximalwert: 1000.
- 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.
- offset
  Typ: integer
  
  Offset im Ergebnis-Array der zurückgegebenen Erwähnungsdaten. Optionales Feld. Standardwert: 0. Beispiel: Wenn Sie den Wert 10 angeben, werden die ersten zehn Erwähnungsobjekte im Ergebnis-Array ausgelassen und die Daten für die nachfolgenden Objekte bereitgestellt. Hinweis: Der Maximalwert beträgt 9.000; verwenden Sie search_after_token, wenn Sie einen größeren Offset benötigen.
- order_by
  Typ: array string[]
  
  Sortierregeln für Ergebnisse. Optionales Feld. Sie können dieselben Werte wie im filters-Array verwenden, um die Ergebnisse zu sortieren. Mögliche Sortierarten: asc – Ergebnisse werden in aufsteigender Reihenfolge sortiert; desc – Ergebnisse werden in absteigender Reihenfolge sortiert. Verwenden Sie ein Komma, um eine Sortierart festzulegen. Beispiel: ["ai_search_volume,desc"]. Beachten Sie, dass Sie in einer einzigen Anfrage höchstens drei Sortierregeln festlegen können; mehrere Sortierregeln müssen durch ein Komma getrennt werden.
- 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.
- search_after_token
  Typ: string
  
  Token für Folgeanfragen. Optionales Feld. Wird im identischen Feld der Antwort auf jede Anfrage bereitgestellt. Verwenden Sie diesen Parameter, um Timeouts zu vermeiden, wenn Sie mehr als 20.000 Ergebnisse in einer einzigen Anfrage abrufen möchten. Wenn Sie den eindeutigen search_after_token-Wert aus dem Antwort-Array angeben, erhalten Sie die Folgeergebnisse der ursprünglichen Aufgabe. search_after_token-Werte sind für jede Folgeaufgabe eindeutig. Hinweis: Wenn search_after_token in der Anfrage angegeben ist, müssen alle anderen Parameter mit der vorherigen Anfrage identisch sein.
- 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.current_offset
Typ: integer

Anzahl der Erwähnungsobjekte, die im items-Array ausgelassen werden

tasks.result.items
Typ: array string[]

Enthält relevante Erwähnungsdaten

tasks.result.items_count
Typ: integer

Anzahl der im items-Array zurückgegebenen Ergebnisse

tasks.result.items.ai_search_volume
Typ: integer

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

tasks.result.items.answer
Typ: string

Relevante Antwort im Markdown-Format; der Inhalt des Ergebnisses ist in der Auszeichnungssprache Markdown formatiert

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

Array von Markenentitäten; enthält Informationen zu Marken, die in der Antwort erwähnt werden

tasks.result.items.brand_entities.category
Typ: string

Kategorie der Marke

tasks.result.items.brand_entities.position
Typ: integer

Position in den Ergebnissen

tasks.result.items.brand_entities.title
Typ: string

Name der Marke

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

Array von Fan-out-Abfragen; enthält verwandte Suchanfragen, die aus der Hauptanfrage abgeleitet werden, um eine umfassendere Antwort zu liefern

tasks.result.items.first_response_at
Typ: string

Datum und Uhrzeit, zu dem die Antwortdaten erstmals aufgezeichnet wurden, im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“. Beispiel: 2025-10-21 06:25:30 +00:00

tasks.result.items.language_code
Typ: string

Sprachcode in einem POST-Array

tasks.result.items.last_response_at
Typ: string

Datum und Uhrzeit, zu dem die Antwortdaten zuletzt aktualisiert wurden, im UTC-Format: „yyyy-mm-dd hh-mm-ss +00:00“. Beispiel: 2025-10-21 06:25:30 +00:00

tasks.result.items.location_code
Typ: integer

Standortcode in einem POST-Array

tasks.result.items.model_name
Typ: string

Name des KI-Modells, aus dem die Daten abgerufen wurden. Hinweis: Beim Plattformtyp google ist der Wert immer google_ai_overview

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

Monatliche KI-Suchvolumenraten; Array von Objekten mit KI-Suchvolumenraten in einem bestimmten Monat eines Jahres

tasks.result.items.monthly_searches.month
Typ: integer

Monat

tasks.result.items.monthly_searches.search_volume
Typ: integer

KI-Suchvolumenrate in einem bestimmten Monat eines Jahres. Mehr zu dieser Metrik erfahren Sie hier

tasks.result.items.monthly_searches.year
Typ: integer

Jahr

tasks.result.items.platform
Typ: string

Plattform, empfangen in einem POST-Array

tasks.result.items.question
Typ: string

Relevante Frage

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

Array von Suchergebnissen; alle Websuche-Ausgaben, die das Modell beim Nachschlagen von Informationen abgerufen hat, einschließlich Duplikaten und nicht verwendeter Einträge

tasks.result.items.search_results.breadcrumb
Typ: string

Breadcrumb

tasks.result.items.search_results.description
Typ: string

Ergebnisbeschreibung

tasks.result.items.search_results.domain
Typ: string

Ergebnis-Domain

tasks.result.items.search_results.position
Typ: integer

Position in den Ergebnissen

tasks.result.items.search_results.publication_date
Typ: string

Datum und Uhrzeit, zu dem das Ergebnis veröffentlicht wurde, im Format: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes“. Beispiel: 2019-11-15 12:57:46 +00:00

tasks.result.items.search_results.title
Typ: string

Ergebnistitel

tasks.result.items.search_results.url
Typ: string

Ergebnis-URL

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

Array von Quellen; die Quellen, die das Modell in seiner endgültigen Antwort zitiert oder herangezogen hat

tasks.result.items.sources.domain
Typ: string

Quell-Domain

tasks.result.items.sources.markdown
Typ: string

Inhalt des Elements im Markdown-Format; der Inhalt des Ergebnisses ist in der Auszeichnungssprache Markdown formatiert

tasks.result.items.sources.position
Typ: integer

Position in den Ergebnissen

tasks.result.items.sources.publication_date
Typ: string

Datum und Uhrzeit, zu dem das Ergebnis veröffentlicht wurde, im Format: „year-month-date:minutes:UTC_difference_hours:UTC_difference_minutes“. Beispiel: 2019-11-15 12:57:46 +00:00

tasks.result.items.sources.snippet
Typ: string

Quellbeschreibung

tasks.result.items.sources.source_name
Typ: string

Quellenname

tasks.result.items.sources.thumbnail
Typ: string

Quell-Vorschaubild

tasks.result.items.sources.title
Typ: string

Quellentitel

tasks.result.items.sources.url
Typ: string

Quell-URL

tasks.result.search_after_token
Typ: string

Token für Folgeanfragen. Wenn Sie beim Festlegen einer neuen Aufgabe den eindeutigen search_after_token angeben, erhalten Sie die Folgeergebnisse der ursprünglichen Aufgabe. search_after_token-Werte sind für jede Folgeaufgabe eindeutig

tasks.result.total_count
Typ: integer

Gesamtanzahl der für die Anfrage relevanten Ergebnisse

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

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

Erfolgreiche Antwort

Live-LLM-Mentions

AuthentifizierungRequired

DataForSEO

Live-LLM-Mentions

Preisreferenz