scrapebadger 0.17.0 → 0.18.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;
@@ -6379,6 +6474,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 */
@@ -6438,6 +6535,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);
@@ -6511,6 +6609,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;