Fragt eine KI-Antwortmaschine zur GEO-/AEO-Sichtbarkeit ab.
Oxylabs
AI-assisted web search.
Fragt eine KI-Antwortmaschine zur GEO-/AEO-Sichtbarkeit ab.
Führt eine synchrone KI-gestützte Suche mit der Quelle google_search oder google_ai_mode und den übrigen dokumentierten Anfragefeldern aus. Dieser Endpunkt akzeptiert chatgpt, gemini und perplexity nicht als synchrone Quellen.
Preisreferenz
- Abrechnung: Feste Kostenbasis pro erfolgreicher Anfrage.
- Referenzschätzung pro Anfrage: USD 0.00145.
- Referenz-Kundenmultiplikator: 1.45. Nicht erneut auf einen 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.
Passthrough-Body für die Google-Antwort-Engines. source wählt die Engine aus; query, render, parse und geo_location sind die Parameter, die Google-Quellen erwarten. Zusätzliche Upstream-Parameter werden unverändert durchgereicht.
- Typ: string enumsourceerforderlich
Die abzufragende Google-KI-Antwort-Engine.
google_searchgibt Google AI Overviews zurück;google_ai_modegibt Google AI Mode zurück. Für ChatGPT/Gemini/Perplexity verwenden Sie stattdessen den asynchronen Endpunktpost_oxylabs_llm.Werte- google
_search - google
_ai _mode
- Typ: stringgeo
_location Geo-Standort auf Länderebene für die Abfrage, z. B. "United States".
- Typ: booleanparse
Strukturierte, geparste Ergebnisse statt roher Ausgabe zurückgeben. Für jede Quelle empfohlen.
- Typ: stringquery
Die Suchanfrage. Erforderlich für
google_searchundgoogle_ai_mode. - enumrenderKonstante:html
Für
google_searchundgoogle_ai_modeauf "html" setzen, um die Seite vor dem Parsen zu rendern.Werte- html
- Typ: anythingproperty
Name
- Typ: object200
Abfrage erfolgreich abgeschlossen.
results[]enthält ein Ergebnis pro Abfrage. Die geparste Form innerhalb voncontentvariiert je nach Quelle (siehe Eigenschaftsbeschreibungen); das folgende Beispiel zeigt die Form vongoogle_search(Google AI Overviews).- Typ: array object[]results
Ein Eintrag pro Abfrage. Eine einzelne Realtime-Abfrage liefert genau ein Ergebnis, das die abgerechnete Einheit ist.
- contentTyp: object
Geparste Antwort-Payload. Die Struktur variiert je nach Google-Quelle:
google_search→content.results.ai_overviews[]mitanswer_textundreferences[]{source, url}(siehe unten).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTyp: object
Container für geparste Ergebnisse vom Google-Typ.
- aiTyp: array object[]
_overviews Für die Abfrage zurückgegebene Google AI Overviews.
- answerTyp: array object[]
_text Die KI-generierte Antwort, aufgeteilt in Fragmente, die Inline-Referenzen enthalten können.
- fragmentsTyp: array object[]
- referencesTyp: array
- referencesTyp: array object[]
Zitierte Quellen für diesen Überblick.
- sourceTyp: string
- urlTyp: string
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
curl https://openapi.felo.ai/v1/beta/oxylabs/ai-search \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"source": "google_search",
"query": "best noise cancelling headphones 2026",
"parse": true,
"render": "html",
"geo_location": "United States"
}'
{
"results": [
{
"content": {
"results": {
"ai_overviews": [
{
"answer_text": [
{
"fragments": [
{
"references": "[Max Depth Exceeded]"
}
]
}
],
"references": [
{
"source": "string",
"url": "string"
}
]
}
]
}
}
}
]
}