scrapebadger 0.13.1 → 0.14.0

package/dist/index.d.cts

@@ -257,6 +257,11 @@ interface VintedItemSummary {
     photo: VintedPhoto;
     /** All photos */
     photos: VintedPhoto[];
+    /**
+     * Physical country of the seller as an upper-case ISO-2 code (e.g. "FR"),
+     * or null. Populated only when the `seller_country` search filter is used.
+     */
+    seller_country_code: string | null;
 }
 /**
  * Full item detail with all metadata.
@@ -413,6 +418,11 @@ interface SearchResponse$1 {
     pagination: VintedPagination;
     /** Market code used for this search */
     market: string;
+    /**
+     * Echo of the normalized `seller_country` filter applied to this search
+     * (comma-separated ISO-2 codes, e.g. "fr,be"), or null when no filter was used.
+     */
+    seller_country: string | null;
 }
 /**
  * Response from the item detail endpoint.
@@ -497,6 +507,18 @@ interface VintedSearchParams {
     status_ids?: string;
     /** Sort order */
     order?: "relevance" | "newest_first" | "price_low_to_high" | "price_high_to_low";
+    /**
+     * Filter results to items whose seller is physically located in one of the
+     * given countries. A comma-separated list of ISO-2 country codes (e.g. "fr"
+     * or "fr,be"). Vinted federates cross-border EU listings into each market
+     * domain and has no native country filter, so this is applied by ScrapeBadger.
+     *
+     * 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.
+     */
+    seller_country?: string;
 }
 
 /**
@@ -550,6 +572,19 @@ declare class SearchClient$5 {
      * });
      * console.log(`Found ${results.pagination.total_entries} items`);
      * ```
+     *
+     * @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",
+     * });
+     * for (const item of local.items) {
+     *   console.log(`${item.title} — seller in ${item.seller_country_code}`);
+     * }
+     * ```
      */
     search(params: VintedSearchParams): Promise<SearchResponse$1>;
 }

package/dist/index.d.ts

@@ -257,6 +257,11 @@ interface VintedItemSummary {
     photo: VintedPhoto;
     /** All photos */
     photos: VintedPhoto[];
+    /**
+     * Physical country of the seller as an upper-case ISO-2 code (e.g. "FR"),
+     * or null. Populated only when the `seller_country` search filter is used.
+     */
+    seller_country_code: string | null;
 }
 /**
  * Full item detail with all metadata.
@@ -413,6 +418,11 @@ interface SearchResponse$1 {
     pagination: VintedPagination;
     /** Market code used for this search */
     market: string;
+    /**
+     * Echo of the normalized `seller_country` filter applied to this search
+     * (comma-separated ISO-2 codes, e.g. "fr,be"), or null when no filter was used.
+     */
+    seller_country: string | null;
 }
 /**
  * Response from the item detail endpoint.
@@ -497,6 +507,18 @@ interface VintedSearchParams {
     status_ids?: string;
     /** Sort order */
     order?: "relevance" | "newest_first" | "price_low_to_high" | "price_high_to_low";
+    /**
+     * Filter results to items whose seller is physically located in one of the
+     * given countries. A comma-separated list of ISO-2 country codes (e.g. "fr"
+     * or "fr,be"). Vinted federates cross-border EU listings into each market
+     * domain and has no native country filter, so this is applied by ScrapeBadger.
+     *
+     * 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.
+     */
+    seller_country?: string;
 }
 
 /**
@@ -550,6 +572,19 @@ declare class SearchClient$5 {
      * });
      * console.log(`Found ${results.pagination.total_entries} items`);
      * ```
+     *
+     * @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",
+     * });
+     * for (const item of local.items) {
+     *   console.log(`${item.title} — seller in ${item.seller_country_code}`);
+     * }
+     * ```
      */
     search(params: VintedSearchParams): Promise<SearchResponse$1>;
 }

package/dist/index.js

@@ -2531,6 +2531,19 @@ var SearchClient = class {
    * });
    * console.log(`Found ${results.pagination.total_entries} items`);
    * ```
+   *
+   * @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",
+   * });
+   * for (const item of local.items) {
+   *   console.log(`${item.title} — seller in ${item.seller_country_code}`);
+   * }
+   * ```
    */
   async search(params) {
     return this.client.request("/v1/vinted/search", {
@@ -2544,7 +2557,8 @@ var SearchClient = class {
         brand_ids: params.brand_ids,
         color_ids: params.color_ids,
         status_ids: params.status_ids,
-        order: params.order
+        order: params.order,
+        seller_country: params.seller_country
       }
     });
   }