scrapebadger 0.3.1 → 0.7.0

package/dist/index.mjs

@@ -704,6 +704,59 @@ var TweetsClient = class {
     };
     yield* paginate(fetchPage, options);
   }
+  /**
+   * Get the edit history of a tweet.
+   *
+   * @param tweetId - The tweet ID to get edit history for.
+   * @returns Paginated response containing tweet versions.
+   *
+   * @example
+   * ```typescript
+   * const history = await client.twitter.tweets.getEditHistory("1234567890");
+   * console.log(`${history.data.length} version(s) of this tweet`);
+   * ```
+   */
+  async getEditHistory(tweetId) {
+    const response = await this.client.request(
+      `/v1/twitter/tweets/tweet/${tweetId}/edit_history`
+    );
+    return createPaginatedResponse(response.data ?? [], void 0);
+  }
+  /**
+   * Get community notes (Birdwatch) attached to a tweet.
+   *
+   * @param tweetId - The tweet ID to get community notes for.
+   * @returns Paginated response containing community notes.
+   *
+   * @example
+   * ```typescript
+   * const notes = await client.twitter.tweets.getCommunityNotes("1234567890");
+   * for (const note of notes.data) {
+   *   console.log(note.text);
+   * }
+   * ```
+   */
+  async getCommunityNotes(tweetId) {
+    const response = await this.client.request(
+      `/v1/twitter/tweets/tweet/${tweetId}/community_notes`
+    );
+    return createPaginatedResponse(response.data ?? [], void 0);
+  }
+  /**
+   * Get a long-form article by its ID.
+   *
+   * @param articleId - The article ID to fetch.
+   * @returns The article data.
+   *
+   * @example
+   * ```typescript
+   * const article = await client.twitter.tweets.getArticle("abc123");
+   * console.log(`${article.title}: ${article.text?.slice(0, 100)}...`);
+   * ```
+   */
+  async getArticle(articleId) {
+    return this.client.request(`/v1/twitter/tweets/article/${articleId}`);
+  }
 };
 
 // src/twitter/users.ts
@@ -1015,6 +1068,92 @@ var UsersClient = class {
     };
     yield* paginate(fetchPage, options);
   }
+  /**
+   * Get multiple users by their numeric IDs in a single request.
+   *
+   * @param userIds - List of user IDs to fetch.
+   * @returns Paginated response containing the matching users.
+   *
+   * @example
+   * ```typescript
+   * const users = await client.twitter.users.getByIds(["44196397", "783214"]);
+   * for (const user of users.data) {
+   *   console.log(`@${user.username}`);
+   * }
+   * ```
+   */
+  async getByIds(userIds) {
+    const response = await this.client.request(
+      "/v1/twitter/users/batch_by_ids",
+      { params: { user_ids: userIds.join(",") } }
+    );
+    return createPaginatedResponse(response.data ?? [], void 0);
+  }
+  /**
+   * Get multiple users by their usernames in a single request.
+   *
+   * @param usernames - List of usernames (without @) to fetch.
+   * @returns Paginated response containing the matching users.
+   *
+   * @example
+   * ```typescript
+   * const users = await client.twitter.users.getByUsernames(["elonmusk", "twitter"]);
+   * for (const user of users.data) {
+   *   console.log(`${user.name}: ${user.followers_count?.toLocaleString()} followers`);
+   * }
+   * ```
+   */
+  async getByUsernames(usernames) {
+    const response = await this.client.request(
+      "/v1/twitter/users/batch_by_usernames",
+      { params: { usernames: usernames.join(",") } }
+    );
+    return createPaginatedResponse(response.data ?? [], void 0);
+  }
+  /**
+   * Get tweets that mention a user.
+   *
+   * @param username - The user's username (without @).
+   * @param options - Pagination options with optional count.
+   * @returns Paginated response containing tweets mentioning the user.
+   *
+   * @example
+   * ```typescript
+   * const mentions = await client.twitter.users.getMentions("elonmusk");
+   * for (const tweet of mentions.data) {
+   *   console.log(`@${tweet.username}: ${tweet.text.slice(0, 100)}...`);
+   * }
+   * ```
+   */
+  async getMentions(username, options = {}) {
+    const response = await this.client.request(
+      `/v1/twitter/users/${username}/mentions`,
+      { params: { count: options.count, cursor: options.cursor } }
+    );
+    return createPaginatedResponse(response.data ?? [], response.next_cursor);
+  }
+  /**
+   * Get long-form articles authored by a user.
+   *
+   * @param userId - The user's numeric ID.
+   * @param options - Pagination options with optional count.
+   * @returns Paginated response containing the user's articles as tweets.
+   *
+   * @example
+   * ```typescript
+   * const articles = await client.twitter.users.getArticles("44196397");
+   * for (const article of articles.data) {
+   *   console.log(article.text?.slice(0, 100));
+   * }
+   * ```
+   */
+  async getArticles(userId, options = {}) {
+    const response = await this.client.request(
+      `/v1/twitter/users/${userId}/articles`,
+      { params: { count: options.count, cursor: options.cursor } }
+    );
+    return createPaginatedResponse(response.data ?? [], response.next_cursor);
+  }
 };
 
 // src/twitter/lists.ts
