scavio 0.25.0 → 0.26.0

package/README.md

@@ -1,13 +1,14 @@
 # Scavio
 
 TypeScript SDK for the [Scavio API](https://scavio.dev?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) — real-time structured web
-data across 36 platforms on one API key, plus `extract()` to read
+data across 38 platforms on one API key, plus `extract()` to read
 any URL as clean Markdown, and `extract.map()` / `extract.crawl()` /
 `extract.batch()` to map, crawl and batch-extract whole websites.
 
 Structured JSON in, structured JSON out. No per-site parsers to maintain.
 
 - **Search and SERP** — Google (organic, news, maps, shopping, flights, hotels, trends, AI Mode)
+- **AI assistants** — ChatGPT and Gemini answers with the sources they cite and the products they recommend
 - **E-commerce** — Amazon, Walmart, Costco, Mercado Libre, eBay, Target, Home Depot, TikTok Shop
 - **Real estate and travel** — Zillow, Redfin, Realtor.com, Rightmove, Booking, Airbnb, Tripadvisor
 - **Reviews and local** — Trustpilot, Yelp, G2, Capterra, Glassdoor, App Store, Google Play
@@ -288,6 +289,36 @@ accepted and ignored. Parameters that cannot be honoured (image search, `sort`,
 SERP (knowledge graph, AI overview, People Also Ask) use `google.search`.
 [Docs](https://scavio.dev/docs/google-custom-search-api?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
 
+### ChatGPT and Gemini (new in 0.26.0)
+
+Send the prompt a buyer would ask and get the answer the assistant gives: the
+full Markdown answer, the pages it cites, the web searches it ran (ChatGPT) and
+the products it recommended. Both return the same shape under `data`, so one
+parser tracks which brands each assistant recommends. 5 credits per answered
+prompt; a failed prompt is not charged. Answers take 10-40 seconds, so both
+methods raise the request timeout to 120s when the client's is shorter.
+
+```typescript
+const prompt = "What are the best CRM tools for small agencies?";
+
+const chatgpt = await client.chatgpt.prompt({ prompt, country: "us" });
+const gemini = await client.gemini.prompt({ prompt });
+
+for (const { data } of [chatgpt, gemini] as any[]) {
+  console.log(data.platform, "mentions HubSpot:", data.answer.markdown.includes("HubSpot"));
+  console.log("  cited:", data.sources.slice(0, 5).map((s: any) => s.url));
+  console.log("  products:", data.shopping.map((p: any) => p.title));
+}
+
+// ChatGPT also returns each source's title and publisher and the searches it ran.
+console.log((chatgpt as any).data.search_queries);
+```
+
+Options: `chatgpt.prompt({ prompt, model?, country?, include_html? })` (prompt up
+to 1024 characters) and `gemini.prompt({ prompt })` (up to 4000).
+[ChatGPT docs](https://scavio.dev/docs/chatgpt-api?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) |
+[Gemini docs](https://scavio.dev/docs/gemini-api?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
+
 ### Amazon
 
 Responses are normalized to a stable shape (see the breaking-change note

package/dist/index.cjs

@@ -30,18 +30,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  AI_PROMPT_TIMEOUT: () => AI_PROMPT_TIMEOUT,
   AirbnbNamespace: () => AirbnbNamespace,
   AmazonNamespace: () => AmazonNamespace,
   AppStoreNamespace: () => AppStoreNamespace,
   BadRequestError: () => BadRequestError,
   BookingNamespace: () => BookingNamespace,
   CapterraNamespace: () => CapterraNamespace,
+  ChatgptNamespace: () => ChatgptNamespace,
   CompaniesHouseNamespace: () => CompaniesHouseNamespace,
   CostcoNamespace: () => CostcoNamespace,
   DEFAULT_MAX_REQUESTS_PER_SECOND: () => DEFAULT_MAX_REQUESTS_PER_SECOND,
   EbayNamespace: () => EbayNamespace,
   ExtractNamespace: () => ExtractNamespace,
   G2Namespace: () => G2Namespace,
+  GeminiNamespace: () => GeminiNamespace,
   GlassdoorNamespace: () => GlassdoorNamespace,
   GoogleAdsNamespace: () => GoogleAdsNamespace,
   GoogleNamespace: () => GoogleNamespace,
@@ -232,7 +235,7 @@ function parseRetryAfter(header) {
 var BASE_URL = "https://api.scavio.dev";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
-var SDK_VERSION = true ? "0.25.0" : "0.0.0";
+var SDK_VERSION = true ? "0.26.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -2816,6 +2819,43 @@ var TrustpilotNamespace = class {
   }
 };
 
+// src/namespaces/chatgpt.ts
+var AI_PROMPT_TIMEOUT = 12e4;
+var ChatgptNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Send a prompt to ChatGPT and get the answer it gives: the full Markdown
+   * answer, every page it cites (title, publisher, date), the web searches it
+   * ran and the products it recommended. Built for AI visibility monitoring.
+   *
+   * Costs 5 credits per answered prompt; failed prompts are not charged.
+   */
+  async prompt(options) {
+    return this.client._post("/api/v1/chatgpt/prompt", options, void 0, AI_PROMPT_TIMEOUT);
+  }
+};
+
+// src/namespaces/gemini.ts
+var GeminiNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Send a prompt to Google Gemini and get the answer it gives as Markdown,
+   * with the URLs it cites and the products it recommended. Same response
+   * shape as chatgpt.prompt().
+   *
+   * Costs 5 credits per answered prompt; failed prompts are not charged.
+   */
+  async prompt(options) {
+    return this.client._post("/api/v1/gemini/prompt", options, void 0, AI_PROMPT_TIMEOUT);
+  }
+};
+
 // src/namespaces/realtor.ts
 var RealtorNamespace = class {
   constructor(client) {
@@ -3218,6 +3258,8 @@ var Scavio = class extends ScavioCore {
   metaAds;
   costco;
   trustpilot;
+  chatgpt;
+  gemini;
   realtor;
   rightmove;
   mercadolibre;
@@ -3275,6 +3317,8 @@ var Scavio = class extends ScavioCore {
     this.metaAds = new MetaAdsNamespace(this);
     this.costco = new CostcoNamespace(this);
     this.trustpilot = new TrustpilotNamespace(this);
+    this.chatgpt = new ChatgptNamespace(this);
+    this.gemini = new GeminiNamespace(this);
     this.realtor = new RealtorNamespace(this);
     this.rightmove = new RightmoveNamespace(this);
     this.mercadolibre = new MercadoLibreNamespace(this);
@@ -3290,13 +3334,13 @@ var Scavio = class extends ScavioCore {
     });
   }
   /** @internal */
-  async _post(path, body, headers) {
+  async _post(path, body, headers, minTimeout) {
     return request({
       method: "POST",
       path,
       apiKey: this.apiKey,
       baseUrl: this.baseUrl,
-      timeout: this.timeout,
+      timeout: Math.max(this.timeout, minTimeout ?? 0),
       maxRetries: this.maxRetries,
       rateLimiter: this.rateLimiter,
       body,
@@ -3381,18 +3425,21 @@ async function getSubtle() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AI_PROMPT_TIMEOUT,
   AirbnbNamespace,
   AmazonNamespace,
   AppStoreNamespace,
   BadRequestError,
   BookingNamespace,
   CapterraNamespace,
+  ChatgptNamespace,
   CompaniesHouseNamespace,
   CostcoNamespace,
   DEFAULT_MAX_REQUESTS_PER_SECOND,
   EbayNamespace,
   ExtractNamespace,
   G2Namespace,
+  GeminiNamespace,
   GlassdoorNamespace,
   GoogleAdsNamespace,
   GoogleNamespace,