数据 API / Oxylabs / AI Search

Query an AI answer engine for GEO/AEO visibility.

Synchronous passthrough to the upstream Oxylabs Realtime endpoint (POST /v1/queries). Pick an AI answer engine with source and send the parameters that source expects; the request body is passed through unchanged. The response returns the AI-generated answer text and the cited source URLs, letting you track how a brand or product is surfaced and cited across AI answers. AI sources (chatgpt, gemini, perplexity) take ~40–60s and Google-type sources ~4–8s, so use a client timeout of at least 90s.

参数

没有路径、查询或请求头参数。

请求体

sourcestring必填
允许值： chatgpt · gemini · perplexity · google_search · google_ai_mode
The AI answer engine to query. google_search returns Google AI Overviews. Each source expects a specific subset of the parameters below.
promptstring可选
The natural-language prompt. Used by chatgpt (max 4000 chars), gemini (max 8000 chars), and perplexity. Use query instead for the Google-type sources.
querystring可选
The search query. Used by google_search and google_ai_mode. Use prompt instead for chatgpt/gemini/perplexity.
searchboolean可选
For chatgpt, set to true to have ChatGPT browse the web before answering.
renderstring可选
允许值： html
For google_search and google_ai_mode, set to "html" to render the page before parsing.
parseboolean可选
Return structured, parsed results instead of raw output. Recommended for every source.
geo_locationstring可选
Country-level geo-location for the query, e.g. "United States".

请求示例

curl -X POST "https://openapi.felo.ai/v1/beta/oxylabs/ai-search" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "source": "<string>",
  "prompt": "<string>",
  "query": "<string>",
  "search": false,
  "render": "<string>",
  "parse": false,
  "geo_location": "<string>"
}'

响应

响应字段

resultsobject[]可选
One entry per query. A Realtime single query returns exactly one result, which is the billed unit.
contentobject可选
Parsed answer payload. The structure varies by source: - google_search → content.results.ai_overviews[] with answer_text and references[]{source, url} (shown below). - chatgpt / gemini → response_text plus citations[]. - perplexity → top_sources[] / sources_results[]. - google_ai_mode → content.citations[]{text, urls[]}.
resultsobject可选
Google-type parsed results container.
ai_overviewsobject[]可选
Google AI Overviews returned for the query.
answer_textobject[]可选
The AI-generated answer, split into fragments that may carry inline references.
fragmentsobject[]可选
referencesarray可选
referencesobject[]可选
Cited sources for this overview.
sourcestring可选
urlstring可选