Back to Directory
O

Oxylabs AI Search API via AIsa

Other
Oxylabs answer-engine access for GEO/AEO (Generative / Answer Engine Optimization) exposed through the AIsa gateway. Oxylabs splits answer engines across two integration styles: - **LLM sources — ChatGPT, Gemini, Perplexity** — are asynchronous (Oxylabs Push-Pull). Submit a job with `POST /oxylabs/llm`, then poll `GET /oxylabs/llm/{jobId}` until it is terminal. These sources take ~40–90s, so they cannot be served synchronously. - **Google sources — Google AI Overviews (`google_search`) and Google AI Mode (`google_ai_mode`)** — are synchronous: call `POST /oxylabs/ai-search` and get the parsed answer back in the same response (~4–8s). Both return the AI-generated answer text together with the cited source URLs, so you can monitor how a brand or product is surfaced and cited across AI answers. The async LLM job is billed a flat $0.00145 per successful job; the synchronous Google endpoint is billed a flat $0.001 per successful result. Only successful responses are billed; 400/429/5xx/6xx and upstream 4xx are …

About Oxylabs AI Search API via AIsa

Review the Service identity, supported languages, protocol versions, and source metadata discovered by the directory.

Service details

Service Id
22d12420-ecf2-4896-8579-3670613a66e1
Service origin
https://api.aisa.one
ListedSeptember 24, 2026, 6:41 PM
Last checkedSeptember 24, 2026, 8:02 PM

Protocol details

SourceOpenAPI

Endpoints

Endpoint details are saved from the OpenAPI document. Authentication requirements and prices are advertised information, not a verified payment or access guarantee. The document may contain additional endpoints.Open OpenAPI document
POST/oxylabs/ai-search

Query a Google AI answer engine (AI Overviews / AI Mode) for GEO/AEO visibility.

Synchronous passthrough to the upstream Oxylabs Realtime endpoint (POST /v1/queries) for the **Google answer engines** — Google AI Overviews (`source: google_search`) and Google AI Mode (`source: google_ai_mode`). Send `query` with `render: "html"`, `parse: true`, and a country-level `geo_location`; the request body is passed through unchanged. The response returns the AI-generated answer text and the cited source URLs. Billed a flat $0.001 per successful result; 400/429/5xx/6xx and upstream 4xx responses are not billed. Google-type sources take ~4–8s, so use a client timeout of at least 30s. **LLM sources (ChatGPT, Gemini, Perplexity) are no longer served here** — Oxylabs moved them to an asynchronous Push-Pull flow. Use `post_oxylabs_llm` (`POST /oxylabs/llm`) plus `get_oxylabs_llm_job` for those sources; calling this endpoint with `source: chatgpt|gemini|perplexity` returns HTTP 422 "Realtime integration is not supported for LLM sources. Please use Push-Pull."Price unavailableThe operation requires declared authentication; API keys, bearer tokens and other schemes are not evidence of AEP support.
POST/oxylabs/llm

Submit an asynchronous LLM answer-engine query (ChatGPT / Gemini / Perplexity).

Submit an asynchronous query to a major LLM answer engine — ChatGPT, Gemini, or Perplexity — via Oxylabs Push-Pull. Pick the engine with `source`, send the `prompt` (required), and a unique `Idempotency-Key` header (required). These sources take ~40–90s, so they run as background jobs. Submitting returns HTTP 202 and a job envelope — `id`, `object`, `endpoint`, `status`, `createdAt`, `completedAt`, `pricing`, `output`, `error` — with `output` still null. Poll `get_oxylabs_llm_job` until terminal; `output` then carries `results[]` with the parsed answer text and cited sources. Billed a flat $0.00145 per successful job — `pricing.billingMode` is `fixed_request`. A queued job can be cancelled with `POST /oxylabs/llm/{jobId}/cancel`, which releases the hold; failed and cancelled jobs are never billed. Google sources (`google_search`, `google_ai_mode`) are synchronous and stay on `post_oxylabs_ai_search`. Send a fresh `Idempotency-Key` per distinct query.Price unavailableThe operation requires declared authentication; API keys, bearer tokens and other schemes are not evidence of AEP support.
GET/oxylabs/llm/{jobId}

Poll an asynchronous Oxylabs LLM job.

Fetch an Oxylabs LLM job submitted by `post_oxylabs_llm`, by its `jobId`. Returns the same envelope — `id`, `status`, `createdAt`, `completedAt`, `pricing`, `output`, `error`. Repeat until `status` is `completed`, `failed`, or `cancelled`; on success `output` carries `results[]` with the parsed answer text and cited sources. Reads a job only; it cannot start one.Price unavailableThe operation requires declared authentication; API keys, bearer tokens and other schemes are not evidence of AEP support.
POST/oxylabs/llm/{jobId}/cancel

Cancel a queued Oxylabs LLM job.

Cancel an Oxylabs LLM job submitted by `post_oxylabs_llm` while it is still queued, by its `jobId`. Returns the job envelope with `status: cancelled`. Cancelling releases the authorized hold; a cancelled job is never billed. A job that has already reached a terminal state cannot be cancelled.Price unavailableThe operation requires declared authentication; API keys, bearer tokens and other schemes are not evidence of AEP support.