scrapebadger 0.23.0 → 0.24.1

package/dist/index.d.cts

@@ -243,10 +243,22 @@ interface VintedItemSummary {
     brand_title: string;
     /** Size label */
     size_title: string;
-    /** Item condition status */
+    /** Item condition status, localized to the market */
     status: string;
     /** Item URL on Vinted */
     url: string;
+    /** Path portion of the item URL */
+    path: string | null;
+    /** Buyer-protection fee as a decimal string, in `price.currency_code` */
+    service_fee: string | null;
+    /** Price + buyer protection as a decimal string, in `price.currency_code` */
+    total_item_price: string | null;
+    /** Whether the listing is publicly visible */
+    is_visible: boolean;
+    /** Whether the listing is a promoted/bumped placement */
+    promoted: boolean;
+    /** Vinted's own label for where the result came from (e.g. "search") */
+    content_source: string | null;
     /** Number of users who favorited this item */
     favourite_count: number;
     /** Number of views */
@@ -269,20 +281,31 @@ interface VintedItemSummary {
 interface VintedItemDetail extends VintedItemSummary {
     /** Item description */
     description: string;
-    /** Catalog category identifier */
+    /** Catalog category identifier — the value to pass as `catalog_ids` when searching */
     catalog_id: number;
-    /** Primary color */
+    /** Primary color, localized. May list several, comma-separated */
     color1: string;
+    /** Secondary color */
+    color2: string | null;
     /** Seller details */
     seller: VintedSellerSummary;
-    /** Category name */
-    category: string;
-    /** Upload timestamp (ISO format) */
+    /** Category breadcrumb, root first, localized to the market */
+    category: string[];
+    /**
+     * Vinted's relative "listed" label, localized (e.g. "Il y a une semaine").
+     * Not an ISO timestamp.
+     */
     upload_date: string;
     /** Whether the item can be purchased */
     can_buy: boolean;
     /** Whether instant buy is enabled */
     instant_buy: boolean;
+    /** Whether the seller accepts bundles */
+    can_bundle: boolean;
+    /** Whether the item can be reserved */
+    can_reserve: boolean;
+    /** Whether the item is favourited */
+    is_favourite: boolean;
     /** Whether the listing is closed */
     is_closed: boolean;
     /** Whether the item is reserved */
@@ -501,6 +524,15 @@ interface VintedSearchParams {
     price_to?: number;
     /** Comma-separated brand IDs */
     brand_ids?: string;
+    /**
+     * Comma-separated Vinted catalog (category) IDs to restrict the search to
+     * (e.g. "221" or "221,1242"). Vinted applies this before the search runs,
+     * and sub-categories are included.
+     *
+     * A catalog ID is the `catalog[]` value in a Vinted category URL
+     * (vinted.fr/catalog?catalog[]=221). IDs are per market.
+     */
+    catalog_ids?: string;
     /** Comma-separated color IDs */
     color_ids?: string;
     /** Comma-separated status IDs */
@@ -516,7 +548,8 @@ interface VintedSearchParams {
      * When set, each returned item gains a `seller_country_code` and the response
      * gains a top-level `seller_country` echo.
      *
-     * Billing: 1 base credit + 1 credit per uncached seller looked up.
+     * Billing: a search is a flat 5 credits whatever filters you pass; seller
+     * lookups are not billed on top.
      */
     seller_country?: string;
 }
@@ -575,8 +608,16 @@ declare class SearchClient$b {
      *
      * @example
      * ```typescript
+     * // Restrict to a Vinted category (women's T-shirts on vinted.fr).
+     * const tshirts = await client.vinted.search.search({
+     *   query: "nike",
+     *   catalog_ids: "221",
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
      * // Filter results to sellers physically located in France or Belgium.
-     * // Billing: 1 base credit + 1 credit per uncached seller looked up.
      * const local = await client.vinted.search.search({
      *   query: "vintage jacket",
      *   seller_country: "fr,be",
@@ -1647,8 +1688,10 @@ declare class JobsClient {
  * Client for Google Lens visual search by image URL.
  *
  * Response carries `lens_results` (Scrapingdog-parity alias) with
- * `title`, `source`, `source_favicon`, `thumbnail`, optional `tag`
- * price chip and `in_stock`, plus `related_searches` chips. Legacy
+ * `title`, `source`, `source_favicon`, `thumbnail`, `rating`,
+ * `reviews` and `in_stock`. Shoppable matches also carry `price`
+ * (`{value, currency, extracted}`) plus the raw `tag` chip it is
+ * parsed from. `related_searches` chips come alongside. Legacy
  * `results` alias retained for backwards compat.
  *
  * @example
@@ -1658,7 +1701,7 @@ declare class JobsClient {
  *   product: true, // bias towards shoppable matches
  * });
  * for (const match of out.lens_results) {
- *   console.log(match.title, match.tag);
+ *   console.log(match.title, match.price?.value, match.price?.currency);
  * }
  * ```
  */

package/dist/index.d.ts

@@ -243,10 +243,22 @@ interface VintedItemSummary {
     brand_title: string;
     /** Size label */
     size_title: string;
-    /** Item condition status */
+    /** Item condition status, localized to the market */
     status: string;
     /** Item URL on Vinted */
     url: string;
+    /** Path portion of the item URL */
+    path: string | null;
+    /** Buyer-protection fee as a decimal string, in `price.currency_code` */
+    service_fee: string | null;
+    /** Price + buyer protection as a decimal string, in `price.currency_code` */
+    total_item_price: string | null;
+    /** Whether the listing is publicly visible */
+    is_visible: boolean;
+    /** Whether the listing is a promoted/bumped placement */
+    promoted: boolean;
+    /** Vinted's own label for where the result came from (e.g. "search") */
+    content_source: string | null;
     /** Number of users who favorited this item */
     favourite_count: number;
     /** Number of views */
@@ -269,20 +281,31 @@ interface VintedItemSummary {
 interface VintedItemDetail extends VintedItemSummary {
     /** Item description */
     description: string;
-    /** Catalog category identifier */
+    /** Catalog category identifier — the value to pass as `catalog_ids` when searching */
     catalog_id: number;
-    /** Primary color */
+    /** Primary color, localized. May list several, comma-separated */
     color1: string;
+    /** Secondary color */
+    color2: string | null;
     /** Seller details */
     seller: VintedSellerSummary;
-    /** Category name */
-    category: string;
-    /** Upload timestamp (ISO format) */
+    /** Category breadcrumb, root first, localized to the market */
+    category: string[];
+    /**
+     * Vinted's relative "listed" label, localized (e.g. "Il y a une semaine").
+     * Not an ISO timestamp.
+     */
     upload_date: string;
     /** Whether the item can be purchased */
     can_buy: boolean;
     /** Whether instant buy is enabled */
     instant_buy: boolean;
+    /** Whether the seller accepts bundles */
+    can_bundle: boolean;
+    /** Whether the item can be reserved */
+    can_reserve: boolean;
+    /** Whether the item is favourited */
+    is_favourite: boolean;
     /** Whether the listing is closed */
     is_closed: boolean;
     /** Whether the item is reserved */
@@ -501,6 +524,15 @@ interface VintedSearchParams {
     price_to?: number;
     /** Comma-separated brand IDs */
     brand_ids?: string;
+    /**
+     * Comma-separated Vinted catalog (category) IDs to restrict the search to
+     * (e.g. "221" or "221,1242"). Vinted applies this before the search runs,
+     * and sub-categories are included.
+     *
+     * A catalog ID is the `catalog[]` value in a Vinted category URL
+     * (vinted.fr/catalog?catalog[]=221). IDs are per market.
+     */
+    catalog_ids?: string;
     /** Comma-separated color IDs */
     color_ids?: string;
     /** Comma-separated status IDs */
@@ -516,7 +548,8 @@ interface VintedSearchParams {
      * When set, each returned item gains a `seller_country_code` and the response
      * gains a top-level `seller_country` echo.
      *
-     * Billing: 1 base credit + 1 credit per uncached seller looked up.
+     * Billing: a search is a flat 5 credits whatever filters you pass; seller
+     * lookups are not billed on top.
      */
     seller_country?: string;
 }
@@ -575,8 +608,16 @@ declare class SearchClient$b {
      *
      * @example
      * ```typescript
+     * // Restrict to a Vinted category (women's T-shirts on vinted.fr).
+     * const tshirts = await client.vinted.search.search({
+     *   query: "nike",
+     *   catalog_ids: "221",
+     * });
+     * ```
+     *
+     * @example
+     * ```typescript
      * // Filter results to sellers physically located in France or Belgium.
-     * // Billing: 1 base credit + 1 credit per uncached seller looked up.
      * const local = await client.vinted.search.search({
      *   query: "vintage jacket",
      *   seller_country: "fr,be",
@@ -1647,8 +1688,10 @@ declare class JobsClient {
  * Client for Google Lens visual search by image URL.
  *
  * Response carries `lens_results` (Scrapingdog-parity alias) with
- * `title`, `source`, `source_favicon`, `thumbnail`, optional `tag`
- * price chip and `in_stock`, plus `related_searches` chips. Legacy
+ * `title`, `source`, `source_favicon`, `thumbnail`, `rating`,
+ * `reviews` and `in_stock`. Shoppable matches also carry `price`
+ * (`{value, currency, extracted}`) plus the raw `tag` chip it is
+ * parsed from. `related_searches` chips come alongside. Legacy
  * `results` alias retained for backwards compat.
  *
  * @example
@@ -1658,7 +1701,7 @@ declare class JobsClient {
  *   product: true, // bias towards shoppable matches
  * });
  * for (const match of out.lens_results) {
- *   console.log(match.title, match.tag);
+ *   console.log(match.title, match.price?.value, match.price?.currency);
  * }
  * ```
  */

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.23.0";
+var SDK_VERSION = "0.24.1";
 
 // src/internal/exceptions.ts
 var ScrapeBadgerError = class _ScrapeBadgerError extends Error {
@@ -2534,8 +2534,16 @@ var SearchClient = class {
    *
    * @example
    * ```typescript
+   * // Restrict to a Vinted category (women's T-shirts on vinted.fr).
+   * const tshirts = await client.vinted.search.search({
+   *   query: "nike",
+   *   catalog_ids: "221",
+   * });
+   * ```
+   *
+   * @example
+   * ```typescript
    * // Filter results to sellers physically located in France or Belgium.
-   * // Billing: 1 base credit + 1 credit per uncached seller looked up.
    * const local = await client.vinted.search.search({
    *   query: "vintage jacket",
    *   seller_country: "fr,be",
@@ -2555,6 +2563,7 @@ var SearchClient = class {
         price_from: params.price_from,
         price_to: params.price_to,
         brand_ids: params.brand_ids,
+        catalog_ids: params.catalog_ids,
         color_ids: params.color_ids,
         status_ids: params.status_ids,
         order: params.order,