Interroga un motore di risposte AI per la visibilità GEO/AEO.
Oxylabs
AI-assisted web search.
Interroga un motore di risposte AI per la visibilità GEO/AEO.
Esegue una ricerca sincrona assistita dall'AI usando l'origine google_search o google_ai_mode e gli altri campi della richiesta documentati. Questo endpoint non accetta chatgpt, gemini o perplexity come origini sincrone.
Riferimento prezzi
- Misurazione: base di costo fissa per richiesta riuscita.
- Stima di riferimento per richiesta: USD 0.00145.
- Moltiplicatore di riferimento per il cliente: 1.45. Non applicarlo di nuovo a un importo già addebitato al cliente.
Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
Corpo passthrough per i motori di risposta Google. source seleziona il motore; query, render, parse e geo_location sono i parametri attesi dalle fonti Google. Gli eventuali parametri upstream aggiuntivi vengono passati così come sono.
- Tipo: string enumsourceobbligatorio
Il motore di risposta Google AI da interrogare.
google_searchrestituisce Google AI Overviews;google_ai_moderestituisce Google AI Mode. Per ChatGPT/Gemini/Perplexity usa invece l'endpoint asincronopost_oxylabs_llm.valori- google
_search - google
_ai _mode
- Tipo: stringgeo
_location Posizione geografica a livello di paese per la query, ad esempio "United States".
- Tipo: booleanparse
Restituisce risultati strutturati e analizzati invece dell'output grezzo. Consigliato per ogni fonte.
- Tipo: stringquery
La query di ricerca. Obbligatoria per
google_searchegoogle_ai_mode. - enumrenderconst:html
Per
google_searchegoogle_ai_mode, imposta su "html" per eseguire il rendering della pagina prima dell'analisi.valori- html
- Tipo: anythingproperty
Name
- Tipo: object200
Query completata correttamente.
results[]contiene un risultato per query. La forma analizzata all'interno dicontentvaria in base all'origine (vedi le descrizioni delle proprietà); l'esempio seguente mostra la forma digoogle_search(Google AI Overviews).- Tipo: array object[]results
Una voce per query. Una singola query Realtime restituisce esattamente un risultato, che è l'unità fatturata.
- contentTipo: object
Payload della risposta analizzata. La struttura varia in base alla fonte Google:
google_search→content.results.ai_overviews[]conanswer_textereferences[]{source, url}(mostrato di seguito).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTipo: object
Contenitore dei risultati analizzati di tipo Google.
- aiTipo: array object[]
_overviews Google AI Overviews restituiti per la query.
- answerTipo: array object[]
_text La risposta generata dall'AI, suddivisa in frammenti che possono contenere riferimenti inline.
- fragmentsTipo: array object[]
- referencesTipo: array
- referencesTipo: array object[]
Fonti citate per questo riepilogo.
- sourceTipo: string
- urlTipo: string
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
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"
}
]
}
]
}
}
}
]
}