scrapebadger 0.49.0 → 0.51.0

package/dist/index.d.cts

@@ -335,10 +335,12 @@ interface VintedItemSummary {
      */
     seller_country_code: string | null;
     /**
-     * Visual similarity to the query image, 0-1, where the query image's own
-     * listing scores 1.0. Populated only by `searchByImage`, and only on the
-     * calls where Vinted returns a ranking; null otherwise. A null says nothing
-     * about the item.
+     * Visual similarity to the query image, on Vinted's own unbounded scale --
+     * it read 0-1 in Sep 2026 and ~36-44 since, and can change again without
+     * notice. ORDINAL ONLY: rank against the other items in the same response,
+     * never against a fixed threshold and never across responses. Populated
+     * only by `searchByImage`, and only on the calls where Vinted returns a
+     * ranking; null otherwise. A null says nothing about the item.
      */
     similarity_score: number | null;
 }
@@ -360,9 +362,18 @@ interface VintedItemDetail extends VintedItemSummary {
     category: string[];
     /**
      * Vinted's relative "listed" label, localized (e.g. "Il y a une semaine").
-     * Not an ISO timestamp.
+     * Not an ISO timestamp — some markets render it without a number at all
+     * ("godziny"), so it cannot be parsed into a date. Use `uploaded_at`.
      */
     upload_date: string;
+    /**
+     * Approximate absolute upload time, ISO 8601 UTC (e.g.
+     * "2026-09-23T11:28:44Z"), derived from the earliest photo Vinted
+     * timestamps. A lower bound on age: replacing a photo after listing moves
+     * it forward. Null when Vinted stamps no photo. Item detail only — search
+     * and image search responses carry no photo timestamps.
+     */
+    uploaded_at: string | null;
     /** Whether the item can be purchased */
     can_buy: boolean;
     /** Whether instant buy is enabled */
@@ -7055,6 +7066,8 @@ interface TikTokRelatedParams {
     region?: string;
     /** Number of items to return (1-50) */
     count?: number;
+    /** Opaque continuation cursor; expires after 15 minutes. */
+    cursor?: string;
 }
 /** Options for the transcript endpoint. */
 interface TikTokTranscriptParams {
@@ -7111,7 +7124,7 @@ interface TikTokTrendingVideosParams {
 interface TikTokTrendingParams {
     /** Content region (ISO 3166-1 alpha-2, default "US") */
     region?: string;
-    /** Trailing window in days (default 7) */
+    /** Historical windows are unavailable; omit this parameter. */
     period?: number;
     /** Number of items to return (1-50) */
     count?: number;
@@ -7193,9 +7206,7 @@ declare class UsersClient {
     /**
      * Get a TikTok user's followers (best-effort; often guest-gated).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count, cursor).
@@ -7205,9 +7216,7 @@ declare class UsersClient {
     /**
      * Get accounts a TikTok user follows (best-effort).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count, cursor).
@@ -7217,9 +7226,7 @@ declare class UsersClient {
     /**
      * Get a TikTok user's liked videos (only if their Liked tab is public).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count).

package/dist/index.d.ts

@@ -335,10 +335,12 @@ interface VintedItemSummary {
      */
     seller_country_code: string | null;
     /**
-     * Visual similarity to the query image, 0-1, where the query image's own
-     * listing scores 1.0. Populated only by `searchByImage`, and only on the
-     * calls where Vinted returns a ranking; null otherwise. A null says nothing
-     * about the item.
+     * Visual similarity to the query image, on Vinted's own unbounded scale --
+     * it read 0-1 in Sep 2026 and ~36-44 since, and can change again without
+     * notice. ORDINAL ONLY: rank against the other items in the same response,
+     * never against a fixed threshold and never across responses. Populated
+     * only by `searchByImage`, and only on the calls where Vinted returns a
+     * ranking; null otherwise. A null says nothing about the item.
      */
     similarity_score: number | null;
 }
@@ -360,9 +362,18 @@ interface VintedItemDetail extends VintedItemSummary {
     category: string[];
     /**
      * Vinted's relative "listed" label, localized (e.g. "Il y a une semaine").
-     * Not an ISO timestamp.
+     * Not an ISO timestamp — some markets render it without a number at all
+     * ("godziny"), so it cannot be parsed into a date. Use `uploaded_at`.
      */
     upload_date: string;
+    /**
+     * Approximate absolute upload time, ISO 8601 UTC (e.g.
+     * "2026-09-23T11:28:44Z"), derived from the earliest photo Vinted
+     * timestamps. A lower bound on age: replacing a photo after listing moves
+     * it forward. Null when Vinted stamps no photo. Item detail only — search
+     * and image search responses carry no photo timestamps.
+     */
+    uploaded_at: string | null;
     /** Whether the item can be purchased */
     can_buy: boolean;
     /** Whether instant buy is enabled */
@@ -7055,6 +7066,8 @@ interface TikTokRelatedParams {
     region?: string;
     /** Number of items to return (1-50) */
     count?: number;
+    /** Opaque continuation cursor; expires after 15 minutes. */
+    cursor?: string;
 }
 /** Options for the transcript endpoint. */
 interface TikTokTranscriptParams {
@@ -7111,7 +7124,7 @@ interface TikTokTrendingVideosParams {
 interface TikTokTrendingParams {
     /** Content region (ISO 3166-1 alpha-2, default "US") */
     region?: string;
-    /** Trailing window in days (default 7) */
+    /** Historical windows are unavailable; omit this parameter. */
     period?: number;
     /** Number of items to return (1-50) */
     count?: number;
@@ -7193,9 +7206,7 @@ declare class UsersClient {
     /**
      * Get a TikTok user's followers (best-effort; often guest-gated).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count, cursor).
@@ -7205,9 +7216,7 @@ declare class UsersClient {
     /**
      * Get accounts a TikTok user follows (best-effort).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count, cursor).
@@ -7217,9 +7226,7 @@ declare class UsersClient {
     /**
      * Get a TikTok user's liked videos (only if their Liked tab is public).
      *
-     * @deprecated Requires an authenticated session; currently returns 410.
-     * Kept for forward-compatibility — the endpoint may be re-enabled when
-     * session-based access is supported.
+     * Public data is available without a TikTok account. Hidden lists return 403.
      *
      * @param username - The user's @handle.
      * @param options - Optional parameters (region, count).

package/dist/index.js

@@ -5305,9 +5305,7 @@ var UsersClient5 = class {
   /**
    * Get a TikTok user's followers (best-effort; often guest-gated).
    *
-   * @deprecated Requires an authenticated session; currently returns 410.
-   * Kept for forward-compatibility — the endpoint may be re-enabled when
-   * session-based access is supported.
+   * Public data is available without a TikTok account. Hidden lists return 403.
    *
    * @param username - The user's @handle.
    * @param options - Optional parameters (region, count, cursor).
@@ -5321,9 +5319,7 @@ var UsersClient5 = class {
   /**
    * Get accounts a TikTok user follows (best-effort).
    *
-   * @deprecated Requires an authenticated session; currently returns 410.
-   * Kept for forward-compatibility — the endpoint may be re-enabled when
-   * session-based access is supported.
+   * Public data is available without a TikTok account. Hidden lists return 403.
    *
    * @param username - The user's @handle.
    * @param options - Optional parameters (region, count, cursor).
@@ -5337,9 +5333,7 @@ var UsersClient5 = class {
   /**
    * Get a TikTok user's liked videos (only if their Liked tab is public).
    *
-   * @deprecated Requires an authenticated session; currently returns 410.
-   * Kept for forward-compatibility — the endpoint may be re-enabled when
-   * session-based access is supported.
+   * Public data is available without a TikTok account. Hidden lists return 403.
    *
    * @param username - The user's @handle.
    * @param options - Optional parameters (region, count).
@@ -5347,7 +5341,7 @@ var UsersClient5 = class {
    */
   async liked(username, options = {}) {
     return this.client.request(`/v1/tiktok/users/${username}/liked`, {
-      params: { region: options.region, count: options.count }
+      params: { region: options.region, count: options.count, cursor: options.cursor }
     });
   }
   /**
@@ -5359,7 +5353,7 @@ var UsersClient5 = class {
    */
   async reposts(username, options = {}) {
     return this.client.request(`/v1/tiktok/users/${username}/reposts`, {
-      params: { region: options.region, count: options.count }
+      params: { region: options.region, count: options.count, cursor: options.cursor }
     });
   }
 };
@@ -5421,7 +5415,7 @@ var VideosClient2 = class {
    */
   async related(videoId, options = {}) {
     return this.client.request(`/v1/tiktok/videos/${videoId}/related`, {
-      params: { region: options.region, count: options.count }
+      params: { region: options.region, count: options.count, cursor: options.cursor }
     });
   }
   /**