Google AI Search
Google AI Search HTTP and SSE routes for search extraction, cookie bootstrap, targeting controls, and status checks.
by @saifyxpro
Base path: /api/operators/google/ai-search/*
Endpoints
| Method | Path | Purpose | Notes |
|---|---|---|---|
POST | /api/operators/google/ai-search/search | standard Google AI Search scrape | JSON response |
GET | /api/operators/google/ai-search/stream | stream Google AI Search progress | SSE |
GET | /api/operators/google/ai-search/status | service status | lightweight availability check |
GET | /api/operators/google/ai-search/cookies/status | cookie bootstrap status | shared profile readiness |
POST | /api/operators/google/ai-search/cookies/build | start shared-profile cookie bootstrap | opens the interactive browser session |
POST | /api/operators/google/ai-search/cookies/stop | stop cookie bootstrap and persist profile | saves the shared profile state |
Request fields
| Field | Type | Meaning |
|---|---|---|
query | string | search query text |
gl | string | optional two-letter Google region code such as pk, us, or in |
hl | string | optional two-letter Google language code such as en or ur |
tbs | qdr:h | qdr:d | qdr:w | optional time filter for past hour, day, or week |
stealth | boolean | optional stealth toggle |
POST /api/operators/google/ai-search/search
Use this when you want a normal JSON result set for a query.
By default the backend starts from plain https://www.google.com/ and only applies gl, hl, or tbs when you explicitly send them.
If the shared Google profile has not been bootstrapped yet, the backend rejects normal search execution until the cookie flow has been completed once.
GET /api/operators/google/ai-search/stream
Use this when you want progressive events instead of waiting for the final result.
Notes:
- this route uses query parameters
- it accepts
queryand optionaltimeout,gl,hl,tbs, andstealth - it currently ends with
endinstead ofdone - it can return a structured bootstrap error when cookies are still required
GET /api/operators/google/ai-search/status
Use this to confirm that the Google AI Search surface is reachable before a full query.
Cookie bootstrap endpoints
Google AI Search now depends on a one-time cookie bootstrap on the shared persistent browser profile.
GET /api/operators/google/ai-search/cookies/status
Use this to confirm whether:
- cookies are required
- a bootstrap browser is already running
- the last bootstrap succeeded or failed
POST /api/operators/google/ai-search/cookies/build
Starts the interactive shared-profile browser flow used to build trusted Google cookies.
Behavior:
- reuses the same long-lived Headfox JS profile used elsewhere in the runtime
- prefers a real display when available
- starts a virtual display on Linux when needed
POST /api/operators/google/ai-search/cookies/stop
Stops the bootstrap browser cleanly and persists the shared browser profile.
Open the dashboard Google AI Search workspace, click Build Cookies, browse Google normally, solve any one-time challenge, then click Stop Browser. After that, later Google AI Search runs reuse the saved shared profile.
Was this page helpful?