Consultar um mecanismo de respostas de IA para visibilidade em GEO/AEO.
Oxylabs
AI-assisted web search.
Consultar um mecanismo de respostas de IA para visibilidade em GEO/AEO.
Executa uma pesquisa síncrona assistida por IA usando a fonte google_search ou google_ai_mode e os demais campos de requisição documentados. Este endpoint não aceita chatgpt, gemini ou perplexity como fontes síncronas.
Referência de preços
- Medição: base de custo fixa por requisição bem-sucedida.
- Estimativa de referência por requisição: USD 0.00145.
- Multiplicador de referência do cliente: 1.45. Não o aplique novamente a um valor de cliente já liquidado.
Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.
Corpo de passthrough para os mecanismos de resposta do Google. source seleciona o mecanismo; query, render, parse e geo_location são os parâmetros esperados pelas fontes do Google. Parâmetros upstream adicionais são repassados como estão.
- Tipo: string enumsourceobrigatório
O mecanismo de respostas de IA do Google a consultar.
google_searchretorna Google AI Overviews;google_ai_moderetorna Google AI Mode. Para ChatGPT/Gemini/Perplexity, use o endpoint assíncronopost_oxylabs_llm.valores- google
_search - google
_ai _mode
- Tipo: stringgeo
_location Geolocalização no nível do país para a consulta, por exemplo "United States".
- Tipo: booleanparse
Retorna resultados estruturados e analisados em vez da saída bruta. Recomendado para todas as fontes.
- Tipo: stringquery
A consulta de pesquisa. Obrigatória para
google_searchegoogle_ai_mode. - enumrenderconst:html
Para
google_searchegoogle_ai_mode, defina como "html" para renderizar a página antes da análise.valores- html
- Tipo: anythingproperty
Name
- Tipo: object200
Consulta concluída com sucesso.
results[]contém um resultado por consulta. A forma analisada dentro decontentvaria conforme a fonte (veja as descrições das propriedades); o exemplo abaixo mostra a forma degoogle_search(Google AI Overviews).- Tipo: array object[]results
Uma entrada por consulta. Uma consulta única do Realtime retorna exatamente um resultado, que é a unidade cobrada.
- contentTipo: object
Payload da resposta analisada. A estrutura varia conforme a fonte do Google:
google_search→content.results.ai_overviews[]comanswer_textereferences[]{source, url}(mostrado abaixo).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTipo: object
Contêiner de resultados analisados do tipo Google.
- aiTipo: array object[]
_overviews Google AI Overviews retornados para a consulta.
- answerTipo: array object[]
_text A resposta gerada por IA, dividida em fragmentos que podem conter referências embutidas.
- fragmentsTipo: array object[]
- referencesTipo: array
- referencesTipo: array object[]
Fontes citadas para esta visão geral.
- sourceTipo: string
- urlTipo: string
application/json - 400
Não foi possível processar a requisição. Verifique os parâmetros da requisição.
- 401
É necessária uma chave de API da Felo válida.
- 402
A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.
- 403
A conta não tem permissão para realizar esta operação.
- 429
Um limite de requisições ou de gastos foi atingido.
- 502
O serviço não pôde concluir a requisição.
- 503
A API ou o serviço de cobrança está temporariamente indisponível.
- 504
O serviço atingiu o tempo limite ao processar a requisição.
- default
Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor
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"
}
]
}
]
}
}
}
]
}