scrapebadger 0.17.0 → 0.19.0

package/dist/index.js

@@ -3943,6 +3943,101 @@ var RedditClient = class {
   }
 };
 
+// src/redfin/client.ts
+var RedfinClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Redfin for for-sale properties.
+   *
+   * @param location - City/state, ZIP, address or neighborhood (required).
+   * @param options - Optional parameters (page, sort, price/beds/baths/sqft/lot
+   *   filters, year built, max days on market, bbox override).
+   * @returns Search response with matching listings, map bounds, and pagination.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async search(location, options = {}) {
+    return this.client.request("/v1/redfin/search", {
+      params: {
+        location,
+        page: options.page,
+        sort: options.sort,
+        price_min: options.price_min,
+        price_max: options.price_max,
+        beds_min: options.beds_min,
+        baths_min: options.baths_min,
+        home_type: options.home_type,
+        sqft_min: options.sqft_min,
+        sqft_max: options.sqft_max,
+        lot_min: options.lot_min,
+        lot_max: options.lot_max,
+        year_built_min: options.year_built_min,
+        year_built_max: options.year_built_max,
+        max_days_on_market: options.max_days_on_market,
+        north: options.north,
+        south: options.south,
+        east: options.east,
+        west: options.west
+      }
+    });
+  }
+  /**
+   * Get a single Redfin property's full detail by id or URL.
+   *
+   * Provide either `propertyId` or `options.url`.
+   *
+   * @param propertyId - The Redfin property id.
+   * @param options - Optional parameters (url).
+   * @returns Property detail response.
+   * @throws NotFoundError - If the property doesn't exist.
+   */
+  async getProperty(propertyId, options = {}) {
+    if (options.url) {
+      return this.client.request("/v1/redfin/property", {
+        params: { url: options.url }
+      });
+    }
+    return this.client.request(`/v1/redfin/property/${propertyId}`);
+  }
+  /**
+   * Get a Redfin agent's profile and their active listings.
+   *
+   * Provide either `agentId` or `options.url`.
+   *
+   * @param agentId - The Redfin agent slug.
+   * @param options - Optional parameters (url).
+   * @returns Agent profile response with the agent and their listings.
+   * @throws NotFoundError - If the agent doesn't exist.
+   */
+  async getAgent(agentId, options = {}) {
+    return this.client.request("/v1/redfin/agent", {
+      params: { agent_id: agentId, url: options.url }
+    });
+  }
+  /**
+   * Resolve a search term to Redfin locations.
+   *
+   * @param query - Partial location — city, ZIP, address, or neighborhood.
+   * @returns Autocomplete response with location suggestions.
+   */
+  async autocomplete(query) {
+    return this.client.request("/v1/redfin/autocomplete", {
+      params: { query }
+    });
+  }
+  /**
+   * Get all supported Redfin coverage markets.
+   *
+   * @returns Markets response with all supported markets.
+   */
+  async listMarkets() {
+    return this.client.request("/v1/redfin/markets");
+  }
+};
+
 // src/amazon/search.ts
 var SearchClient4 = class {
   client;
@@ -6366,6 +6461,103 @@ var LoopNetClient = class {
   }
 };
 
