Bevraagt een AI-antwoordengine op GEO/AEO-zichtbaarheid.
Oxylabs
AI-assisted web search.
Bevraagt een AI-antwoordengine op GEO/AEO-zichtbaarheid.
Voert een synchrone AI-ondersteunde zoekopdracht uit met bron google_search of google_ai_mode en de overige gedocumenteerde verzoekvelden. Dit endpoint accepteert chatgpt, gemini of perplexity niet als synchrone bronnen.
Prijsreferentie
- Metering: Vaste kostenbasis per geslaagd verzoek.
- Referentieschatting per verzoek: USD 0.00145.
- Referentieklantvermenigvuldiger: 1.45. Pas deze niet opnieuw toe op een afgerekend klantbedrag.
Alleen referentiemetadata, geen accountofferte, geen gegarandeerde prijs en geen bestedingslimiet. Resourcecredits zijn geen Felo-tegoed. De uiteindelijke kosten volgen de factureringsgegevens van Felo.
Passthrough-body voor de Google-antwoordengines. source selecteert de engine; query, render, parse en geo_location zijn de parameters die Google-bronnen verwachten. Aanvullende upstream-parameters worden ongewijzigd doorgegeven.
- Type: string enumsourceverplicht
De Google AI-antwoordengine die moet worden opgevraagd.
google_searchretourneert Google AI Overviews;google_ai_moderetourneert Google AI Mode. Gebruik voor ChatGPT/Gemini/Perplexity in plaats daarvan het asynchrone endpointpost_oxylabs_llm.waarden- google
_search - google
_ai _mode
- Type: stringgeo
_location Geo-locatie op landniveau voor de zoekopdracht, bijvoorbeeld "United States".
- Type: booleanparse
Gestructureerde, geparseerde resultaten retourneren in plaats van onbewerkte uitvoer. Aanbevolen voor elke bron.
- Type: stringquery
De zoekopdracht. Vereist voor
google_searchengoogle_ai_mode. - enumrenderconstante:html
Stel voor
google_searchengoogle_ai_modein op "html" om de pagina te renderen voordat deze wordt geparseerd.waarden- html
- Type: anythingproperty
Name
- Type: object200
Zoekopdracht succesvol voltooid.
results[]bevat één resultaat per zoekopdracht. De geparseerde vorm binnencontentverschilt per bron (zie eigenschapbeschrijvingen); het onderstaande voorbeeld toont de vorm vangoogle_search(Google AI Overviews).- Type: array object[]results
Eén item per zoekopdracht. Een enkele Realtime-zoekopdracht retourneert precies één resultaat, de eenheid die wordt gefactureerd.
- contentType: object
Geparseerde antwoordpayload. De structuur verschilt per Google-bron:
google_search→content.results.ai_overviews[]metanswer_textenreferences[]{source, url}(hieronder weergegeven).google_ai_mode→content.citations[]{text, urls[]}.
- resultsType: object
Container voor geparseerde resultaten van het Google-type.
- aiType: array object[]
_overviews Voor de zoekopdracht geretourneerde Google AI Overviews.
- answerType: array object[]
_text Het door AI gegenereerde antwoord, opgesplitst in fragmenten die inline verwijzingen kunnen bevatten.
- fragmentsType: array object[]
- referencesType: array
- referencesType: array object[]
Geciteerde bronnen voor dit overzicht.
- sourceType: string
- urlType: string
application/json - 400
Het verzoek kon niet worden verwerkt. Controleer de verzoekparameters.
- 401
Een geldige Felo-API-sleutel is vereist.
- 402
Het verzoek kan niet doorgaan omdat niet aan een factureringsvoorwaarde is voldaan.
- 403
Het account mag deze bewerking niet uitvoeren.
- 429
Een verzoek- of bestedingslimiet is bereikt.
- 502
De dienst kon het verzoek niet voltooien.
- 503
De API of factureringsdienst is tijdelijk niet beschikbaar.
- 504
Er is een time-out opgetreden bij het verwerken van het verzoek.
- default
Foutrespons; upstream-passthrough-responsen kunnen indelingen van de provider gebruiken
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"
}
]
}
]
}
}
}
]
}