Dotazuje AI answer engine na viditelnost v GEO/AEO.
Oxylabs
AI-assisted web search.
Dotazuje AI answer engine na viditelnost v GEO/AEO.
Spustí synchronní vyhledávání s podporou AI se zdrojem google_search nebo google_ai_mode a dalšími dokumentovanými poli požadavku. Tento endpoint nepřijímá chatgpt, gemini ani perplexity jako synchronní zdroje.
Cenová reference
- Měření: pevná nákladová základna za úspěšný požadavek.
- Referenční odhad požadavku: USD 0.00145.
- Referenční multiplikátor zákazníka: 1.45. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.
Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.
Tělo předávané beze změny pro odpovědní enginy Google. source vybírá engine; query, render, parse a geo_location jsou parametry, které zdroje Google očekávají. Další parametry upstreamu se předávají beze změny.
- Typ: string enumsourcepovinné
Odpovědní engine Google AI, na který se má dotazovat.
google_searchvrací Google AI Overviews;google_ai_modevrací Google AI Mode. Pro ChatGPT/Gemini/Perplexity použijte místo toho asynchronní endpointpost_oxylabs_llm.hodnoty- google
_search - google
_ai _mode
- Typ: stringgeo
_location Geolokace dotazu na úrovni země, např. "United States".
- Typ: booleanparse
Vrací strukturované, parsované výsledky místo surového výstupu. Doporučeno pro každý zdroj.
- Typ: stringquery
Vyhledávací dotaz. Povinné pro
google_searchagoogle_ai_mode. - enumrenderconst:html
Pro
google_searchagoogle_ai_modenastavte "html", aby se stránka vykreslila před parsováním.hodnoty- html
- Typ: anythingproperty
Name
- Typ: object200
Dotaz úspěšně dokončen.
results[]obsahuje jeden výsledek na dotaz. Parsovaný tvar uvnitřcontentse liší podle zdroje (viz popisy vlastností); níže uvedený příklad ukazuje tvargoogle_search(Google AI Overviews).- Typ: array object[]results
Jeden záznam na dotaz. Jeden dotaz v Realtime vrací přesně jeden výsledek, který je účtovanou jednotkou.
- contentTyp: object
Parsovaná datová část odpovědi. Struktura se liší podle zdroje Google:
google_search→content.results.ai_overviews[]sanswer_textareferences[]{source, url}(zobrazeno níže).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTyp: object
Kontejner parsovaných výsledků typu Google.
- aiTyp: array object[]
_overviews Google AI Overviews vrácené pro dotaz.
- answerTyp: array object[]
_text Odpověď vygenerovaná AI rozdělená na fragmenty, které mohou obsahovat vložené odkazy.
- fragmentsTyp: array object[]
- referencesTyp: array
- referencesTyp: array object[]
Citované zdroje pro tento přehled.
- sourceTyp: string
- urlTyp: string
application/json - 400
Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.
- 401
Je vyžadován platný API klíč Felo.
- 402
V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.
- 403
Účet nemá oprávnění tuto operaci provést.
- 429
Byl dosažen limit požadavků nebo útraty.
- 502
Služba nemohla požadavek dokončit.
- 503
API nebo fakturační služba je dočasně nedostupná.
- 504
Při zpracování požadavku vypršel časový limit služby.
- default
Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele
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"
}
]
}
]
}
}
}
]
}