scrapebadger 0.27.1 → 0.28.0

package/dist/index.js

@@ -4094,6 +4094,324 @@ var ApartmentsClient = class {
   }
 };
 
+// src/instagram/users.ts
+var UsersClient4 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get a user's full profile. */
+  async get(username) {
+    return this.client.request(`/v1/instagram/users/${username}`);
+  }
+  /** Get "About this account" metadata for a user. */
+  async about(username) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/about`
+    );
+  }
+  /** Get accounts related/suggested for a user. */
+  async related(username) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/related`
+    );
+  }
+  /** Get a user's timeline posts. */
+  async posts(username, options = {}) {
+    return this.media(`/v1/instagram/users/${username}/posts`, options);
+  }
+  /** Get a user's video posts (IGTV/feed videos). */
+  async videos(username, options = {}) {
+    return this.media(`/v1/instagram/users/${username}/videos`, options);
+  }
+  /** Get a user's reels. */
+  async reels(username, options = {}) {
+    return this.media(`/v1/instagram/users/${username}/reels`, options);
+  }
+  /** Get media a user is tagged in. */
+  async tagged(username, options = {}) {
+    return this.media(`/v1/instagram/users/${username}/tagged`, options);
+  }
+  /** Get a user's pinned posts. */
+  async pinned(username) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/pinned`
+    );
+  }
+  /**
+   * Get a user's followers.
+   *
+   * @param username - Instagram username.
+   * @param options.amount - Number of followers to return.
+   * @param options.cursor - Pagination cursor from a previous response.
+   * @param options.order - Ordering hint (e.g. "default", "date_followed_earliest").
+   */
+  async followers(username, options = {}) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/followers`,
+      {
+        params: {
+          amount: options.amount,
+          cursor: options.cursor,
+          order: options.order
+        }
+      }
+    );
+  }
+  /** Get the accounts a user follows. */
+  async following(username, options = {}) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/following`,
+      { params: { amount: options.amount, cursor: options.cursor } }
+    );
+  }
+  /** Search within a user's followers by name/username. */
+  async searchFollowers(username, query, options = {}) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/followers/search`,
+      {
+        params: { query, amount: options.amount, cursor: options.cursor }
+      }
+    );
+  }
+  /** Get a user's currently-live stories. */
+  async stories(username) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/stories`
+    );
+  }
+  /** Get a user's story highlights. */
+  async highlights(username) {
+    return this.client.request(
+      `/v1/instagram/users/${username}/highlights`
+    );
+  }
+  async media(path, options) {
+    return this.client.request(path, {
+      params: { amount: options.amount, cursor: options.cursor }
+    });
+  }
+};
+
+// src/instagram/media.ts
+var MediaClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Get a media's full details.
+   *
+   * @param code - The media shortcode (from the `/p/<code>/` URL).
+   */
+  async get(code) {
+    return this.client.request(`/v1/instagram/media/${code}`);
+  }
+  /** Get oEmbed metadata for a media permalink. */
+  async oembed(code) {
+    return this.client.request(`/v1/instagram/media/${code}/oembed`);
+  }
+  /** Get top-level comments on a media. */
+  async comments(code, options = {}) {
+    return this.client.request(
+      `/v1/instagram/media/${code}/comments`,
+      { params: { amount: options.amount, cursor: options.cursor } }
+    );
+  }
+  /** Get the users who liked a media. */
+  async likers(code) {
+    return this.client.request(
+      `/v1/instagram/media/${code}/likers`
+    );
+  }
+  /** Get replies to a comment. */
+  async replies(code, commentId, options = {}) {
+    return this.client.request(
+      `/v1/instagram/media/${code}/comments/${commentId}/replies`,
+      { params: { amount: options.amount, cursor: options.cursor } }
+    );
+  }
+  /** Get the users who liked a comment. */
+  async commentLikers(code, commentId) {
+    return this.client.request(
+      `/v1/instagram/media/${code}/comments/${commentId}/likers`
+    );
+  }
+};
+
+// src/instagram/search.ts
+var SearchClient4 = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Search accounts by name/username. */
+  async users(query) {
+    return this.client.request(
+      "/v1/instagram/search/users",
+      { params: { query } }
+    );
+  }
+  /** Search hashtags. */
+  async hashtags(query) {
+    return this.client.request(
+      "/v1/instagram/search/hashtags",
+      { params: { query } }
+    );
+  }
+  /** Search places/locations. */
+  async places(query) {
+    return this.client.request(
+      "/v1/instagram/search/places",
+      { params: { query } }
+    );
+  }
+  /** Search reels. */
+  async reels(query) {
+    return this.client.request(
+      "/v1/instagram/search/reels",
+      { params: { query } }
+    );
+  }
+  /** Search music/audio tracks. */
+  async music(query) {
+    return this.client.request(
+      "/v1/instagram/search/music",
+      { params: { query } }
+    );
+  }
+  /** Get blended "top" results (users, hashtags, and places). */
+  async top(query) {
+    return this.client.request("/v1/instagram/search/top", {
+      params: { query }
+    });
+  }
+  /** Get typeahead/autocomplete suggestions (mixed entity types). */
+  async autocomplete(query) {
+    return this.client.request(
+      "/v1/instagram/search/autocomplete",
+      { params: { query } }
+    );
+  }
+};
+
+// src/instagram/reference.ts
+function mediaFeed(client, path, options) {
+  return client.request(path, {
+    params: { amount: options.amount, cursor: options.cursor }
+  });
+}
+var HashtagsClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get a hashtag's info (media count, cover). */
+  async get(tag) {
+    return this.client.request(`/v1/instagram/hashtags/${tag}`);
+  }
+  /** Get the top/popular media for a hashtag. */
+  async top(tag, options = {}) {
+    return mediaFeed(this.client, `/v1/instagram/hashtags/${tag}/top`, options);
+  }
+  /** Get the most recent media for a hashtag. */
+  async recent(tag, options = {}) {
+    return mediaFeed(
+      this.client,
+      `/v1/instagram/hashtags/${tag}/recent`,
+      options
+    );
+  }
+  /** Get reels for a hashtag. */
+  async reels(tag, options = {}) {
+    return mediaFeed(
+      this.client,
+      `/v1/instagram/hashtags/${tag}/reels`,
+      options
+    );
+  }
+};
+var LocationsClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get a location's info. */
+  async get(pk) {
+    return this.client.request(`/v1/instagram/locations/${pk}`);
+  }
+  /** Get the top/popular media for a location. */
+  async top(pk, options = {}) {
+    return mediaFeed(this.client, `/v1/instagram/locations/${pk}/top`, options);
+  }
+  /** Get the most recent media for a location. */
+  async recent(pk, options = {}) {
+    return mediaFeed(
+      this.client,
+      `/v1/instagram/locations/${pk}/recent`,
+      options
+    );
+  }
+  /** Search locations by name. */
+  async search(query) {
+    return this.client.request(
+      "/v1/instagram/locations/search",
+      { params: { query } }
+    );
+  }
+};
+var AudioClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /** Get an audio track's info. */
+  async get(audioId) {
+    return this.client.request(`/v1/instagram/audio/${audioId}`);
+  }
+  /** Get media that use an audio track. */
+  async media(audioId, options = {}) {
+    return mediaFeed(
+      this.client,
+      `/v1/instagram/audio/${audioId}/media`,
+      options
+    );
+  }
+  /** Get currently-trending audio tracks. */
+  async trending() {
+    return this.client.request("/v1/instagram/audio/trending");
+  }
+};
+
+// src/instagram/client.ts
+var InstagramClient = class {
+  /** Client for user operations (profile, posts, followers, stories, highlights) */
+  users;
+  /** Client for media operations (detail, comments, replies, likers, oEmbed) */
+  media;
+  /** Client for search operations (users, hashtags, places, top, reels, music, autocomplete) */
+  search;
+  /** Client for hashtag operations (info, top, recent, reels) */
+  hashtags;
+  /** Client for location operations (info, top, recent, search) */
+  locations;
+  /** Client for audio operations (info, media, trending) */
+  audio;
+  /**
+   * Create a new Instagram client.
+   *
+   * @param client - The base HTTP client for making requests.
+   */
+  constructor(client) {
+    this.users = new UsersClient4(client);
+    this.media = new MediaClient(client);
+    this.search = new SearchClient4(client);
+    this.hashtags = new HashtagsClient(client);
+    this.locations = new LocationsClient(client);
+    this.audio = new AudioClient(client);
+  }
+};
+
 // src/redfin/client.ts
 var RedfinClient = class {
   client;
@@ -4190,7 +4508,7 @@ var RedfinClient = class {
 };
 
 // src/amazon/search.ts
-var SearchClient4 = class {
+var SearchClient5 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -4454,7 +4772,7 @@ var AmazonClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient4(client);
+    this.search = new SearchClient5(client);
     this.products = new ProductsClient2(client);
     this.listings = new ListingsClient(client);
     this.sellers = new SellersClient(client);
@@ -4463,7 +4781,7 @@ var AmazonClient = class {
 };
 
 // src/shopee/search.ts
-var SearchClient5 = class {
+var SearchClient6 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -4614,7 +4932,7 @@ var ShopeeClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient5(client);
+    this.search = new SearchClient6(client);
     this.products = new ProductsClient3(client);
     this.reviews = new ReviewsClient(client);
     this.reference = new ReferenceClient3(client);
@@ -4622,7 +4940,7 @@ var ShopeeClient = class {
 };
 
 // src/tiktok/users.ts
-var UsersClient4 = class {
+var UsersClient5 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -4801,7 +5119,7 @@ var VideosClient2 = class {
 };
 
 // src/tiktok/search.ts
-var SearchClient6 = class {
+var SearchClient7 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -4906,7 +5224,7 @@ var MusicClient = class {
 };
 
 // src/tiktok/hashtags.ts
-var HashtagsClient = class {
+var HashtagsClient2 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -5057,11 +5375,11 @@ var TikTokClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.users = new UsersClient4(client);
+    this.users = new UsersClient5(client);
     this.videos = new VideosClient2(client);
-    this.search = new SearchClient6(client);
+    this.search = new SearchClient7(client);
     this.music = new MusicClient(client);
-    this.hashtags = new HashtagsClient(client);
+    this.hashtags = new HashtagsClient2(client);
     this.trending = new TrendingClient(client);
     this.ads = new AdsClient(client);
     this.reference = new ReferenceClient4(client);
@@ -5069,7 +5387,7 @@ var TikTokClient = class {
 };
 
 // src/ebay/search.ts
-var SearchClient7 = class {
+var SearchClient8 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -5302,7 +5620,7 @@ var EbayClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient7(client);
+    this.search = new SearchClient8(client);
     this.items = new ItemsClient2(client);
     this.sellers = new SellersClient2(client);
     this.categories = new CategoriesClient(client);
@@ -5311,7 +5629,7 @@ var EbayClient = class {
 };
 
 // src/youtube/search.ts
-var SearchClient8 = class {
+var SearchClient9 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -5904,7 +6222,7 @@ var YoutubeClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient8(client);
+    this.search = new SearchClient9(client);
     this.videos = new VideosClient3(client);
     this.channels = new ChannelsClient(client);
     this.playlists = new PlaylistsClient(client);
@@ -5917,7 +6235,7 @@ var YoutubeClient = class {
 };
 
 // src/realtor/search.ts
-var SearchClient9 = class {
+var SearchClient10 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6020,14 +6338,14 @@ var RealtorClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient9(client);
+    this.search = new SearchClient10(client);
     this.properties = new PropertiesClient(client);
     this.reference = new ReferenceClient7(client);
   }
 };
 
 // src/leboncoin/search.ts
-var SearchClient10 = class {
+var SearchClient11 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6200,7 +6518,7 @@ var LeboncoinClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient10(client);
+    this.search = new SearchClient11(client);
     this.ads = new AdsClient2(client);
     this.sellers = new SellersClient3(client);
     this.reference = new ReferenceClient8(client);
@@ -6208,7 +6526,7 @@ var LeboncoinClient = class {
 };
 
 // src/zillow/search.ts
-var SearchClient11 = class {
+var SearchClient12 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6343,7 +6661,7 @@ var ZillowClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient11(client);
+    this.search = new SearchClient12(client);
     this.properties = new PropertiesClient2(client);
     this.agent = new AgentClient(client);
     this.reference = new ReferenceClient9(client);
@@ -6481,7 +6799,7 @@ var ImmobiliareClient = class {
 };
 
 // src/loopnet/search.ts
-var SearchClient12 = class {
+var SearchClient13 = class {
   client;
   constructor(client) {
     this.client = client;
@@ -6605,7 +6923,7 @@ var LoopNetClient = class {
    * @param client - The base HTTP client for making requests.
    */
   constructor(client) {
-    this.search = new SearchClient12(client);
+    this.search = new SearchClient13(client);
     this.listings = new ListingsClient2(client);
     this.brokers = new BrokersClient(client);
     this.reference = new ReferenceClient10(client);
@@ -7034,6 +7352,8 @@ var ScrapeBadger = class {
   reddit;
   /** Apartments.com scraper API client — search + property with unit-level pricing (US) */
   apartments;
+  /** Instagram scraper API client — users, media, search, hashtags, locations, audio */
+  instagram;
   /** Redfin scraper API client — search, property, agent, autocomplete, markets (redfin.com, US) */
   redfin;
   /** Amazon scraper API client — 14 endpoints */
@@ -7102,6 +7422,7 @@ var ScrapeBadger = class {
     this.google = new GoogleClient(this.baseClient);
     this.reddit = new RedditClient(this.baseClient);
     this.apartments = new ApartmentsClient(this.baseClient);
+    this.instagram = new InstagramClient(this.baseClient);
     this.redfin = new RedfinClient(this.baseClient);
     this.amazon = new AmazonClient(this.baseClient);
     this.shopee = new ShopeeClient(this.baseClient);
@@ -7124,7 +7445,7 @@ exports.AmazonClient = AmazonClient;
 exports.AmazonListingsClient = ListingsClient;
 exports.AmazonProductsClient = ProductsClient2;
 exports.AmazonReferenceClient = ReferenceClient2;
-exports.AmazonSearchClient = SearchClient4;
+exports.AmazonSearchClient = SearchClient5;
 exports.AmazonSellersClient = SellersClient;
 exports.ApartmentsClient = ApartmentsClient;
 exports.AuthenticationError = AuthenticationError;
@@ -7139,7 +7460,7 @@ exports.EbayCategoriesClient = CategoriesClient;
 exports.EbayClient = EbayClient;
 exports.EbayItemsClient = ItemsClient2;
 exports.EbayReferenceClient = ReferenceClient5;
-exports.EbaySearchClient = SearchClient7;
+exports.EbaySearchClient = SearchClient8;
 exports.EbaySellersClient = SellersClient2;
 exports.GeoClient = GeoClient;
 exports.GoogleAiModeClient = AiModeClient;
@@ -7162,11 +7483,18 @@ exports.GoogleShortsClient = ShortsClient;
 exports.GoogleTrendsClient = TrendsClient2;
 exports.GoogleVideosClient = VideosClient;
 exports.ImmobiliareClient = ImmobiliareClient;
+exports.InstagramAudioClient = AudioClient;
+exports.InstagramClient = InstagramClient;
+exports.InstagramHashtagsClient = HashtagsClient;
+exports.InstagramLocationsClient = LocationsClient;
+exports.InstagramMediaClient = MediaClient;
+exports.InstagramSearchClient = SearchClient4;
+exports.InstagramUsersClient = UsersClient4;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.LeboncoinAdsClient = AdsClient2;
 exports.LeboncoinClient = LeboncoinClient;
 exports.LeboncoinReferenceClient = ReferenceClient8;
-exports.LeboncoinSearchClient = SearchClient10;
+exports.LeboncoinSearchClient = SearchClient11;
 exports.LeboncoinSellersClient = SellersClient3;
 exports.LinkedInClient = LinkedInClient;
 exports.ListsClient = ListsClient;
@@ -7174,13 +7502,13 @@ exports.LoopNetBrokersClient = BrokersClient;
 exports.LoopNetClient = LoopNetClient;
 exports.LoopNetListingsClient = ListingsClient2;
 exports.LoopNetReferenceClient = ReferenceClient10;
-exports.LoopNetSearchClient = SearchClient12;
+exports.LoopNetSearchClient = SearchClient13;
 exports.NotFoundError = NotFoundError;
 exports.RateLimitError = RateLimitError;
 exports.RealtorClient = RealtorClient;
 exports.RealtorPropertiesClient = PropertiesClient;
 exports.RealtorReferenceClient = ReferenceClient7;
-exports.RealtorSearchClient = SearchClient9;
+exports.RealtorSearchClient = SearchClient10;
 exports.RedditClient = RedditClient;
 exports.RedditPostsClient = PostsClient;
 exports.RedditSearchClient = SearchClient3;
@@ -7194,17 +7522,17 @@ exports.ShopeeClient = ShopeeClient;
 exports.ShopeeProductsClient = ProductsClient3;
 exports.ShopeeReferenceClient = ReferenceClient3;
 exports.ShopeeReviewsClient = ReviewsClient;
-exports.ShopeeSearchClient = SearchClient5;
+exports.ShopeeSearchClient = SearchClient6;
 exports.SpacesClient = SpacesClient;
 exports.StreamClient = StreamClient;
 exports.TikTokAdsClient = AdsClient;
 exports.TikTokClient = TikTokClient;
-exports.TikTokHashtagsClient = HashtagsClient;
+exports.TikTokHashtagsClient = HashtagsClient2;
 exports.TikTokMusicClient = MusicClient;
 exports.TikTokReferenceClient = ReferenceClient4;
-exports.TikTokSearchClient = SearchClient6;
+exports.TikTokSearchClient = SearchClient7;
 exports.TikTokTrendingClient = TrendingClient;
-exports.TikTokUsersClient = UsersClient4;
+exports.TikTokUsersClient = UsersClient5;
 exports.TikTokVideosClient = VideosClient2;
 exports.TimeoutError = TimeoutError;
 exports.TrendsClient = TrendsClient;
@@ -7225,7 +7553,7 @@ exports.YoutubeCommunityClient = CommunityClient;
 exports.YoutubeMusicClient = MusicClient2;
 exports.YoutubePlaylistsClient = PlaylistsClient;
 exports.YoutubeReferenceClient = ReferenceClient6;
-exports.YoutubeSearchClient = SearchClient8;
+exports.YoutubeSearchClient = SearchClient9;
 exports.YoutubeShortsClient = ShortsClient2;
 exports.YoutubeTrendingClient = TrendingClient2;
 exports.YoutubeVideosClient = VideosClient3;
@@ -7233,7 +7561,7 @@ exports.ZillowAgentClient = AgentClient;
 exports.ZillowClient = ZillowClient;
 exports.ZillowPropertiesClient = PropertiesClient2;
 exports.ZillowReferenceClient = ReferenceClient9;
-exports.ZillowSearchClient = SearchClient11;
+exports.ZillowSearchClient = SearchClient12;
 exports.collectAll = collectAll;
 exports.verifyWebhookSignature = verifyWebhookSignature;
 //# sourceMappingURL=index.js.map