Consultar un motor de respuestas de IA para la visibilidad GEO/AEO.
Oxylabs
AI-assisted web search.
Consultar un motor de respuestas de IA para la visibilidad GEO/AEO.
Ejecuta una búsqueda síncrona asistida por IA con el origen google_search o google_ai_mode y los demás campos de solicitud documentados. Este endpoint no acepta chatgpt, gemini ni perplexity como orígenes síncronos.
Referencia de precios
- Medición: base de costo fija por solicitud exitosa.
- Estimación de referencia por solicitud: USD 0.00145.
- Multiplicador de referencia del cliente: 1.45. No lo apliques de nuevo a un importe de cliente ya liquidado.
Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.
Cuerpo de paso directo para los motores de respuestas de Google. source selecciona el motor; query, render, parse y geo_location son los parámetros que esperan las fuentes de Google. Los parámetros upstream adicionales se pasan tal cual.
- Tipo: string enumsourceobligatorio
El motor de respuestas de IA de Google que se va a consultar.
google_searchdevuelve Google AI Overviews;google_ai_modedevuelve Google AI Mode. Para ChatGPT/Gemini/Perplexity, usa el endpoint asíncronopost_oxylabs_llm.valores- google
_search - google
_ai _mode
- Tipo: stringgeo
_location Geolocalización a nivel de país para la consulta, por ejemplo "United States".
- Tipo: booleanparse
Devuelve resultados estructurados y analizados en lugar de la salida sin procesar. Recomendado para todas las fuentes.
- Tipo: stringquery
La consulta de búsqueda. Obligatoria para
google_searchygoogle_ai_mode. - enumrenderconstante:html
Para
google_searchygoogle_ai_mode, define "html" para renderizar la página antes del análisis.valores- html
- Tipo: anythingproperty
Name
- Tipo: object200
Consulta completada correctamente.
results[]contiene un resultado por consulta. La forma analizada dentro decontentvaría según el origen (consulta las descripciones de las propiedades); el ejemplo siguiente muestra la forma degoogle_search(Google AI Overviews).- Tipo: array object[]results
Una entrada por consulta. Una consulta única de Realtime devuelve exactamente un resultado, que es la unidad facturada.
- contentTipo: object
Payload de la respuesta analizada. La estructura varía según la fuente de Google:
google_search→content.results.ai_overviews[]conanswer_textyreferences[]{source, url}(se muestra a continuación).google_ai_mode→content.citations[]{text, urls[]}.
- resultsTipo: object
Contenedor de resultados analizados de tipo Google.
- aiTipo: array object[]
_overviews Google AI Overviews devueltos para la consulta.
- answerTipo: array object[]
_text La respuesta generada por IA, dividida en fragmentos que pueden contener referencias en línea.
- fragmentsTipo: array object[]
- referencesTipo: array
- referencesTipo: array object[]
Fuentes citadas para esta descripción general.
- sourceTipo: string
- urlTipo: string
application/json - 400
No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.
- 401
Se requiere una clave de API de Felo válida.
- 402
La solicitud no puede continuar porque no se cumple un requisito de facturación.
- 403
La cuenta no tiene permiso para realizar esta operación.
- 429
Se ha alcanzado un límite de solicitudes o de gasto.
- 502
El servicio no pudo completar la solicitud.
- 503
La API o el servicio de facturación no están disponibles temporalmente.
- 504
El servicio agotó el tiempo de espera al procesar la solicitud.
- default
Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor
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"
}
]
}
]
}
}
}
]
}