scrapebadger 0.39.0 → 0.40.1

package/dist/index.d.cts

@@ -1229,14 +1229,21 @@ interface ShoppingClickParams {
     product_id?: string;
 }
 /**
- * Params for `/v1/google/shopping/offers` — resolve a product by barcode
- * (GTIN-8/UPC-A/EAN-13/GTIN-14) and return its multi-seller Google
- * Shopping offers. Returns 422 for an invalid/checksum-failing barcode and
- * 404 when the barcode can't be resolved to a product.
+ * Params for `/v1/google/shopping/offers` — multi-seller Google Shopping
+ * offers for a product identified by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14,
+ * resolved via Google web search first) OR by its Google Shopping
+ * `catalog_id` (sellers read straight off Google's product page). Exactly
+ * one of the two is required (400 otherwise); 422 for an invalid/
+ * checksum-failing barcode, 404 when nothing resolves.
  */
 interface ShoppingOffersParams {
     /** Product barcode: a GTIN-8, UPC-A, EAN-13, or GTIN-14. */
-    barcode: string;
+    barcode?: string;
+    /**
+     * Google Shopping `catalogid` — the `catalog_id` on `shopping.search`
+     * tiles, or `prds=catalogid:…` in a Google Shopping URL.
+     */
+    catalog_id?: string;
     /** ISO-3166 alpha-2 country code (e.g. `us`). */
     gl?: string;
     /** UI/results language (e.g. `en`). Defaults to `en`. */
@@ -2015,9 +2022,11 @@ declare class ShoppingClient {
      */
     click(params: ShoppingClickParams): Promise<GoogleResponse>;
     /**
-     * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-     * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-     * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+     * Multi-seller Google Shopping offers for a product, by `barcode`
+     * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+     * by Google Shopping `catalog_id` (sellers read off Google's product page).
+     * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+     * (nothing resolves).
      */
     offers(params: ShoppingOffersParams): Promise<GoogleResponse>;
 }
@@ -4134,7 +4143,10 @@ declare class UsersClient$1 {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     about(username: string): Promise<UserAbout>;
-    /** Get accounts related/suggested for a user. */
+    /**
+     * Get accounts related/suggested for a user.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     related(username: string): Promise<Paginated<UserShort>>;
     /** Get a user's timeline posts. */
     posts(username: string, options?: {
@@ -4246,7 +4258,10 @@ declare class MediaClient$3 {
      * @param code - The media shortcode (from the `/p/<code>/` URL).
      */
     get(code: string): Promise<Media>;
-    /** Get oEmbed metadata for a media permalink. */
+    /**
+     * Get oEmbed metadata for a media permalink.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     oembed(code: string): Promise<Oembed>;
     /** Get top-level comments on a media. */
     comments(code: string, options?: {
@@ -4266,7 +4281,10 @@ declare class MediaClient$3 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Comment$1>>;
-    /** Get the users who liked a comment. */
+    /**
+     * Get the users who liked a comment.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     commentLikers(code: string, commentId: string): Promise<Paginated<UserShort>>;
 }
 
@@ -4300,7 +4318,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     users(query: string): Promise<Paginated<UserShort>>;
-    /** Search hashtags. */
+    /**
+     * Search hashtags.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     hashtags(query: string): Promise<Paginated<Hashtag>>;
     /**
      * Search places/locations.
@@ -4317,7 +4338,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     music(query: string): Promise<Paginated<Audio>>;
-    /** Get blended "top" results (users, hashtags, and places). */
+    /**
+     * Get blended "top" results (users, hashtags, and places).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     top(query: string): Promise<SearchTopResponse>;
     /**
      * Get typeahead/autocomplete suggestions (mixed entity types).
@@ -4337,7 +4361,10 @@ declare class SearchClient$e {
 declare class HashtagsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
-    /** Get a hashtag's info (media count, cover). */
+    /**
+     * Get a hashtag's info (media count, cover).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     get(tag: string): Promise<Hashtag>;
     /**
      * Get the top/popular media for a hashtag.
@@ -4347,7 +4374,10 @@ declare class HashtagsClient$1 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Media>>;
-    /** Get the most recent media for a hashtag. */
+    /**
+     * Get the most recent media for a hashtag.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     recent(tag: string, options?: {
         amount?: number;
         cursor?: string;

package/dist/index.d.ts

@@ -1229,14 +1229,21 @@ interface ShoppingClickParams {
     product_id?: string;
 }
 /**
- * Params for `/v1/google/shopping/offers` — resolve a product by barcode
- * (GTIN-8/UPC-A/EAN-13/GTIN-14) and return its multi-seller Google
- * Shopping offers. Returns 422 for an invalid/checksum-failing barcode and
- * 404 when the barcode can't be resolved to a product.
+ * Params for `/v1/google/shopping/offers` — multi-seller Google Shopping
+ * offers for a product identified by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14,
+ * resolved via Google web search first) OR by its Google Shopping
+ * `catalog_id` (sellers read straight off Google's product page). Exactly
+ * one of the two is required (400 otherwise); 422 for an invalid/
+ * checksum-failing barcode, 404 when nothing resolves.
  */
 interface ShoppingOffersParams {
     /** Product barcode: a GTIN-8, UPC-A, EAN-13, or GTIN-14. */
-    barcode: string;
+    barcode?: string;
+    /**
+     * Google Shopping `catalogid` — the `catalog_id` on `shopping.search`
+     * tiles, or `prds=catalogid:…` in a Google Shopping URL.
+     */
+    catalog_id?: string;
     /** ISO-3166 alpha-2 country code (e.g. `us`). */
     gl?: string;
     /** UI/results language (e.g. `en`). Defaults to `en`. */
@@ -2015,9 +2022,11 @@ declare class ShoppingClient {
      */
     click(params: ShoppingClickParams): Promise<GoogleResponse>;
     /**
-     * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-     * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-     * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+     * Multi-seller Google Shopping offers for a product, by `barcode`
+     * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+     * by Google Shopping `catalog_id` (sellers read off Google's product page).
+     * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+     * (nothing resolves).
      */
     offers(params: ShoppingOffersParams): Promise<GoogleResponse>;
 }
@@ -4134,7 +4143,10 @@ declare class UsersClient$1 {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     about(username: string): Promise<UserAbout>;
-    /** Get accounts related/suggested for a user. */
+    /**
+     * Get accounts related/suggested for a user.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     related(username: string): Promise<Paginated<UserShort>>;
     /** Get a user's timeline posts. */
     posts(username: string, options?: {
@@ -4246,7 +4258,10 @@ declare class MediaClient$3 {
      * @param code - The media shortcode (from the `/p/<code>/` URL).
      */
     get(code: string): Promise<Media>;
-    /** Get oEmbed metadata for a media permalink. */
+    /**
+     * Get oEmbed metadata for a media permalink.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     oembed(code: string): Promise<Oembed>;
     /** Get top-level comments on a media. */
     comments(code: string, options?: {
@@ -4266,7 +4281,10 @@ declare class MediaClient$3 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Comment$1>>;
-    /** Get the users who liked a comment. */
+    /**
+     * Get the users who liked a comment.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     commentLikers(code: string, commentId: string): Promise<Paginated<UserShort>>;
 }
 
@@ -4300,7 +4318,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     users(query: string): Promise<Paginated<UserShort>>;
-    /** Search hashtags. */
+    /**
+     * Search hashtags.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     hashtags(query: string): Promise<Paginated<Hashtag>>;
     /**
      * Search places/locations.
@@ -4317,7 +4338,10 @@ declare class SearchClient$e {
      * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
      */
     music(query: string): Promise<Paginated<Audio>>;
-    /** Get blended "top" results (users, hashtags, and places). */
+    /**
+     * Get blended "top" results (users, hashtags, and places).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     top(query: string): Promise<SearchTopResponse>;
     /**
      * Get typeahead/autocomplete suggestions (mixed entity types).
@@ -4337,7 +4361,10 @@ declare class SearchClient$e {
 declare class HashtagsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
-    /** Get a hashtag's info (media count, cover). */
+    /**
+     * Get a hashtag's info (media count, cover).
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     get(tag: string): Promise<Hashtag>;
     /**
      * Get the top/popular media for a hashtag.
@@ -4347,7 +4374,10 @@ declare class HashtagsClient$1 {
         amount?: number;
         cursor?: string;
     }): Promise<Paginated<Media>>;
-    /** Get the most recent media for a hashtag. */
+    /**
+     * Get the most recent media for a hashtag.
+     * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+     */
     recent(tag: string, options?: {
         amount?: number;
         cursor?: string;

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.38.0";
+var SDK_VERSION = "0.40.1";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -3336,9 +3336,11 @@ var ShoppingClient = class {
     });
   }
   /**
-   * Resolve a product by `barcode` (GTIN-8/UPC-A/EAN-13/GTIN-14) and return
-   * its multi-seller Google Shopping offers. Throws on a 422 (invalid or
-   * checksum-failing barcode) or 404 (barcode not resolvable to a product).
+   * Multi-seller Google Shopping offers for a product, by `barcode`
+   * (GTIN-8/UPC-A/EAN-13/GTIN-14, resolved via Google web search first) or
+   * by Google Shopping `catalog_id` (sellers read off Google's product page).
+   * Throws on 400 (not exactly one identifier), 422 (invalid barcode) or 404
+   * (nothing resolves).
    */
   async offers(params) {
     return this.client.request("/v1/google/shopping/offers", {
@@ -4300,7 +4302,10 @@ var UsersClient4 = class {
   async about(username) {
     return this.client.request(`/v1/instagram/users/${username}/about`);
   }
-  /** Get accounts related/suggested for a user. */
+  /**
+   * Get accounts related/suggested for a user.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async related(username) {
     return this.client.request(`/v1/instagram/users/${username}/related`);
   }
@@ -4411,7 +4416,10 @@ var MediaClient = class {
   async get(code) {
     return this.client.request(`/v1/instagram/media/${code}`);
   }
-  /** Get oEmbed metadata for a media permalink. */
+  /**
+   * Get oEmbed metadata for a media permalink.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async oembed(code) {
     return this.client.request(`/v1/instagram/media/${code}/oembed`);
   }
@@ -4438,7 +4446,10 @@ var MediaClient = class {
       { params: { amount: options.amount, cursor: options.cursor } }
     );
   }
-  /** Get the users who liked a comment. */
+  /**
+   * Get the users who liked a comment.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async commentLikers(code, commentId) {
     return this.client.request(
       `/v1/instagram/media/${code}/comments/${commentId}/likers`
@@ -4461,7 +4472,10 @@ var SearchClient4 = class {
       params: { query }
     });
   }
-  /** Search hashtags. */
+  /**
+   * Search hashtags.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async hashtags(query) {
     return this.client.request("/v1/instagram/search/hashtags", {
       params: { query }
@@ -4494,7 +4508,10 @@ var SearchClient4 = class {
       params: { query }
     });
   }
-  /** Get blended "top" results (users, hashtags, and places). */
+  /**
+   * Get blended "top" results (users, hashtags, and places).
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async top(query) {
     return this.client.request("/v1/instagram/search/top", {
       params: { query }
@@ -4522,7 +4539,10 @@ var HashtagsClient = class {
   constructor(client) {
     this.client = client;
   }
-  /** Get a hashtag's info (media count, cover). */
+  /**
+   * Get a hashtag's info (media count, cover).
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async get(tag) {
     return this.client.request(`/v1/instagram/hashtags/${tag}`);
   }
@@ -4533,7 +4553,10 @@ var HashtagsClient = class {
   async top(tag, options = {}) {
     return mediaFeed(this.client, `/v1/instagram/hashtags/${tag}/top`, options);
   }
-  /** Get the most recent media for a hashtag. */
+  /**
+   * Get the most recent media for a hashtag.
+   * @deprecated Temporarily unavailable — authenticated data is temporarily offline.
+   */
   async recent(tag, options = {}) {
     return mediaFeed(this.client, `/v1/instagram/hashtags/${tag}/recent`, options);
   }