scrapebadger 0.15.5 → 0.16.0

package/dist/index.js

@@ -9,7 +9,7 @@ function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 var WebSocket__default = /*#__PURE__*/_interopDefault(WebSocket);
 
 // src/internal/version.ts
-var SDK_VERSION = "0.13.1";
+var SDK_VERSION = "0.16.0";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -5961,6 +5961,279 @@ var LeboncoinClient = class {
   }
 };
 
+// src/zillow/search.ts
+var SearchClient11 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search Zillow for properties.
+   *
+   * Beat the ~820-result (20-page) cap by re-issuing the search over
+   * subdivided `north/south/east/west` map-bound boxes returned in
+   * `map_bounds`.
+   *
+   * @param location - City/state, ZIP, address, or neighborhood ("Austin, TX").
+   * @param options - Filters, sorting, pagination, and map bounds.
+   * @returns Search results with pagination and map metadata.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async search(location, options = {}) {
+    return this.client.request("/v1/zillow/search", {
+      params: {
+        location,
+        status: options.status,
+        page: options.page,
+        sort: options.sort,
+        price_min: options.priceMin,
+        price_max: options.priceMax,
+        beds_min: options.bedsMin,
+        baths_min: options.bathsMin,
+        home_type: options.homeType,
+        sqft_min: options.sqftMin,
+        sqft_max: options.sqftMax,
+        lot_min: options.lotMin,
+        lot_max: options.lotMax,
+        year_built_min: options.yearBuiltMin,
+        year_built_max: options.yearBuiltMax,
+        hoa_max: options.hoaMax,
+        keywords: options.keywords,
+        days_on: options.daysOn,
+        north: options.north,
+        south: options.south,
+        east: options.east,
+        west: options.west
+      }
+    });
+  }
+  /**
+   * Resolve a search term to Zillow regions/addresses (regionId, lat/lng).
+   *
+   * @param query - Partial location — city, ZIP, address, or neighborhood.
+   * @returns Autocomplete suggestions.
+   */
+  async autocomplete(query) {
+    return this.client.request("/v1/zillow/autocomplete", {
+      params: { query }
+    });
+  }
+};
+
+// src/zillow/properties.ts
+var PropertiesClient2 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a single Zillow property's full detail by its zpid.
+   *
+   * Returns price/valuation, specs, resoFacts (home_facts), price & tax
+   * history, schools, listing agent, mortgage rates and photos.
+   *
+   * @param zpid - The Zillow property id.
+   * @returns Property detail wrapped in `{ property }`.
+   * @throws NotFoundError - If the property doesn't exist.
+   */
+  async getProperty(zpid) {
+    return this.client.request(`/v1/zillow/property/${zpid}`);
+  }
+};
+
+// src/zillow/agent.ts
+var AgentClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a Zillow real-estate professional's profile and their active listings.
+   *
+   * Provide either a `username` (screen name) or a full `url`.
+   *
+   * @param options - The agent `username` or profile `url`.
+   * @returns Agent profile wrapped in `{ agent }`.
+   * @throws NotFoundError - If the agent doesn't exist.
+   * @throws ValidationError - If neither username nor url is provided.
+   */
+  async getAgent(options = {}) {
+    return this.client.request("/v1/zillow/agent", {
+      params: { username: options.username, url: options.url }
+    });
+  }
+};
+
+// src/zillow/reference.ts
+var ReferenceClient9 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List Zillow coverage regions (US + Canada, all served via zillow.com).
+   *
+   * @returns Markets response with all supported markets.
+   */
+  async listMarkets() {
+    return this.client.request("/v1/zillow/markets");
+  }
+};
+
+// src/zillow/client.ts
+var ZillowClient = class {
+  /** Client for property search and location autocomplete */
+  search;
+  /** Client for full property detail */
+  properties;
+  /** Client for agent profile + listings */
+  agent;
+  /** Client for reference data (markets) */
+  reference;
+  /**
+   * Create a new Zillow client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.search = new SearchClient11(client);
+    this.properties = new PropertiesClient2(client);
+    this.agent = new AgentClient(client);
+    this.reference = new ReferenceClient9(client);
+  }
+};
+
+// src/immobiliare/client.ts
+var ImmobiliareClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Resolve a free-text place name into geography ids for search.
+   *
+   * @param query - Free-text place name, e.g. "Milano".
+   * @param options - Optional parameters (market).
+   * @returns Suggest response with region/province/city/zone id candidates.
+   */
+  async autocomplete(query, options = {}) {
+    return this.client.request("/v1/immobiliare/autocomplete", {
+      params: { query, market: options.market }
+    });
+  }
+  /**
+   * Search Immobiliare-group listings.
+   *
+   * Scope the search by `location` (free text, auto-resolved) OR explicit
+   * `region_id` / `province_id` / `city_id` from {@link autocomplete}.
+   *
+   * @param options - Search parameters (market, location/ids, contract,
+   *   category, price/surface/room/bathroom filters, sort, page).
+   * @returns Search response with `listings` and pagination metadata.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async search(options = {}) {
+    return this.client.request("/v1/immobiliare/search", {
+      params: {
+        market: options.market,
+        location: options.location,
+        region_id: options.region_id,
+        province_id: options.province_id,
+        city_id: options.city_id,
+        contract: options.contract,
+        category: options.category,
+        price_min: options.price_min,
+        price_max: options.price_max,
+        surface_min: options.surface_min,
+        surface_max: options.surface_max,
+        rooms_min: options.rooms_min,
+        rooms_max: options.rooms_max,
+        bathrooms_min: options.bathrooms_min,
+        sort: options.sort,
+        page: options.page
+      }
+    });
+  }
+  /**
+   * Get the full detail for a single Immobiliare listing.
+   *
+   * @param listingId - The Immobiliare listing id.
+   * @param options - Optional parameters (market).
+   * @returns The full listing detail.
+   * @throws NotFoundError - If the listing doesn't exist.
+   */
+  async getListing(listingId, options = {}) {
+    return this.client.request(`/v1/immobiliare/listings/${listingId}`, {
+      params: { market: options.market }
+    });
+  }
+  /**
+   * Get an agency/advertiser profile.
+   *
+   * @param agencyId - The Immobiliare agency id.
+   * @param options - Optional parameters (market).
+   * @returns The full agency profile.
+   * @throws NotFoundError - If the agency doesn't exist.
+   */
+  async getAgency(agencyId, options = {}) {
+    return this.client.request(`/v1/immobiliare/agencies/${agencyId}`, {
+      params: { market: options.market }
+    });
+  }
+  /**
+   * Get an agency's active listings (25 per page).
+   *
+   * @param agencyId - The Immobiliare agency id.
+   * @param options - Optional parameters (market, page).
+   * @returns Agency-listings response with `listings` and pagination.
+   */
+  async getAgencyListings(agencyId, options = {}) {
+    return this.client.request(
+      `/v1/immobiliare/agencies/${agencyId}/listings`,
+      {
+        params: { market: options.market, page: options.page }
+      }
+    );
+  }
+  /**
+   * Get the historical average €/m² time series for an area.
+   *
+   * @param regionId - Region id, e.g. "lom" (required).
+   * @param options - Optional parameters (province_id, city_id, market, contract).
+   * @returns Price-stats response with monthly `points` (label + EUR/m² value).
+   */
+  async priceStats(regionId, options = {}) {
+    return this.client.request("/v1/immobiliare/market-insights/prices", {
+      params: {
+        market: options.market,
+        region_id: regionId,
+        province_id: options.province_id,
+        city_id: options.city_id,
+        contract: options.contract
+      }
+    });
+  }
+  /**
+   * Get all supported Immobiliare-group markets (it, es, gr, lu).
+   *
+   * @returns A bare array of supported markets (code, domain, country,
+   *   locale, currency, name).
+   */
+  async markets() {
+    return this.client.request("/v1/immobiliare/markets");
+  }
+  /**
+   * Get the filter enums accepted by {@link search}.
+   *
+   * @returns Reference response with `contracts`, `categories`, and `sorts`.
+   */
+  async reference() {
+    return this.client.request("/v1/immobiliare/reference");
+  }
+};
+
 // src/client.ts
 var ScrapeBadger = class {
   baseClient;
@@ -5988,6 +6261,10 @@ var ScrapeBadger = class {
   realtor;
   /** Leboncoin scraper API client — 10 endpoints (France) */
   leboncoin;
+  /** Zillow scraper API client — 5 endpoints (search, property, agent, autocomplete, markets) */
+  zillow;
+  /** Immobiliare scraper API client — 8 endpoints across 4 markets (it, es, gr, lu) */
+  immobiliare;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -6034,6 +6311,8 @@ var ScrapeBadger = class {
     this.youtube = new YoutubeClient(this.baseClient);
     this.realtor = new RealtorClient(this.baseClient);
     this.leboncoin = new LeboncoinClient(this.baseClient);
+    this.zillow = new ZillowClient(this.baseClient);
+    this.immobiliare = new ImmobiliareClient(this.baseClient);
   }
 };
 
@@ -6073,6 +6352,7 @@ exports.GoogleShoppingClient = ShoppingClient;
 exports.GoogleShortsClient = ShortsClient;
 exports.GoogleTrendsClient = TrendsClient2;
 exports.GoogleVideosClient = VideosClient;
+exports.ImmobiliareClient = ImmobiliareClient;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.LeboncoinAdsClient = AdsClient2;
 exports.LeboncoinClient = LeboncoinClient;
@@ -6133,6 +6413,11 @@ exports.YoutubeSearchClient = SearchClient8;
 exports.YoutubeShortsClient = ShortsClient2;
 exports.YoutubeTrendingClient = TrendingClient2;
 exports.YoutubeVideosClient = VideosClient3;
+exports.ZillowAgentClient = AgentClient;
+exports.ZillowClient = ZillowClient;
+exports.ZillowPropertiesClient = PropertiesClient2;
+exports.ZillowReferenceClient = ReferenceClient9;
+exports.ZillowSearchClient = SearchClient11;
 exports.collectAll = collectAll;
 exports.verifyWebhookSignature = verifyWebhookSignature;
 //# sourceMappingURL=index.js.map