데이터 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선택