+// src/depop/client.ts
+var DepopClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Depop for products.
+   *
+   * Costs 10 credits.
+   *
+   * @param query - Search keywords (required).
+   * @param options - Optional parameters (market, perPage, page, price/brand/
+   *   size/colour/condition/gender filters, sort).
+   * @returns Search response with matching product cards and pagination meta.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async search(query, options = {}) {
+    return this.client.request("/v1/depop/search", {
+      params: {
+        query,
+        market: options.market ?? "us",
+        per_page: options.perPage,
+        page: options.page,
+        price_min: options.priceMin,
+        price_max: options.priceMax,
+        brands: options.brands,
+        sizes: options.sizes,
+        colours: options.colours,
+        conditions: options.conditions,
+        gender: options.gender,
+        sort: options.sort
+      }
+    });
+  }
+  /**
+   * Get a single Depop product's full detail by slug.
+   *
+   * Costs 10 credits.
+   *
+   * @param slug - The Depop product slug.
+   * @param options - Optional parameters (market).
+   * @returns Full product detail.
+   * @throws NotFoundError - If the product doesn't exist.
+   */
+  async getProduct(slug, options = {}) {
+    return this.client.request(`/v1/depop/products/${slug}`, {
+      params: { market: options.market ?? "us" }
+    });
+  }
+  /**
+   * Get a Depop shop / seller profile by username.
+   *
+   * Costs 10 credits.
+   *
+   * @param username - The Depop seller username.
+   * @param options - Optional parameters (market).
+   * @returns Shop profile.
+   * @throws NotFoundError - If the user doesn't exist.
+   */
+  async getUser(username, options = {}) {
+    return this.client.request(`/v1/depop/users/${username}`, {
+      params: { market: options.market ?? "us" }
+    });
+  }
+  /**
+   * Get a Depop seller's products.
+   *
+   * Costs 10 credits.
+   *
+   * @param username - The Depop seller username.
+   * @param options - Optional parameters (market, perPage, page).
+   * @returns User products response with product cards and pagination meta.
+   * @throws NotFoundError - If the user doesn't exist.
+   */
+  async getUserProducts(username, options = {}) {
+    return this.client.request(`/v1/depop/users/${username}/products`, {
+      params: {
+        market: options.market ?? "us",
+        per_page: options.perPage,
+        page: options.page
+      }
+    });
+  }
+  /**
+   * Get all supported Depop markets.
+   *
+   * Free — this endpoint costs no credits.
+   *
+   * @returns Markets response with all supported markets.
+   */
+  async listMarkets() {
+    return this.client.request("/v1/depop/markets");
+  }
+};
+
 // src/client.ts
 var ScrapeBadger = class {
   baseClient;
@@ -6379,6 +6571,8 @@ var ScrapeBadger = class {
   google;
   /** Reddit scraper API client */
   reddit;
+  /** Redfin scraper API client — search, property, agent, autocomplete, markets (redfin.com, US) */
+  redfin;
   /** Amazon scraper API client — 14 endpoints */
   amazon;
   /** Shopee scraper API client — 6 endpoints across 11 markets */
@@ -6399,6 +6593,8 @@ var ScrapeBadger = class {
   immobiliare;
   /** LoopNet scraper API client — commercial real estate across US/CA/UK/FR/ES (search, listing, broker, markets, property types) */
   loopnet;
+  /** Depop scraper API client — search, product, user, user products, markets (www.depop.com, 10 markets) */
+  depop;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -6438,6 +6634,7 @@ var ScrapeBadger = class {
     this.vinted = new VintedClient(this.baseClient);
     this.google = new GoogleClient(this.baseClient);
     this.reddit = new RedditClient(this.baseClient);
+    this.redfin = new RedfinClient(this.baseClient);
     this.amazon = new AmazonClient(this.baseClient);
     this.shopee = new ShopeeClient(this.baseClient);
     this.tiktok = new TikTokClient(this.baseClient);
@@ -6448,6 +6645,7 @@ var ScrapeBadger = class {
     this.zillow = new ZillowClient(this.baseClient);
     this.immobiliare = new ImmobiliareClient(this.baseClient);
     this.loopnet = new LoopNetClient(this.baseClient);
+    this.depop = new DepopClient(this.baseClient);
   }
 };
 
@@ -6461,6 +6659,7 @@ exports.AmazonSellersClient = SellersClient;
 exports.AuthenticationError = AuthenticationError;
 exports.CommunitiesClient = CommunitiesClient;
 exports.ConflictError = ConflictError;
+exports.DepopClient = DepopClient;
 exports.EbayCategoriesClient = CategoriesClient;
 exports.EbayClient = EbayClient;
 exports.EbayItemsClient = ItemsClient2;
@@ -6511,6 +6710,7 @@ exports.RedditPostsClient = PostsClient;
 exports.RedditSearchClient = SearchClient3;
 exports.RedditSubredditsClient = SubredditsClient;
 exports.RedditUsersClient = UsersClient3;
+exports.RedfinClient = RedfinClient;
 exports.ScrapeBadger = ScrapeBadger;
 exports.ScrapeBadgerError = ScrapeBadgerError;
 exports.ServerError = ServerError;