curl --request POST \
--url https://api.aisa.one/apis/v1/oxylabs/ai-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--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": [
"<unknown>"
]
}
]
}
],
"references": [
{
"source": "<string>",
"url": "<string>"
}
]
}
]
}
}
}
]
}Oxylabs AI-search (Realtime, passthrough)
透传 AI 搜索 source: chatgpt/gemini/perplexity/google_search/google_ai_mode;返回 答案+引用+来源URL。Caller 传完整 body(含 source),原样转发 POST /v1/queries。
curl --request POST \
--url https://api.aisa.one/apis/v1/oxylabs/ai-search \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--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": [
"<unknown>"
]
}
]
}
],
"references": [
{
"source": "<string>",
"url": "<string>"
}
]
}
]
}
}
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Passthrough body for the Google answer engines. source selects the engine; query, render, parse, and geo_location are the parameters Google sources expect. Additional upstream parameters are passed through as-is.
The Google AI answer engine to query. google_search returns Google AI Overviews; google_ai_mode returns Google AI Mode. For ChatGPT/Gemini/Perplexity use the async endpoint post_oxylabs_llm instead.
google_search, google_ai_mode "google_search"
The search query. Required for google_search and google_ai_mode.
"best noise cancelling headphones 2026"
For google_search and google_ai_mode, set to "html" to render the page before parsing.
html "html"
Return structured, parsed results instead of raw output. Recommended for every source.
true
Country-level geo-location for the query, e.g. "United States".
"United States"
Response
Query completed successfully. results[] holds one result per query. The parsed shape inside content varies by source (see property descriptions); the example below shows the google_search (Google AI Overviews) shape.
One entry per query. A Realtime single query returns exactly one result, which is the billed unit.
Show child attributes
Show child attributes