scrapebadger 0.3.1 → 0.7.0

package/dist/index.js

@@ -710,6 +710,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
@@ -1021,6 +1074,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
@@ -1167,6 +1306,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
@@ -2030,7 +2192,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)}`)
@@ -2188,6 +2350,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 */
@@ -2204,6 +2406,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.
    *
@@ -2217,6 +2421,7 @@ var TwitterClient = class {
     this.trends = new TrendsClient(client);
     this.geo = new GeoClient(client);
     this.stream = new StreamClient(client);
+    this.spaces = new SpacesClient(client);
   }
 };
 
@@ -2228,94 +2433,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);
   }
 };
 
@@ -2326,6 +3282,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.
    *
@@ -2362,6 +3322,8 @@ 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);
   }
 };
 
@@ -2370,6 +3332,25 @@ exports.AuthenticationError = AuthenticationError;
 exports.CommunitiesClient = CommunitiesClient;
 exports.ConflictError = ConflictError;
 exports.GeoClient = GeoClient;
+exports.GoogleAiModeClient = AiModeClient;
+exports.GoogleAutocompleteClient = AutocompleteClient;
+exports.GoogleClient = GoogleClient;
+exports.GoogleFinanceClient = FinanceClient;
+exports.GoogleFlightsClient = FlightsClient;
+exports.GoogleHotelsClient = HotelsClient;
+exports.GoogleImagesClient = ImagesClient;
+exports.GoogleJobsClient = JobsClient;
+exports.GoogleLensClient = LensClient;
+exports.GoogleMapsClient = MapsClient;
+exports.GoogleNewsClient = NewsClient;
+exports.GooglePatentsClient = PatentsClient;
+exports.GoogleProductsClient = ProductsClient;
+exports.GoogleScholarClient = ScholarClient;
+exports.GoogleSearchClient = SearchClient2;
+exports.GoogleShoppingClient = ShoppingClient;
+exports.GoogleShortsClient = ShortsClient;
+exports.GoogleTrendsClient = TrendsClient2;
+exports.GoogleVideosClient = VideosClient;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.ListsClient = ListsClient;
 exports.NotFoundError = NotFoundError;
@@ -2377,6 +3358,7 @@ exports.RateLimitError = RateLimitError;
 exports.ScrapeBadger = ScrapeBadger;
 exports.ScrapeBadgerError = ScrapeBadgerError;
 exports.ServerError = ServerError;
+exports.SpacesClient = SpacesClient;
 exports.StreamClient = StreamClient;
 exports.TimeoutError = TimeoutError;
 exports.TrendsClient = TrendsClient;
@@ -2384,6 +3366,11 @@ exports.TweetsClient = TweetsClient;
 exports.TwitterClient = TwitterClient;
 exports.UsersClient = UsersClient;
 exports.ValidationError = ValidationError;
+exports.VintedClient = VintedClient;
+exports.VintedItemsClient = ItemsClient;
+exports.VintedReferenceClient = ReferenceClient;
+exports.VintedSearchClient = SearchClient;
+exports.VintedUsersClient = UsersClient2;
 exports.WebClient = WebClient;
 exports.WebSocketStreamError = WebSocketStreamError;
 exports.collectAll = collectAll;