scrapebadger 0.15.5 → 0.16.0

package/dist/index.mjs

@@ -3,7 +3,7 @@ import { EventEmitter } from 'events';
 import WebSocket from 'ws';
 
 // 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 {
@@ -5955,6 +5955,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;
@@ -5982,6 +6255,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.
    *
@@ -6028,9 +6305,11 @@ 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);
   }
 };
 
-export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient4 as AmazonSearchClient, SellersClient as AmazonSellersClient, AuthenticationError, CommunitiesClient, ConflictError, CategoriesClient as EbayCategoriesClient, EbayClient, ItemsClient2 as EbayItemsClient, ReferenceClient5 as EbayReferenceClient, SearchClient7 as EbaySearchClient, SellersClient2 as EbaySellersClient, 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, AdsClient2 as LeboncoinAdsClient, LeboncoinClient, ReferenceClient8 as LeboncoinReferenceClient, SearchClient10 as LeboncoinSearchClient, SellersClient3 as LeboncoinSellersClient, ListsClient, NotFoundError, RateLimitError, RealtorClient, PropertiesClient as RealtorPropertiesClient, ReferenceClient7 as RealtorReferenceClient, SearchClient9 as RealtorSearchClient, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient5 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient6 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient4 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, ChannelsClient as YoutubeChannelsClient, YoutubeClient, CommunityClient as YoutubeCommunityClient, MusicClient2 as YoutubeMusicClient, PlaylistsClient as YoutubePlaylistsClient, ReferenceClient6 as YoutubeReferenceClient, SearchClient8 as YoutubeSearchClient, ShortsClient2 as YoutubeShortsClient, TrendingClient2 as YoutubeTrendingClient, VideosClient3 as YoutubeVideosClient, collectAll, verifyWebhookSignature };
+export { AccountRestrictedError, AmazonClient, ListingsClient as AmazonListingsClient, ProductsClient2 as AmazonProductsClient, ReferenceClient2 as AmazonReferenceClient, SearchClient4 as AmazonSearchClient, SellersClient as AmazonSellersClient, AuthenticationError, CommunitiesClient, ConflictError, CategoriesClient as EbayCategoriesClient, EbayClient, ItemsClient2 as EbayItemsClient, ReferenceClient5 as EbayReferenceClient, SearchClient7 as EbaySearchClient, SellersClient2 as EbaySellersClient, 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, ImmobiliareClient, InsufficientCreditsError, AdsClient2 as LeboncoinAdsClient, LeboncoinClient, ReferenceClient8 as LeboncoinReferenceClient, SearchClient10 as LeboncoinSearchClient, SellersClient3 as LeboncoinSellersClient, ListsClient, NotFoundError, RateLimitError, RealtorClient, PropertiesClient as RealtorPropertiesClient, ReferenceClient7 as RealtorReferenceClient, SearchClient9 as RealtorSearchClient, RedditClient, PostsClient as RedditPostsClient, SearchClient3 as RedditSearchClient, SubredditsClient as RedditSubredditsClient, UsersClient3 as RedditUsersClient, ScrapeBadger, ScrapeBadgerError, ServerError, ShopeeClient, ProductsClient3 as ShopeeProductsClient, ReferenceClient3 as ShopeeReferenceClient, ReviewsClient as ShopeeReviewsClient, SearchClient5 as ShopeeSearchClient, SpacesClient, StreamClient, AdsClient as TikTokAdsClient, TikTokClient, HashtagsClient as TikTokHashtagsClient, MusicClient as TikTokMusicClient, ReferenceClient4 as TikTokReferenceClient, SearchClient6 as TikTokSearchClient, TrendingClient as TikTokTrendingClient, UsersClient4 as TikTokUsersClient, VideosClient2 as TikTokVideosClient, TimeoutError, TrendsClient, TweetsClient, TwitterClient, UsersClient, ValidationError, VintedClient, ItemsClient as VintedItemsClient, ReferenceClient as VintedReferenceClient, SearchClient as VintedSearchClient, UsersClient2 as VintedUsersClient, WebClient, WebSocketStreamError, ChannelsClient as YoutubeChannelsClient, YoutubeClient, CommunityClient as YoutubeCommunityClient, MusicClient2 as YoutubeMusicClient, PlaylistsClient as YoutubePlaylistsClient, ReferenceClient6 as YoutubeReferenceClient, SearchClient8 as YoutubeSearchClient, ShortsClient2 as YoutubeShortsClient, TrendingClient2 as YoutubeTrendingClient, VideosClient3 as YoutubeVideosClient, AgentClient as ZillowAgentClient, ZillowClient, PropertiesClient2 as ZillowPropertiesClient, ReferenceClient9 as ZillowReferenceClient, SearchClient11 as ZillowSearchClient, collectAll, verifyWebhookSignature };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map