Oxylabs
AI-assisted web search.
查询 AI 回答引擎，以了解 GEO/AEO 可见度。
使用 source google_search 或 google_ai_mode 以及文档记载的其他请求字段，运行同步的 AI 辅助搜索。本端点不接受 chatgpt、gemini 或 perplexity 作为同步来源。
计费参考
- 计量方式：按成功请求的固定成本计费。
- 参考请求估算：0.00145 美元。
- 参考客户倍率：1.45。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
Google 答案引擎的直通请求体。source 选择引擎；query、render、parse 和 geo_location 是 Google 来源所需的参数。其他上游参数按原样透传。
- 类型: string 枚举source必填
要查询的 Google AI 答案引擎。
google_search返回 Google AI Overviews；google_ai_mode返回 Google AI Mode。如需查询 ChatGPT/Gemini/Perplexity，请改用异步端点post_oxylabs_llm。值- google
_search - google
_ai _mode
- 类型: stringgeo
_location 查询的国家/地区级地理位置，例如 "United States"。
- 类型: booleanparse
返回结构化、已解析的结果，而非原始输出。建议所有来源都启用。
- 类型: stringquery
搜索查询。
google_search和google_ai_mode必填。 - 枚举render常量:html
对于
google_search和google_ai_mode，设为 "html" 可在解析前渲染页面。值- html
- 类型: anythingproperty
Name
- 类型: object200
查询成功完成。
results[]每个查询保存一条结果。content内的解析结构因来源而异（参见属性说明）；下面的示例展示google_search（Google AI 概览）的结构。- 类型: array object[]results
每个查询一条。Realtime 单次查询只返回一个结果，该结果即为计费单位。
- content类型: object
已解析的答案负载。结构因 Google 来源而异：
google_search→content.results.ai_overviews[]，包含answer_text和references[]{source, url}（如下所示）。google_ai_mode→content.citations[]{text, urls[]}。
- results类型: object
Google 类型的已解析结果容器。
- ai类型: array object[]
_overviews 为该查询返回的 Google AI Overviews。
- answer类型: array object[]
_text AI 生成的答案，拆分为若干片段，片段可能带有行内引用。
- fragments类型: array object[]
- references类型: array
- references类型: array object[]
此概览引用的来源。
- source类型: string
- url类型: string
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
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"
}
]
}
]
}
}
}
]
}