@@ -1161,6 +1300,29 @@ var ListsClient = class {
     );
     return createPaginatedResponse(response.data ?? [], response.next_cursor);
   }
+  /**
+   * Search tweets within a specific list.
+   *
+   * @param listId - The list ID to search within.
+   * @param query - Search query string.
+   * @param options - Pagination options with optional count.
+   * @returns Paginated response containing matching tweets from the list.
+   *
+   * @example
+   * ```typescript
+   * const results = await client.twitter.lists.searchTweets("123456", "python");
+   * for (const tweet of results.data) {
+   *   console.log(`@${tweet.username}: ${tweet.text.slice(0, 100)}...`);
+   * }
+   * ```
+   */
+  async searchTweets(listId, query, options = {}) {
+    const response = await this.client.request(
+      `/v1/twitter/lists/${listId}/search_tweets`,
+      { params: { query, count: options.count, cursor: options.cursor } }
+    );
+    return createPaginatedResponse(response.data ?? [], response.next_cursor);
+  }
 };
 
 // src/twitter/communities.ts
@@ -2024,7 +2186,7 @@ var StreamClient = class {
           return;
         }
         if (!reconnect) {
-          const reasonStr = reason instanceof Buffer ? reason.toString() : String(reason ?? "");
+          const reasonStr = reason instanceof Buffer ? reason.toString() : typeof reason === "string" ? reason : "";
           emitter.emit(
             "error",
             new WebSocketStreamError(`WebSocket closed: ${reasonStr || String(code)}`)
@@ -2182,6 +2344,46 @@ function verifyWebhookSignature(secret, body, signatureHeader) {
   }
 }
 
+// src/twitter/spaces.ts
+var SpacesClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get details for a specific Twitter Space.
+   *
+   * @param spaceId - The Space ID to fetch.
+   * @returns The Space data.
+   * @throws NotFoundError - If the Space doesn't exist.
+   *
+   * @example
+   * ```typescript
+   * const space = await client.twitter.spaces.getDetail("1eaKbrPPbPwKX");
+   * console.log(`${space.title} — ${space.participant_count} participants`);
+   * ```
+   */
+  async getDetail(spaceId) {
+    return this.client.request(`/v1/twitter/spaces/${spaceId}`);
+  }
+  /**
+   * Get details for a live video broadcast.
+   *
+   * @param broadcastId - The broadcast ID to fetch.
+   * @returns The broadcast data.
+   * @throws NotFoundError - If the broadcast doesn't exist.
+   *
+   * @example
+   * ```typescript
+   * const broadcast = await client.twitter.spaces.getBroadcast("broadcast123");
+   * console.log(`${broadcast.title}: ${broadcast.total_viewers} viewers`);
+   * ```
+   */
+  async getBroadcast(broadcastId) {
+    return this.client.request(`/v1/twitter/spaces/broadcast/${broadcastId}`);
+  }
+};
+
 // src/twitter/client.ts
 var TwitterClient = class {
   /** Client for tweet operations */
@@ -2198,6 +2400,8 @@ var TwitterClient = class {
   geo;
   /** Client for real-time stream monitor management and WebSocket streaming */
   stream;
+  /** Client for Twitter Spaces and live broadcast operations */
+  spaces;
   /**
    * Create a new Twitter client.
    *
@@ -2211,6 +2415,7 @@ var TwitterClient = class {
     this.trends = new TrendsClient(client);
     this.geo = new GeoClient(client);
     this.stream = new StreamClient(client);
+    this.spaces = new SpacesClient(client);
   }
 };
 
@@ -2222,94 +2427,845 @@ var WebClient = class {
   }
   /**
    * Scrape a web page.
+   *
+   * @param url - The URL to scrape
+   * @param options - Scrape configuration options
+   * @returns The scrape result including content, metadata, and credit usage
    */
   async scrape(url, options = {}) {
     const body = { url };
-    if (options.renderJs) body.render_js = true;
-    if (options.outputFormat && options.outputFormat !== "html")
-      body.output_format = options.outputFormat;
-    if (options.proxyCountry) body.proxy_country = options.proxyCountry;
-    if (options.proxyType) body.proxy_type = options.proxyType;
-    if (options.sessionId) body.session_id = options.sessionId;
-    if (options.engine) body.engine = options.engine;
+    if (options.format !== void 0) body.format = options.format;
+    if (options.renderJs !== void 0) body.render_js = options.renderJs;
+    if (options.engine !== void 0) body.engine = options.engine;
+    if (options.waitFor !== void 0) body.wait_for = options.waitFor;
+    if (options.waitTimeout !== void 0) body.wait_timeout = options.waitTimeout;
+    if (options.waitAfterLoad !== void 0) body.wait_after_load = options.waitAfterLoad;
+    if (options.jsScenario !== void 0) body.js_scenario = options.jsScenario;
+    if (options.sessionId !== void 0) body.session_id = options.sessionId;
+    if (options.retryCount !== void 0) body.retry_count = options.retryCount;
+    if (options.retryOnBlock !== void 0) body.retry_on_block = options.retryOnBlock;
+    if (options.country !== void 0) body.country = options.country;
+    if (options.customHeaders !== void 0) body.custom_headers = options.customHeaders;
+    if (options.screenshot !== void 0) body.screenshot = options.screenshot;
+    if (options.video !== void 0) body.video = options.video;
+    if (options.antiBot !== void 0) body.anti_bot = options.antiBot;
+    if (options.escalate !== void 0) body.escalate = options.escalate;
     if (options.maxCost !== void 0) body.max_cost = options.maxCost;
-    if (options.headers) body.headers = options.headers;
-    if (options.waitFor) body.wait_for = options.waitFor;
-    if (options.timeout !== void 0) body.timeout = options.timeout;
-    if (options.jsScenario) body.js_scenario = options.jsScenario;
+    if (options.aiExtract !== void 0) body.ai_extract = options.aiExtract;
+    if (options.aiPrompt !== void 0) body.ai_prompt = options.aiPrompt;
+    if (options.rawContent !== void 0) body.raw_content = options.rawContent;
+    if (options.skipBotDetection !== void 0) body.skip_bot_detection = options.skipBotDetection;
     return this.client.request("/v1/web/scrape", {
       method: "POST",
       body
     });
   }
   /**
-   * Take a screenshot of a web page.
+   * Extract structured data from a web page using AI.
+   *
+   * Convenience wrapper around {@link scrape} that enables AI extraction
+   * with the given prompt and defaults to markdown format.
+   *
+   * @param url - The URL to extract data from
+   * @param prompt - Natural language prompt describing what to extract (max 2000 chars)
+   * @param options - Additional scrape options (aiExtract and aiPrompt are set automatically)
+   * @returns The scrape result with ai_extraction populated
    */
-  async screenshot(url, options = {}) {
-    const body = { url };
-    if (options.fullPage) body.full_page = true;
-    if (options.viewportWidth && options.viewportWidth !== 1280)
-      body.viewport_width = options.viewportWidth;
-    if (options.viewportHeight && options.viewportHeight !== 720)
-      body.viewport_height = options.viewportHeight;
-    if (options.imageFormat && options.imageFormat !== "png")
-      body.image_format = options.imageFormat;
-    if (options.waitFor) body.wait_for = options.waitFor;
-    if (options.timeout !== void 0) body.timeout = options.timeout;
-    return this.client.request("/v1/web/screenshot", {
-      method: "POST",
-      body
+  async extract(url, prompt, options = {}) {
+    return this.scrape(url, {
+      format: "markdown",
+      ...options,
+      aiExtract: true,
+      aiPrompt: prompt
     });
   }
   /**
-   * Extract structured data from a web page.
+   * Detect anti-bot systems on a URL.
+   *
+   * @param url - The URL to analyze
+   * @param options - Detection options
+   * @returns Detection results including identified anti-bot and captcha systems
    */
-  async extract(url, options = {}) {
+  async detect(url, options = {}) {
     const body = { url };
-    if (options.schema) body.extraction_schema = options.schema;
-    if (options.renderJs) body.render_js = true;
-    if (options.waitFor) body.wait_for = options.waitFor;
     if (options.timeout !== void 0) body.timeout = options.timeout;
-    return this.client.request("/v1/web/extract", {
+    if (options.country !== void 0) body.country = options.country;
+    return this.client.request("/v1/web/detect", {
       method: "POST",
       body
     });
   }
+};
+
+// src/vinted/search.ts
+var SearchClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
   /**
-   * Scrape multiple URLs in a batch.
+   * Search for Vinted items.
+   *
+   * @param params - Search parameters including query, filters, and pagination.
+   * @returns Search results with items and pagination metadata.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the search parameters are invalid.
+   *
+   * @example
+   * ```typescript
+   * const results = await client.vinted.search.search({
+   *   query: "vintage jacket",
+   *   market: "fr",
+   *   page: 1,
+   *   per_page: 20,
+   *   order: "newest_first",
+   * });
+   * console.log(`Found ${results.pagination.total_entries} items`);
+   * ```
    */
-  async batch(urls, options = {}) {
-    const body = { urls };
-    if (options.renderJs) body.render_js = true;
-    if (options.outputFormat && options.outputFormat !== "html")
-      body.output_format = options.outputFormat;
-    if (options.maxConcurrency && options.maxConcurrency !== 5)
-      body.max_concurrency = options.maxConcurrency;
-    if (options.engine) body.engine = options.engine;
-    if (options.timeout !== void 0) body.timeout = options.timeout;
-    return this.client.request("/v1/web/batch", {
-      method: "POST",
-      body
+  async search(params) {
+    return this.client.request("/v1/vinted/search", {
+      params: {
+        query: params.query,
+        market: params.market,
+        page: params.page,
+        per_page: params.per_page,
+        price_from: params.price_from,
+        price_to: params.price_to,
+        brand_ids: params.brand_ids,
+        color_ids: params.color_ids,
+        status_ids: params.status_ids,
+        order: params.order
+      }
     });
   }
+};
+
+// src/vinted/items.ts
+var ItemsClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
   /**
-   * Create a new scraping session for a domain.
+   * Get a single item by ID.
+   *
+   * @param itemId - The Vinted item ID to fetch.
+   * @param options - Optional parameters.
+   * @param options.market - Market code (default: "fr").
+   * @returns The item detail response including full item data.
+   * @throws NotFoundError - If the item doesn't exist.
+   * @throws AuthenticationError - If the API key is invalid.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.items.get(123456789);
+   * const { item } = response;
+   * console.log(`${item.title}: ${item.description}`);
+   * console.log(`Brand: ${item.brand_title}, Size: ${item.size_title}`);
+   * console.log(`Photos: ${item.photos.length}`);
+   * ```
    */
-  async createSession(domain, persist = true) {
-    return this.client.request("/v1/web/sessions", {
-      method: "POST",
-      body: {
-        domain,
-        new_session: true,
-        persist_session: persist
+  async get(itemId, options = {}) {
+    return this.client.request(
+      `/v1/vinted/items/${itemId}`,
+      { params: { market: options.market } }
+    );
+  }
+};
+
+// src/vinted/users.ts
+var UsersClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a user's profile.
+   *
+   * @param userId - The Vinted user ID.
+   * @param options - Optional parameters.
+   * @param options.market - Market code (default: "fr").
+   * @returns The user profile response.
+   * @throws NotFoundError - If the user doesn't exist.
+   * @throws AuthenticationError - If the API key is invalid.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.users.getProfile(12345);
+   * const { user } = response;
+   * console.log(`${user.login} from ${user.city}, ${user.country_code}`);
+   * console.log(`Reputation: ${user.feedback_reputation}`);
+   * console.log(`Items: ${user.item_count}, Followers: ${user.followers_count}`);
+   * ```
+   */
+  async getProfile(userId, options = {}) {
+    return this.client.request(
+      `/v1/vinted/users/${userId}`,
+      { params: { market: options.market } }
+    );
+  }
+  /**
+   * Get items listed by a user.
+   *
+   * @param userId - The Vinted user ID.
+   * @param options - Optional parameters for pagination and market.
+   * @param options.market - Market code (default: "fr").
+   * @param options.page - Page number.
+   * @param options.per_page - Items per page.
+   * @returns The user's items with pagination metadata.
+   * @throws NotFoundError - If the user doesn't exist.
+   * @throws AuthenticationError - If the API key is invalid.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.users.getItems(12345, {
+   *   market: "de",
+   *   page: 1,
+   *   per_page: 20,
+   * });
+   * console.log(`Page ${response.pagination.current_page} of ${response.pagination.total_pages}`);
+   * for (const item of response.items) {
+   *   console.log(`${item.title} — ${item.price.amount} ${item.price.currency_code}`);
+   * }
+   * ```
+   */
+  async getItems(userId, options = {}) {
+    return this.client.request(
+      `/v1/vinted/users/${userId}/items`,
+      {
+        params: {
+          market: options.market,
+          page: options.page,
+          per_page: options.per_page
+        }
       }
+    );
+  }
+};
+
+// src/vinted/reference.ts
+var ReferenceClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search for brands by keyword.
+   *
+   * @param options - Optional parameters.
+   * @param options.keyword - Brand name to search for.
+   * @param options.market - Market code (default: "fr").
+   * @param options.per_page - Number of results per page.
+   * @returns Brands matching the keyword.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.reference.brands({
+   *   keyword: "adidas",
+   *   market: "de",
+   *   per_page: 10,
+   * });
+   * for (const brand of response.brands) {
+   *   console.log(`${brand.title} (${brand.slug}): ${brand.item_count} items`);
+   * }
+   * ```
+   */
+  async brands(options = {}) {
+    return this.client.request("/v1/vinted/brands", {
+      params: {
+        keyword: options.keyword,
+        market: options.market,
+        per_page: options.per_page
+      }
+    });
+  }
+  /**
+   * Get available colors for a market.
+   *
+   * @param options - Optional parameters.
+   * @param options.market - Market code (default: "fr").
+   * @returns List of available colors.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.reference.colors({ market: "fr" });
+   * for (const color of response.colors) {
+   *   console.log(`${color.title} (#${color.hex})`);
+   * }
+   * ```
+   */
+  async colors(options = {}) {
+    return this.client.request("/v1/vinted/colors", {
+      params: { market: options.market }
+    });
+  }
+  /**
+   * Get available item condition statuses for a market.
+   *
+   * @param options - Optional parameters.
+   * @param options.market - Market code (default: "fr").
+   * @returns List of item condition statuses.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.reference.statuses({ market: "fr" });
+   * for (const status of response.statuses) {
+   *   console.log(`${status.id}: ${status.title}`);
+   * }
+   * ```
+   */
+  async statuses(options = {}) {
+    return this.client.request("/v1/vinted/statuses", {
+      params: { market: options.market }
+    });
+  }
+  /**
+   * Get all available Vinted markets.
+   *
+   * @returns List of all supported Vinted markets/countries.
+   *
+   * @example
+   * ```typescript
+   * const response = await client.vinted.reference.markets();
+   * for (const market of response.markets) {
+   *   console.log(`${market.name}: ${market.domain} (${market.currency})`);
+   * }
+   * ```
+   */
+  async markets() {
+    return this.client.request("/v1/vinted/markets");
+  }
+};
+
+// src/vinted/client.ts
+var VintedClient = class {
+  /** Client for item search operations */
+  search;
+  /** Client for individual item operations */
+  items;
+  /** Client for user operations */
+  users;
+  /** Client for reference data (brands, colors, statuses, markets) */
+  reference;
+  /**
+   * Create a new Vinted client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.search = new SearchClient(client);
+    this.items = new ItemsClient(client);
+    this.users = new UsersClient2(client);
+    this.reference = new ReferenceClient(client);
+  }
+};
+
+// src/google/ai-mode.ts
+var AiModeClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/ai-mode/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/autocomplete.ts
+var AutocompleteClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get Google autocomplete suggestions for a query.
+   *
+   * @example
+   * ```typescript
+   * const res = await client.google.autocomplete.get({ q: "apple" });
+   * for (const s of res.suggestions) {
+   *   console.log(s.value, s.entity_name, s.thumbnail);
+   * }
+   * ```
+   */
+  async get(params) {
+    return this.client.request("/v1/google/autocomplete", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/finance.ts
+var FinanceClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async quote(params) {
+    return this.client.request("/v1/google/finance/quote", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/flights.ts
+var FlightsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Search Google Flights for available itineraries. */
+  async search(params) {
+    return this.client.request("/v1/google/flights/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/hotels.ts
+var HotelsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/hotels/search", {
+      params: { ...params }
+    });
+  }
+  async details(params) {
+    return this.client.request("/v1/google/hotels/details", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/images.ts
+var ImagesClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/images/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/jobs.ts
+var JobsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/jobs/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/lens.ts
+var LensClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/lens/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/maps.ts
+var MapsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Maps for places by text query, place_id, or ludocid.
+   *
+   * Returns up to 20 results per page with full details (place_id,
+   * data_id, GPS, rating, reviews, address, phone, website, extensions,
+   * weekly hours, thumbnail) in a single call.
+   */
+  async search(params) {
+    if (!params.q && !params.place_id && !params.ludocid) {
+      throw new Error("q, place_id, or ludocid is required");
+    }
+    return this.client.request("/v1/google/maps/search", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Get full place detail by `place_id` or `data_id`.
+   *
+   * Returns title, address, phone, website, GPS, rating, reviews_count,
+   * rating_summary (per-star distribution), categories, extensions
+   * (service_options, accessibility, offerings, payments), weekly
+   * operating hours, popular_times graph, provider_id,
+   * permanently_closed, thumbnail, and photo list.
+   */
+  async place(params) {
+    if (!params.place_id && !params.data_id) {
+      throw new Error("place_id or data_id is required");
+    }
+    return this.client.request("/v1/google/maps/place", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Get reviews for a place (paginated, optional topic filter).
+   *
+   * Pass the `next_page_token` from `response.pagination.next` for
+   * subsequent pages, or use `topic_id` from `response.topics[].id`
+   * to scope to a specific review topic.
+   */
+  async reviews(params) {
+    return this.client.request("/v1/google/maps/reviews", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Get photos for a place with place-specific categories.
+   *
+   * Returns place-specific categories (Menu, Vibe, Comfort food, dish
+   * names) and photo URLs from all CDN families. Use `category_id` to
+   * scope to a category, or `page_size: 200` to fetch all photos in
+   * one call (Google caps at ~120 photos per response).
+   */
+  async photos(params) {
+    return this.client.request("/v1/google/maps/photos", {
+      params: { ...params }
+    });
+  }
+  /** Get business posts (promotional updates, announcements) for a place. */
+  async posts(params) {
+    if (!params.data_id && !params.place_id) {
+      throw new Error("data_id or place_id is required");
+    }
+    return this.client.request("/v1/google/maps/posts", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/news.ts
+var NewsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Google News. One of `q`, `topic_token`, `publication_token`,
+   * or `story_token` is required (or pass no params for the trending
+   * home feed). Returns `menu_links`, `news_results`, `related_topics`.
+   */
+  async search(params = {}) {
+    if (!params.q && !params.topic_token && !params.publication_token && !params.story_token) {
+      throw new Error("Provide q, topic_token, publication_token, or story_token");
+    }
+    return this.client.request("/v1/google/news/search", {
+      params: { ...params }
+    });
+  }
+  async topics(params) {
+    return this.client.request("/v1/google/news/topics", {
+      params: { ...params }
+    });
+  }
+  async trending(params = {}) {
+    return this.client.request("/v1/google/news/trending", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/patents.ts
+var PatentsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/patents/search", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Get rich patent document details by patent number.
+   *
+   * Response includes full abstract + every claim + complete description,
+   * plus structured `cpc_classifications` (code + description), split
+   * `backward_citations` / `forward_citations` (with `primary_examiner`
+   * flag), `non_patent_citations`, `concepts` (research fields),
+   * `legal_events` (prosecution history), `figures` (full-res URLs),
+   * every `inventor`, and the full `assignees_original` history.
+   */
+  async detail(params) {
+    return this.client.request("/v1/google/patents/detail", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/products.ts
+var ProductsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async detail(params) {
+    return this.client.request("/v1/google/products/detail", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/scholar.ts
+var ScholarClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Google Scholar. Returns each result with doc `id`, `type`
+   * badge, wrapped `inline_links`, PDF `resources`, and structured
+   * authors. Envelope includes `scholar_results` alias,
+   * `related_searches`, and matched `profiles` cards.
+   */
+  async search(params) {
+    return this.client.request("/v1/google/scholar/search", {
+      params: { ...params }
+    });
+  }
+  /** Search Google Scholar for author profiles by name. */
+  async profiles(params) {
+    return this.client.request("/v1/google/scholar/profiles", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Full Scholar author profile: structured `interests_detailed`,
+   * publications (with per-article `citation_id` + nested
+   * `cited_by{value, link, citation_id}`), stats, and co-authors.
+   */
+  async author(params) {
+    return this.client.request("/v1/google/scholar/author", {
+      params: { ...params }
+    });
+  }
+  /** Citations-per-year chart for a Scholar author. */
+  async authorCitation(params) {
+    return this.client.request("/v1/google/scholar/author/citation", {
+      params: { ...params }
+    });
+  }
+  /**
+   * MLA / APA / Chicago / Harvard / Vancouver citation formats plus
+   * BibTeX / RIS / EndNote / RefWorks export links for a paper.
+   */
+  async cite(params) {
+    return this.client.request("/v1/google/scholar/cite", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/search.ts
+var SearchClient2 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Google and get a structured SERP response with organic results,
+   * knowledge graph, People Also Ask, related searches, AI overview, and
+   * pagination.
+   */
+  async search(params) {
+    return this.client.request("/v1/google/search", { params: { ...params } });
+  }
+  /**
+   * Lightweight Google Search — organic results + related searches only.
+   *
+   * ~40% faster than {@link search}. Skips ads, Knowledge Graph, AI
+   * Overview, local pack, news, inline videos, and shopping blocks.
+   * Credit cost is configured per-endpoint by admins — query
+   * `/public/pricing` for the live rate.
+   *
+   * @example
+   * ```typescript
+   * const lite = await client.google.search.light({ q: "python 3.13" });
+   * ```
+   */
+  async light(params) {
+    return this.client.request("/v1/google/search", {
+      params: { ...params, mode: "fast" }
+    });
+  }
+};
+
+// src/google/shopping.ts
+var ShoppingClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** Search Google Shopping for products. */
+  async search(params) {
+    return this.client.request("/v1/google/shopping/search", {
+      params: { ...params }
+    });
+  }
+  /** Fetch the Google Shopping product detail page by `product_id`. */
+  async product(params) {
+    return this.client.request("/v1/google/shopping/product", {
+      params: { ...params }
     });
   }
   /**
-   * Scrape using an existing session.
+   * Resolve the direct merchant URL for a Shopping product tile via
+   * Google's "I'm Feeling Lucky" redirect (scoped to the card's `source`
+   * merchant via the `site:` operator). You only pay for the call when
+   * you actually want the merchant link — no bulk enrichment of every
+   * tile.
    */
-  async reuseSession(url, sessionId, options = {}) {
-    return this.scrape(url, { ...options, sessionId });
+  async click(params) {
+    return this.client.request("/v1/google/shopping/product/click", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/shorts.ts
+var ShortsClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/shorts/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/trends.ts
+var TrendsClient2 = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async interest(params) {
+    return this.client.request("/v1/google/trends/interest", {
+      params: { ...params }
+    });
+  }
+  async regions(params) {
+    return this.client.request("/v1/google/trends/regions", {
+      params: { ...params }
+    });
+  }
+  async related(params) {
+    return this.client.request("/v1/google/trends/related", {
+      params: { ...params }
+    });
+  }
+  async trending(params = {}) {
+    return this.client.request("/v1/google/trends/trending", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Current trending searches with the full Google Trends UI filter set
+   * — `geo`, `hours`, `category`, `status`, `sort`, `hl`.
+   */
+  async trendingNow(params = {}) {
+    return this.client.request("/v1/google/trends/trending-now", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Unified Google Trends query — pick the response shape via
+   * `data_type` (TIMESERIES | GEO_MAP | GEO_MAP_0 | RELATED_TOPICS |
+   * RELATED_QUERIES).
+   */
+  async search(params) {
+    return this.client.request("/v1/google/trends/search", {
+      params: { ...params }
+    });
+  }
+  /**
+   * Return categorized Knowledge Graph topic entities (`mid`, `type`,
+   * direct link into Trends explore) for a query prefix. Distinct from
+   * Google Search autocomplete.
+   */
+  async autocomplete(params) {
+    return this.client.request("/v1/google/trends/autocomplete", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/videos.ts
+var VideosClient = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async search(params) {
+    return this.client.request("/v1/google/videos/search", {
+      params: { ...params }
+    });
+  }
+};
+
+// src/google/client.ts
+var GoogleClient = class {
+  /** Google Web Search (SERP) — with optional deferred AI Overview follow-up. */
+  search;
+  /** Google Maps — places, reviews, photos, posts. */
+  maps;
+  /** Google News — articles, topics, trending. */
+  news;
+  /** Google Hotels — search and property details. */
+  hotels;
+  /** Google Trends — interest, regions, related, trending, topic autocomplete. */
+  trends;
+  /** Google Jobs. */
+  jobs;
+  /** Google Shopping — search, details, click enrichment. */
+  shopping;
+  /** Google Patents — search and document details. */
+  patents;
+  /** Google Scholar — search, profiles, author, author citation, cite formats. */
+  scholar;
+  /** Google Autocomplete — search suggestions. */
+  autocomplete;
+  /** Google Images. */
+  images;
+  /** Google Videos. */
+  videos;
+  /** Google Finance — stock and index quotes. */
+  finance;
+  /** Google AI Mode — generative answer responses. */
+  aiMode;
+  /** Google Lens — visual image search. */
+  lens;
+  /** Google Shorts — short-form vertical video results (udm=39). */
+  shorts;
+  /** Google Flights — one-way, round-trip, and multi-city itineraries. */
+  flights;
+  /** Google Products — immersive product detail. */
+  products;
+  constructor(client) {
+    this.search = new SearchClient2(client);
+    this.maps = new MapsClient(client);
+    this.news = new NewsClient(client);
+    this.hotels = new HotelsClient(client);
+    this.trends = new TrendsClient2(client);
+    this.jobs = new JobsClient(client);
+    this.shopping = new ShoppingClient(client);
+    this.patents = new PatentsClient(client);
+    this.scholar = new ScholarClient(client);
+    this.autocomplete = new AutocompleteClient(client);
+    this.images = new ImagesClient(client);
+    this.videos = new VideosClient(client);
+    this.finance = new FinanceClient(client);
+    this.aiMode = new AiModeClient(client);
+    this.lens = new LensClient(client);
+    this.shorts = new ShortsClient(client);
+    this.flights = new FlightsClient(client);
+    this.products = new ProductsClient(client);
   }
 };
 
@@ -2320,6 +3276,10 @@ var ScrapeBadger = class {
   twitter;
   /** Web scraping API client */
   web;
+  /** Vinted scraper API client */
+  vinted;
+  /** Google Scraper API client — 19 Google product APIs */
+  google;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -2356,9 +3316,11 @@ var ScrapeBadger = class {
     this.baseClient = new BaseClient(resolvedConfig);
     this.twitter = new TwitterClient(this.baseClient);
     this.web = new WebClient(this.baseClient);
+    this.vinted = new VintedClient(this.baseClient);
+    this.google = new GoogleClient(this.baseClient);
   }
 };
 
-export { AccountRestrictedError, AuthenticationError, CommunitiesClient, ConflictError, GeoClient, InsufficientCreditsError, ListsClient, NotFoundError, RateLimitError, ScrapeBadger, ScrapeBadgerError, ServerError, StreamClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, WebClient, WebSocketStreamError, collectAll, verifyWebhookSignature };
+export { AccountRestrictedError, AuthenticationError, CommunitiesClient, ConflictError, GeoClient, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient as GoogleProductsClient, ScholarClient as GoogleScholarClient, SearchClient2 as GoogleSearchClient, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient2 as GoogleTrendsClient, VideosClient as GoogleVideosClient, InsufficientCreditsError, ListsClient, NotFoundError, RateLimitError, ScrapeBadger, ScrapeBadgerError, ServerError, SpacesClient, StreamClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, collectAll, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map