資料 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選填