serpkite 0.7.0 → 0.8.0

package/dist/index.d.cts

@@ -105,7 +105,10 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Google Images */
+        /**
+         * Google Images
+         * @description One page is a block of up to 100 images for 1 credit; page 2 starts at position 101. `num` returns only the first `num` images of the page (same credit). A page past the last one returns empty `results`, free.
+         */
         post: operations["images"];
         delete?: never;
         options?: never;
@@ -331,6 +334,118 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/chatgpt": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ask ChatGPT as a logged-out user and get its answer, cited sources, products and places (5 credits)
+         * @description Opens chatgpt.com as a logged-out visitor in a standard Chrome behind our
+         *     proxies, sends `prompt` and returns the answer. With `web_search` (default
+         *     true) ChatGPT searches the web; `false` lets it decide. ChatGPT localises
+         *     prices, shops and places to where the visitor is: set `country` to ask from
+         *     an exit in that country (residential proxies), or leave it out to ask from
+         *     any of our exits. Guests get ChatGPT's default free model (`model`).
+         *     Takes 20–90 s; failed or refused answers are free.
+         */
+        post: operations["chatgpt"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/gemini": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ask Google Gemini as a logged-out user and get its answer with the sources it grounded on (5 credits)
+         * @description Opens gemini.google.com as a logged-out visitor and sends `prompt`. Gemini
+         *     answers guests from residential and ISP exits only; grounded answers take
+         *     40–90 s. `country` asks from an exit in that country.
+         */
+        post: operations["gemini"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/copilot": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ask Microsoft Copilot Search on Bing and get its answer, cited sources and products (3 credits)
+         * @description Microsoft Copilot Search (bing.com/copilotsearch, Bing's AI answer).
+         *     The Copilot app itself has no logged-out access. `country` and `language`
+         *     set Bing's market. Products are Bing's sponsored product cards. 15–40 s.
+         */
+        post: operations["copilot"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/ai_mode": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ask Google AI Mode and get its answer, cited sources and products (3 credits)
+         * @description Google's AI Mode (`udm=50`) for `prompt`, logged out. `country` is the
+         *     country Google answers for. 10–45 s.
+         */
+        post: operations["aiMode"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/brave_ai": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Ask Brave Search's AI answer and get it with cited sources, the searches it ran and products (2 credits)
+         * @description Brave Search's AI answer ("Ask Brave") for `prompt`, logged out. `country`
+         *     sets Brave's market (prices and shops follow it). About 10 s.
+         */
+        post: operations["braveAi"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/extract": {
         parameters: {
             query?: never;
@@ -572,6 +687,13 @@ interface paths {
          *     account (403 `forbidden`). A monitor pauses itself after 10 failed runs in a row
          *     (search errors, insufficient credits or webhook failures) or when its key is
          *     revoked; set `active: true` to resume.
+         *
+         *     With an AI assistant `endpoint` (chatgpt, gemini, copilot, ai_mode,
+         *     brave_ai) the monitor asks `prompt` every run and reports every answer
+         *     (AI visibility is tracked over time): `text`, `markdown`, `sources`,
+         *     `new_sources` (links not seen in earlier runs), `search_queries`,
+         *     `products` and, with `track`, `mentions`. Each run costs the endpoint's
+         *     price.
          */
         post: operations["createMonitor"];
         delete?: never;
@@ -913,7 +1035,7 @@ interface components {
             /** @description Map point "@lat,lng,14z" (maps and places only; zoom optional, default 14z): the map is searched around that point at that zoom, wherever the request comes from. Overrides location */
             ll?: string;
             /**
-             * @description 10, or up to 100 for the depth bundle on search and news (7 credits for 100; values between round up to whole pages). Other verticals return one page of 10
+             * @description 1–100. Up to 10 returns one page (10 results, 1 credit; trim it yourself for fewer). Above 10 on search and news is the depth bundle (7 credits for 100; values between round up to whole pages). On images a page is a block of up to 100 images (1 credit) and num (default 100) is how many of them to return; `page` moves to the next block. Other verticals return one page of 10
              * @default 10
              */
             num?: number;
@@ -1053,6 +1175,135 @@ interface components {
             max_age?: number;
             engine?: components["schemas"]["EngineParam"];
         };
+        AssistantRequest: {
+            /** @description The message to the assistant */
+            prompt: string;
+            /** @description Ask from this country (ISO 3166-1 alpha-2): answers, prices and shops follow it */
+            country?: string;
+            /** @description Interface language (e.g. en, de); the answer follows the prompt's language */
+            language?: string;
+            track?: components["schemas"]["TrackList"];
+            /**
+             * @description Also return the answer page's HTML (`html`)
+             * @default false
+             */
+            include_html?: boolean;
+            /**
+             * @default json
+             * @enum {string}
+             */
+            format?: "json" | "markdown" | "compact";
+            fields?: string;
+            /** @description Accept a cached answer up to this many seconds old (half price); answers are cached for at most an hour */
+            max_age?: number;
+        };
+        ChatGPTRequest: {
+            /** @description The message to ChatGPT */
+            prompt: string;
+            /**
+             * @description Make ChatGPT search the web; false lets it decide (it then searches for about two thirds of shopping and local prompts)
+             * @default true
+             */
+            web_search?: boolean;
+            /** @description Ask from an exit in this country (ISO 3166-1 alpha-2, residential proxies). Without it any of our exits asks (mostly US and EU) */
+            country?: string;
+            track?: components["schemas"]["TrackList"];
+            /** @default false */
+            include_html?: boolean;
+            /**
+             * @default json
+             * @enum {string}
+             */
+            format?: "json" | "markdown" | "compact";
+            fields?: string;
+            max_age?: number;
+        };
+        /** @description Brands ("Acme") and domains ("acme.com", subdomains match) to check the answer for; each comes back in `mentions` */
+        TrackList: string[];
+        AISource: {
+            /** @description The number the answer cites it with ([n] in markdown) */
+            position: number;
+            title?: string;
+            link: string;
+            domain: string;
+            snippet?: string;
+            date?: string;
+            /** @description Cited inline in the answer (false: only listed beside it) */
+            cited: boolean;
+        };
+        AIProduct: {
+            position: number;
+            title: string;
+            brand?: string;
+            /** @description As shown */
+            price?: string;
+            extracted_price?: number;
+            /** @description ISO 4217 when the symbol is unambiguous */
+            currency?: string;
+            rating?: number;
+            reviews?: number;
+            merchant?: string;
+            link?: string;
+            image?: string;
+            description?: string;
+            /** @description A paid placement (an ad card shown with the answer) */
+            sponsored?: boolean;
+        };
+        Mention: {
+            term: string;
+            /** @description The answer text names it (a domain: names the domain) */
+            mentioned: boolean;
+            /** @description A cited source matches it */
+            cited: boolean;
+            /** @description Positions of the matching sources */
+            sources: number[];
+            /** @description Positions of the matching products */
+            products?: number[];
+            /** @description Where the text first names it, 0 (start) to 1 (end); -1 when it doesn't */
+            text_position: number;
+        };
+        /** @description The normalised request of an AI assistant endpoint (the path names the assistant, so there is no engine) */
+        AssistantEcho: {
+            /**
+             * @example chatgpt
+             * @example gemini
+             */
+            endpoint: string;
+            prompt: string;
+            country?: string;
+            /** @description Not on chatgpt */
+            language?: string;
+            /** @description chatgpt only */
+            web_search?: boolean;
+            include_html?: boolean;
+        };
+        AssistantResponse: {
+            request: components["schemas"]["AssistantEcho"];
+            /** @description The answer as plain text */
+            text: string;
+            /** @description The answer as Markdown, citations as [n](link) matching sources[].position */
+            markdown: string;
+            /** @description Only with include_html=true */
+            html?: string;
+            /** @description The model the assistant reports, when it does (e.g. ChatGPT's guest model) */
+            model?: string;
+            sources: components["schemas"]["AISource"][];
+            /** @description The searches the assistant ran (fan-out) where it shows them */
+            search_queries: string[];
+            products: components["schemas"]["AIProduct"][];
+            /** @description Local businesses the answer showed */
+            places?: components["schemas"]["PlaceResult"][];
+            related_questions?: string[];
+            /** @description With track only */
+            mentions?: components["schemas"]["Mention"][];
+            meta: components["schemas"]["Meta"];
+        };
+        AIOverview: {
+            text: string;
+            /** @description Citations as [n](link) matching sources[].position */
+            markdown: string;
+            sources: components["schemas"]["AISource"][];
+        };
         WebpageRequest: {
             /**
              * Format: uri
@@ -1660,6 +1911,7 @@ interface components {
              * @example search
              * @example news
              * @example webpage
+             * @example chatgpt
              */
             endpoint: string;
             /** @description The engine policy as asked (google, auto, one provider or a list) */
@@ -1691,6 +1943,11 @@ interface components {
             boost_domains?: string[];
             highlights?: boolean;
             include_answer?: boolean;
+            /** @description AI assistant endpoints */
+            prompt?: string;
+            /** @description /v1/chatgpt */
+            web_search?: boolean;
+            include_html?: boolean;
         } & {
             [key: string]: unknown;
         };
@@ -1774,6 +2031,8 @@ interface components {
             top_stories?: components["schemas"]["NewsResult"][];
             places?: components["schemas"]["PlaceResult"][];
             answer?: components["schemas"]["SearchAnswer"];
+            /** @description Google's AI Overview when the page showed one */
+            ai_overview?: components["schemas"]["AIOverview"];
             meta: components["schemas"]["Meta"];
         };
         ImageResult: {
@@ -2120,7 +2379,7 @@ interface components {
         };
         BatchCreateRequest: {
             /** @enum {string} */
-            endpoint: "search" | "images" | "videos" | "news" | "maps" | "places" | "place" | "reviews" | "shopping" | "scholar" | "patents" | "autocomplete" | "webpage";
+            endpoint: "search" | "images" | "videos" | "news" | "maps" | "places" | "place" | "reviews" | "shopping" | "scholar" | "patents" | "autocomplete" | "webpage" | "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
             /** @description Request bodies for `endpoint` (same fields as the realtime endpoint) */
             requests: {
                 [key: string]: unknown;
@@ -2202,10 +2461,15 @@ interface components {
                 message?: string;
             };
         };
-        /** @description The saved request a monitor reruns: a search (q and options) or, for webpage monitors, url (and country) */
+        /** @description The saved request a monitor reruns: a search (q and options), for webpage monitors url (and country), or for AI assistant monitors prompt (with country, language, web_search and track) */
         MonitorSearch: {
             q?: string;
             url?: string;
+            /** @description AI assistant monitors */
+            prompt?: string;
+            /** @description endpoint=chatgpt */
+            web_search?: boolean;
+            track?: string[];
             country?: string;
             language?: string;
             location?: string;
@@ -2218,7 +2482,7 @@ interface components {
             exclude_domains?: string[];
             engine?: string[];
         };
-        /** @description Search and news monitors need `q`; webpage monitors need `url` and take only `country` besides */
+        /** @description Search and news monitors need `q`; webpage monitors need `url` and take only `country` besides; AI assistant monitors need `prompt` and take `country`, `language` (not chatgpt), `web_search` (chatgpt) and `track` */
         MonitorCreateRequest: {
             q?: string;
             /**
@@ -2226,11 +2490,16 @@ interface components {
              * @description endpoint=webpage: the page to watch for content changes
              */
             url?: string;
+            /** @description AI assistant monitors: the prompt asked every run */
+            prompt?: string;
+            /** @description endpoint=chatgpt */
+            web_search?: boolean;
+            track?: components["schemas"]["TrackList"];
             /**
              * @default search
              * @enum {string}
              */
-            endpoint?: "search" | "news" | "webpage";
+            endpoint?: "search" | "news" | "webpage" | "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
             /** @description Your own JSON object (at most 2 KB), echoed on the monitor and in its webhooks */
             metadata?: {
                 [key: string]: unknown;
@@ -2282,11 +2551,14 @@ interface components {
                 [key: string]: unknown;
             } | null;
             /**
-             * @description Switching between a search and a page drops the other kind's fields
+             * @description Switching between a search, a page and an AI prompt drops the other kinds' fields
              * @enum {string}
              */
-            endpoint?: "search" | "news" | "webpage";
+            endpoint?: "search" | "news" | "webpage" | "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
             q?: string;
+            prompt?: string;
+            web_search?: boolean;
+            track?: components["schemas"]["TrackList"];
             /**
              * Format: uri
              * @description endpoint=webpage only
@@ -2311,7 +2583,7 @@ interface components {
             id: string;
             name: string;
             /** @enum {string} */
-            endpoint: "search" | "news" | "webpage";
+            endpoint: "search" | "news" | "webpage" | "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
             request: components["schemas"]["MonitorSearch"];
             metadata?: {
                 [key: string]: unknown;
@@ -2344,7 +2616,7 @@ interface components {
             status: "ok" | "error" | "webhook_failed" | "paused";
             error?: string | null;
             new_results: number;
-            /** @description The new results (OrganicResult-shaped for search, NewsResult for news, MonitorPageChange for webpage); null when there were none or after 24 hours */
+            /** @description The new results (OrganicResult-shaped for search, NewsResult for news, MonitorPageChange for webpage, one MonitorAnswer per run for AI assistants); null when there were none or after 24 hours */
             results?: {
                 [key: string]: unknown;
             }[] | null;
@@ -2370,6 +2642,19 @@ interface components {
             markdown: string;
             published_at?: string;
         };
+        /** @description What an AI assistant monitor reports every run (one item per run) */
+        MonitorAnswer: {
+            text: string;
+            markdown: string;
+            model?: string;
+            sources: components["schemas"]["AISource"][];
+            /** @description Links of the sources not seen in earlier runs */
+            new_sources: string[];
+            search_queries: string[];
+            products?: components["schemas"]["AIProduct"][];
+            /** @description With track only */
+            mentions?: components["schemas"]["Mention"][];
+        };
         MonitorRunList: {
             results: components["schemas"]["MonitorRun"][];
             /**
@@ -2394,11 +2679,13 @@ interface components {
             run_id: string;
             name: string;
             /** @enum {string} */
-            endpoint: "search" | "news" | "webpage";
-            /** @description The saved query (empty for webpage monitors) */
-            q: string;
+            endpoint: "search" | "news" | "webpage" | "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
+            /** @description The saved query (empty for webpage monitors */
+            q?: string;
             /** @description webpage monitors only */
             url?: string;
+            /** @description AI assistant monitors only (instead of q) */
+            prompt?: string;
             /** @description The monitor's metadata */
             metadata?: {
                 [key: string]: unknown;
@@ -2407,7 +2694,7 @@ interface components {
             first_run: boolean;
             /** Format: date-time */
             run_at: string;
-            /** @description Results not seen in earlier runs (OrganicResult-shaped for search, NewsResult for news, MonitorPageChange for webpage) */
+            /** @description Results not seen in earlier runs (OrganicResult-shaped for search, NewsResult for news, MonitorPageChange for webpage); for AI assistant monitors the run's answer (one MonitorAnswer, sent every run) */
             new_results: {
                 [key: string]: unknown;
             }[];
@@ -2745,6 +3032,22 @@ interface components {
             };
         };
         /** @description OK (text/markdown when format=markdown) */
+        AssistantOK: {
+            headers: {
+                "X-Credits-Used": components["headers"]["CreditsUsed"];
+                "X-Credits-Remaining": components["headers"]["CreditsRemaining"];
+                "X-Cost-USD": components["headers"]["CostUSD"];
+                "X-Cache": components["headers"]["Cache"];
+                "X-Latency-Ms": components["headers"]["LatencyMs"];
+                "X-Tokens-Estimate": components["headers"]["TokensEstimate"];
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["AssistantResponse"];
+                "text/markdown": string;
+            };
+        };
+        /** @description OK (text/markdown when format=markdown) */
         WebpageOK: {
             headers: {
                 "X-Credits-Used": components["headers"]["CreditsUsed"];
@@ -3080,6 +3383,146 @@ interface operations {
             503: components["responses"]["Unavailable"];
         };
     };
+    chatgpt: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "prompt": "What are the best CRMs for a 10-person startup?",
+                 *       "track": [
+                 *         "hubspot.com",
+                 *         "Pipedrive"
+                 *       ]
+                 *     }
+                 */
+                "application/json": components["schemas"]["ChatGPTRequest"];
+            };
+        };
+        responses: {
+            200: components["responses"]["AssistantOK"];
+            400: components["responses"]["Error"];
+            401: components["responses"]["Error"];
+            402: components["responses"]["Error"];
+            403: components["responses"]["Error"];
+            429: components["responses"]["Error"];
+            503: components["responses"]["Unavailable"];
+        };
+    };
+    gemini: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "prompt": "How do heat pumps work in cold climates?"
+                 *     }
+                 */
+                "application/json": components["schemas"]["AssistantRequest"];
+            };
+        };
+        responses: {
+            200: components["responses"]["AssistantOK"];
+            400: components["responses"]["Error"];
+            401: components["responses"]["Error"];
+            402: components["responses"]["Error"];
+            403: components["responses"]["Error"];
+            429: components["responses"]["Error"];
+            503: components["responses"]["Unavailable"];
+        };
+    };
+    copilot: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "prompt": "best mattress for side sleepers",
+                 *       "country": "us"
+                 *     }
+                 */
+                "application/json": components["schemas"]["AssistantRequest"];
+            };
+        };
+        responses: {
+            200: components["responses"]["AssistantOK"];
+            400: components["responses"]["Error"];
+            401: components["responses"]["Error"];
+            402: components["responses"]["Error"];
+            403: components["responses"]["Error"];
+            429: components["responses"]["Error"];
+            503: components["responses"]["Unavailable"];
+        };
+    };
+    aiMode: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "prompt": "how to remove a red wine stain from a wool carpet"
+                 *     }
+                 */
+                "application/json": components["schemas"]["AssistantRequest"];
+            };
+        };
+        responses: {
+            200: components["responses"]["AssistantOK"];
+            400: components["responses"]["Error"];
+            401: components["responses"]["Error"];
+            402: components["responses"]["Error"];
+            403: components["responses"]["Error"];
+            429: components["responses"]["Error"];
+            503: components["responses"]["Unavailable"];
+        };
+    };
+    braveAi: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                /**
+                 * @example {
+                 *       "prompt": "best budget noise cancelling headphones under $100"
+                 *     }
+                 */
+                "application/json": components["schemas"]["AssistantRequest"];
+            };
+        };
+        responses: {
+            200: components["responses"]["AssistantOK"];
+            400: components["responses"]["Error"];
+            401: components["responses"]["Error"];
+            402: components["responses"]["Error"];
+            403: components["responses"]["Error"];
+            429: components["responses"]["Error"];
+            503: components["responses"]["Unavailable"];
+        };
+    };
     extract: {
         parameters: {
             query?: never;
@@ -4023,6 +4466,14 @@ type WebpageParams = Schemas["WebpageRequest"];
 type RankParams = Schemas["RankRequest"];
 type MapParams = Schemas["MapRequest"];
 type ExtractParams = Schemas["ExtractRequest"];
+/**
+ * Body of `gemini`, `copilot`, `aiMode` and `braveAi`: `prompt` (required), `country`, `language`,
+ * `track` (brands and domains to look for, returned in `mentions`), `include_html`, `format`,
+ * `fields`, `max_age`.
+ */
+type AssistantParams = Schemas["AssistantRequest"];
+/** Body of `chatgpt`: like {@link AssistantParams} plus `web_search` (default true), without `language`. */
+type ChatGPTParams = Schemas["ChatGPTRequest"];
 /** `format` values accepted by the verticals. */
 type Format = NonNullable<SearchParams["format"]>;
 type Meta = Schemas["Meta"];
@@ -4073,6 +4524,18 @@ type Citation = Schemas["Citation"];
 type SearchAnswer = Schemas["SearchAnswer"];
 /** `meta.llm`: the model behind an AI response and the tokens it used. */
 type LLMUsage = Schemas["LLMUsage"];
+/** A source of an AI assistant answer or AI Overview; `cited` when the answer cites it inline. */
+type AISource = Schemas["AISource"];
+/** A product an AI assistant showed (price as shown, `extracted_price`, `currency`, merchant…). */
+type AIProduct = Schemas["AIProduct"];
+/**
+ * One `track` term checked against an AI answer: `mentioned` (the text names it), `cited` (a cited
+ * source matches it), the matching `sources` / `products` positions and `text_position` (0-1, -1
+ * when the text doesn't name it).
+ */
+type Mention = Schemas["Mention"];
+/** `ai_overview` on `search`: Google's AI Overview when the page showed one. */
+type AIOverview = Schemas["AIOverview"];
 type SearchResponse = Schemas["SearchResponse"];
 type ImagesResponse = Schemas["ImagesResponse"];
 type VideosResponse = Schemas["VideosResponse"];
@@ -4089,6 +4552,14 @@ type WebpageResponse = Schemas["WebpageResponse"];
 type RankResponse = Schemas["RankResponse"];
 type MapResponse = Schemas["MapResponse"];
 type ExtractResponse = Schemas["ExtractResponse"];
+/**
+ * Returned by `chatgpt`, `gemini`, `copilot`, `aiMode` and `braveAi`: the answer (`text`,
+ * `markdown` with `[n](link)` citations), `sources`, `search_queries`, `products`, `places`,
+ * `related_questions`, `model` where the assistant reports it, and `mentions` with `track`.
+ */
+type AssistantResponse = Schemas["AssistantResponse"];
+/** The AI assistant endpoints (also accepted by batches and monitors). */
+type AssistantEndpoint = "chatgpt" | "gemini" | "copilot" | "ai_mode" | "brave_ai";
 type Account = Schemas["Account"];
 type Status = Schemas["Status"];
 /**
@@ -4155,6 +4626,11 @@ type BatchRequestMap = {
     patents: SearchParams;
     autocomplete: SearchParams;
     webpage: WebpageParams;
+    chatgpt: ChatGPTParams;
+    gemini: AssistantParams;
+    copilot: AssistantParams;
+    ai_mode: AssistantParams;
+    brave_ai: AssistantParams;
 };
 /** Body of `POST /v1/batches`. `requests` takes the same fields as the realtime endpoint. */
 type BatchCreateParams = {
@@ -4206,7 +4682,10 @@ type ResearchTask = Omit<Schemas["ResearchTask"], "result"> & {
 type ResearchProgress = NonNullable<Schemas["ResearchTask"]["progress"]>;
 /**
  * Body of `POST /v1/monitors`. `search` and `news` monitors need `q`; `webpage` monitors need
- * `url` (and take only `country` besides) and report the page when its content changes.
+ * `url` (and take only `country` besides) and report the page when its content changes. AI
+ * assistant monitors (`chatgpt`, `gemini`, `copilot`, `ai_mode`, `brave_ai`) need `prompt` and take
+ * `country`, `language` (not chatgpt), `web_search` (chatgpt) and `track`; every run reports the
+ * answer as a {@link MonitorAnswer}.
  * `metadata` is your own JSON object (at most 2 KB), echoed on the monitor and its webhooks.
  * `webhook_url` is optional: without one, new results are read from the run history
  * (`monitors.runs`). `active: false` creates the monitor paused.
@@ -4225,7 +4704,10 @@ type MonitorUpdateParams = Omit<Schemas["MonitorUpdateRequest"], "engine"> & {
     engine?: Engine;
 };
 type Monitor = Schemas["Monitor"];
-/** What a monitor watches: a `search`, `news` search, or a `webpage` for content changes. */
+/**
+ * What a monitor watches: a `search`, `news` search, a `webpage` for content changes, or an AI
+ * assistant's answer to a prompt (`chatgpt`, `gemini`, `copilot`, `ai_mode`, `brave_ai`).
+ */
 type MonitorEndpoint = Monitor["endpoint"];
 /** Your own JSON object on a monitor (at most 2 KB), echoed in `monitor.results`. */
 type MonitorMetadata = NonNullable<Monitor["metadata"]>;
@@ -4234,13 +4716,19 @@ type MonitorMetadata = NonNullable<Monitor["metadata"]>;
  * the page when first seen (`change: "new"`) or when its content changed (`"changed"`).
  */
 type MonitorPageChange = Schemas["MonitorPageChange"];
+/**
+ * The result item of an AI assistant monitor: one per run (every run reports the answer), with
+ * `new_sources` (source links not seen in earlier runs) and, with `track`, `mentions`.
+ */
+type MonitorAnswer = Schemas["MonitorAnswer"];
 /** `last_status` of a monitor; `"paused"` after 10 failed runs in a row. */
 type MonitorStatus = NonNullable<Monitor["last_status"]>;
 type MonitorList = Schemas["MonitorList"];
 type MonitorSearch = Schemas["MonitorSearch"];
 /**
  * One run of a monitor. `results` holds the new results (null when none, or after 24 hours):
- * `OrganicResult`-shaped for search, `NewsResult` for news, {@link MonitorPageChange} for webpage.
+ * `OrganicResult`-shaped for search, `NewsResult` for news, {@link MonitorPageChange} for webpage,
+ * one {@link MonitorAnswer} for AI assistants.
  */
 type MonitorRun = Schemas["MonitorRun"];
 /** A page of runs, newest first. Pass `next_before` as `before` for the next page. */
@@ -4266,7 +4754,8 @@ type ResearchCompletedEvent = Omit<TaskCompletedEvent, "event" | "kind" | "resul
 /**
  * Body of `monitor.results`. `run_id` is also the `X-SerpKite-Delivery` header (dedupe retries
  * on it). Carries the monitor's `metadata`, and `url` for webpage monitors (whose `new_results`
- * are {@link MonitorPageChange} items and `q` is empty).
+ * are {@link MonitorPageChange} items and `q` is empty). AI assistant monitors send `prompt`
+ * instead of `q` and one {@link MonitorAnswer} in `new_results`.
  */
 type MonitorResultsEvent = Schemas["MonitorResultsEvent"];
 /** `X-SerpKite-Event` values. Plain strings stay accepted for events added later. */
@@ -4290,7 +4779,7 @@ type WebhookEvent = {
     data: MonitorResultsEvent;
 };
 
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.8.0";
 declare const DEFAULT_BASE_URL = "https://api.serpkite.com";
 interface SerpKiteOptions {
     /** API key (`skt_live_…`). Defaults to the `SERPKITE_API_KEY` environment variable. */
@@ -4366,6 +4855,8 @@ interface VerticalMethod<P, R> {
     (params: P, options?: RequestOptions): Promise<R | CompactResponse | string>;
 }
 type Method = "GET" | "POST" | "PATCH" | "DELETE";
+/** Minimum per-attempt timeout of the AI assistant methods: answers take 10-90 s. */
+declare const ASSISTANT_TIMEOUT_MS = 120000;
 interface Call {
     method: Method;
     path: string;
@@ -4393,6 +4884,7 @@ declare class SerpKite {
         top_stories?: components["schemas"]["NewsResult"][];
         places?: components["schemas"]["PlaceResult"][];
         answer?: components["schemas"]["SearchAnswer"];
+        ai_overview?: components["schemas"]["AIOverview"];
         meta: components["schemas"]["Meta"];
     }>;
     /** Google Images. */
@@ -4504,6 +4996,131 @@ declare class SerpKite {
         image_links?: string[];
         meta: components["schemas"]["Meta"];
     }>;
+    /**
+     * Ask ChatGPT as a logged-out user: the answer (`text`, `markdown`), cited `sources`,
+     * `search_queries`, `products`, `places` and the guest `model`. `web_search` (default true)
+     * makes it search the web; `country` asks from an exit in that country. `track` returns
+     * `mentions` of your brands and domains. 5 credits.
+     */
+    readonly chatgpt: VerticalMethod<{
+        prompt: string;
+        web_search?: boolean;
+        country?: string;
+        track?: components["schemas"]["TrackList"];
+        include_html?: boolean;
+        format?: "json" | "markdown" | "compact";
+        fields?: string;
+        max_age?: number;
+    }, {
+        request: components["schemas"]["AssistantEcho"];
+        text: string;
+        markdown: string;
+        html?: string;
+        model?: string;
+        sources: components["schemas"]["AISource"][];
+        search_queries: string[];
+        products: components["schemas"]["AIProduct"][];
+        places?: components["schemas"]["PlaceResult"][];
+        related_questions?: string[];
+        mentions?: components["schemas"]["Mention"][];
+        meta: components["schemas"]["Meta"];
+    }>;
+    /** Ask Google Gemini as a logged-out user: the answer with the sources it grounded on. 5 credits. */
+    readonly gemini: VerticalMethod<{
+        prompt: string;
+        country?: string;
+        language?: string;
+        track?: components["schemas"]["TrackList"];
+        include_html?: boolean;
+        format?: "json" | "markdown" | "compact";
+        fields?: string;
+        max_age?: number;
+    }, {
+        request: components["schemas"]["AssistantEcho"];
+        text: string;
+        markdown: string;
+        html?: string;
+        model?: string;
+        sources: components["schemas"]["AISource"][];
+        search_queries: string[];
+        products: components["schemas"]["AIProduct"][];
+        places?: components["schemas"]["PlaceResult"][];
+        related_questions?: string[];
+        mentions?: components["schemas"]["Mention"][];
+        meta: components["schemas"]["Meta"];
+    }>;
+    /** Microsoft Copilot Search on Bing: the answer, cited sources and products. 3 credits. */
+    readonly copilot: VerticalMethod<{
+        prompt: string;
+        country?: string;
+        language?: string;
+        track?: components["schemas"]["TrackList"];
+        include_html?: boolean;
+        format?: "json" | "markdown" | "compact";
+        fields?: string;
+        max_age?: number;
+    }, {
+        request: components["schemas"]["AssistantEcho"];
+        text: string;
+        markdown: string;
+        html?: string;
+        model?: string;
+        sources: components["schemas"]["AISource"][];
+        search_queries: string[];
+        products: components["schemas"]["AIProduct"][];
+        places?: components["schemas"]["PlaceResult"][];
+        related_questions?: string[];
+        mentions?: components["schemas"]["Mention"][];
+        meta: components["schemas"]["Meta"];
+    }>;
+    /** Google AI Mode: the answer, cited sources and products. 3 credits. */
+    readonly aiMode: VerticalMethod<{
+        prompt: string;
+        country?: string;
+        language?: string;
+        track?: components["schemas"]["TrackList"];
+        include_html?: boolean;
+        format?: "json" | "markdown" | "compact";
+        fields?: string;
+        max_age?: number;
+    }, {
+        request: components["schemas"]["AssistantEcho"];
+        text: string;
+        markdown: string;
+        html?: string;
+        model?: string;
+        sources: components["schemas"]["AISource"][];
+        search_queries: string[];
+        products: components["schemas"]["AIProduct"][];
+        places?: components["schemas"]["PlaceResult"][];
+        related_questions?: string[];
+        mentions?: components["schemas"]["Mention"][];
+        meta: components["schemas"]["Meta"];
+    }>;
+    /** Brave Search's AI answer: cited sources, the searches it ran and products. 2 credits. */
+    readonly braveAi: VerticalMethod<{
+        prompt: string;
+        country?: string;
+        language?: string;
+        track?: components["schemas"]["TrackList"];
+        include_html?: boolean;
+        format?: "json" | "markdown" | "compact";
+        fields?: string;
+        max_age?: number;
+    }, {
+        request: components["schemas"]["AssistantEcho"];
+        text: string;
+        markdown: string;
+        html?: string;
+        model?: string;
+        sources: components["schemas"]["AISource"][];
+        search_queries: string[];
+        products: components["schemas"]["AIProduct"][];
+        places?: components["schemas"]["PlaceResult"][];
+        related_questions?: string[];
+        mentions?: components["schemas"]["Mention"][];
+        meta: components["schemas"]["Meta"];
+    }>;
     /** Position of `domain` for keyword `q` in the top `num` results (default 100). */
     rank(params: RankParams, options?: RequestOptions): Promise<RankResponse>;
     /**
@@ -4605,7 +5222,9 @@ declare class SerpKite {
          * and reports it (`MonitorPageChange`) when its content changes. `metadata` (your JSON
          * object, at most 2 KB) is echoed on the monitor and in its webhooks. Without a
          * `webhook_url`, read new results from `monitors.runs`. `active: false`
-         * creates it paused. A monitor pauses itself after 10 failed runs in a row
+         * creates it paused. With an AI assistant `endpoint` (`chatgpt`, `gemini`, `copilot`,
+         * `ai_mode`, `brave_ai`) and a `prompt` every run reports the answer (`MonitorAnswer`:
+         * sources, `new_sources`, `mentions` with `track`). A monitor pauses itself after 10 failed runs in a row
          * (`last_status: "paused"`); `update(id, { active: true })` resumes it. Each run costs
          * what its search costs. Only retried on 429.
          */
@@ -4740,4 +5359,4 @@ declare function verifyWebhook(secret: string, payload: string | Uint8Array, hea
  */
 declare function parseWebhook(secret: string, payload: string | Uint8Array, headers: HeaderSource, options?: VerifyWebhookOptions): Promise<WebhookEvent>;
 
-export { type Account, type AnswerBox, type AnswerMeta, type AnswerParams, type AnswerResponse, type AnswerSource, type AnswerStreamDelta, type AnswerStreamDone, type AnswerStreamEvent, type AnswerStreamResults, type AutocompleteResponse, type Batch, type BatchCompletedEvent, type BatchCreateEntry, type BatchCreateError, type BatchCreateOptions, type BatchCreateParams, type BatchCreateResponse, type BatchEndpoint, type BatchStatus, type Citation, type CompactResponse, type CrawlPage, type CrawlParams, type CrawlResult, type CrawlSitemapMode, type CrawlStats, type CrawlStopReason, type CrawlTask, DEFAULT_BASE_URL, type DomainList, type Engine, type ErrorBody, type ExtractFailure, type ExtractParams, type ExtractResponse, type ExtractResult, type Format, type Highlight, type HoursInterval, type ImageResult, type ImagesResponse, type KnowledgeGraph, type LLMUsage, type MapParams, type MapResponse, type MapURL, type MapsResponse, type Meta, type Monitor, type MonitorCreateParams, type MonitorEndpoint, type MonitorList, type MonitorMetadata, type MonitorPageChange, type MonitorResultsEvent, type MonitorRun, type MonitorRunList, type MonitorRunsParams, type MonitorSearch, type MonitorStatus, type MonitorUpdateParams, type NewsResponse, type NewsResult, type OrganicResult, type PageLink, type PageMetadata, type PatentResult, type PatentsResponse, type PeopleAlsoAsk, type PlaceParams, type PlacePhoto, type PlaceResult, type PlacesResponse, type Provider, type RankMatch, type RankParams, type RankResponse, type RelatedSearch, type RequestEcho, type RequestOptions, type ResearchCompletedEvent, type ResearchEffort, type ResearchParams, type ResearchProgress, type ResearchResult, type ResearchSource, type ResearchTask, type ResponseInfo, type ReviewResult, type ReviewsParams, type ReviewsResponse, type RouteOutcome, type RouteStep, type ScholarResponse, type ScholarResult, type SearchAnswer, type SearchParams, type SearchResponse, SerpKite, SerpKiteError, type SerpKiteOptions, type ShoppingResponse, type ShoppingResult, type Sitelink, type Status, type Suggestion, type TaskCancelResponse, type TaskCompletedEvent, type TaskCreated, type TaskError, type TaskStatus, VERSION, type VerifyWebhookOptions, type VerticalMethod, type VideoResult, type VideosResponse, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebpageParams, type WebpageResponse, type WeeklyHours, type components, isBatchError, type operations, parseRetryAfter, parseWebhook, type paths, verifyWebhook };
+export { type AIOverview, type AIProduct, type AISource, ASSISTANT_TIMEOUT_MS, type Account, type AnswerBox, type AnswerMeta, type AnswerParams, type AnswerResponse, type AnswerSource, type AnswerStreamDelta, type AnswerStreamDone, type AnswerStreamEvent, type AnswerStreamResults, type AssistantEndpoint, type AssistantParams, type AssistantResponse, type AutocompleteResponse, type Batch, type BatchCompletedEvent, type BatchCreateEntry, type BatchCreateError, type BatchCreateOptions, type BatchCreateParams, type BatchCreateResponse, type BatchEndpoint, type BatchStatus, type ChatGPTParams, type Citation, type CompactResponse, type CrawlPage, type CrawlParams, type CrawlResult, type CrawlSitemapMode, type CrawlStats, type CrawlStopReason, type CrawlTask, DEFAULT_BASE_URL, type DomainList, type Engine, type ErrorBody, type ExtractFailure, type ExtractParams, type ExtractResponse, type ExtractResult, type Format, type Highlight, type HoursInterval, type ImageResult, type ImagesResponse, type KnowledgeGraph, type LLMUsage, type MapParams, type MapResponse, type MapURL, type MapsResponse, type Mention, type Meta, type Monitor, type MonitorAnswer, type MonitorCreateParams, type MonitorEndpoint, type MonitorList, type MonitorMetadata, type MonitorPageChange, type MonitorResultsEvent, type MonitorRun, type MonitorRunList, type MonitorRunsParams, type MonitorSearch, type MonitorStatus, type MonitorUpdateParams, type NewsResponse, type NewsResult, type OrganicResult, type PageLink, type PageMetadata, type PatentResult, type PatentsResponse, type PeopleAlsoAsk, type PlaceParams, type PlacePhoto, type PlaceResult, type PlacesResponse, type Provider, type RankMatch, type RankParams, type RankResponse, type RelatedSearch, type RequestEcho, type RequestOptions, type ResearchCompletedEvent, type ResearchEffort, type ResearchParams, type ResearchProgress, type ResearchResult, type ResearchSource, type ResearchTask, type ResponseInfo, type ReviewResult, type ReviewsParams, type ReviewsResponse, type RouteOutcome, type RouteStep, type ScholarResponse, type ScholarResult, type SearchAnswer, type SearchParams, type SearchResponse, SerpKite, SerpKiteError, type SerpKiteOptions, type ShoppingResponse, type ShoppingResult, type Sitelink, type Status, type Suggestion, type TaskCancelResponse, type TaskCompletedEvent, type TaskCreated, type TaskError, type TaskStatus, VERSION, type VerifyWebhookOptions, type VerticalMethod, type VideoResult, type VideosResponse, type WaitOptions, type WebhookEvent, type WebhookEventType, type WebpageParams, type WebpageResponse, type WeeklyHours, type components, isBatchError, type operations, parseRetryAfter, parseWebhook, type paths, verifyWebhook };