scrapebadger 0.12.0 → 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.
@@ -469,7 +479,7 @@ interface StatusesResponse {
 /**
  * Response from the markets endpoint.
  */
-interface MarketsResponse$1 {
+interface MarketsResponse$2 {
     /** List of available markets */
     markets: VintedMarket[];
 }
@@ -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;
 }
 
 /**
@@ -528,7 +550,7 @@ interface VintedSearchParams {
  * });
  * ```
  */
-declare class SearchClient$3 {
+declare class SearchClient$5 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -550,6 +572,19 @@ declare class SearchClient$3 {
      * });
      * 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>;
 }
@@ -623,7 +658,7 @@ declare class ItemsClient {
  * }
  * ```
  */
-declare class UsersClient$1 {
+declare class UsersClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -706,7 +741,7 @@ declare class UsersClient$1 {
  * }
  * ```
  */
-declare class ReferenceClient$1 {
+declare class ReferenceClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -784,7 +819,7 @@ declare class ReferenceClient$1 {
      * }
      * ```
      */
-    markets(): Promise<MarketsResponse$1>;
+    markets(): Promise<MarketsResponse$2>;
 }
 
 /**
@@ -821,13 +856,13 @@ declare class ReferenceClient$1 {
  */
 declare class VintedClient {
     /** Client for item search operations */
-    readonly search: SearchClient$3;
+    readonly search: SearchClient$5;
     /** Client for individual item operations */
     readonly items: ItemsClient;
     /** Client for user operations */
-    readonly users: UsersClient$1;
+    readonly users: UsersClient$2;
     /** Client for reference data (brands, colors, statuses, markets) */
-    readonly reference: ReferenceClient$1;
+    readonly reference: ReferenceClient$3;
     /**
      * Create a new Vinted client.
      *
@@ -1735,7 +1770,7 @@ declare class PatentsClient {
 /**
  * Client for Google's immersive product detail endpoint.
  */
-declare class ProductsClient$1 {
+declare class ProductsClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     detail(params: ProductsDetailParams): Promise<GoogleResponse>;
@@ -1813,7 +1848,7 @@ declare class ScholarClient {
  * }
  * ```
  */
-declare class SearchClient$2 {
+declare class SearchClient$4 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -1966,7 +2001,7 @@ declare class TrendsClient {
  * }
  * ```
  */
-declare class VideosClient {
+declare class VideosClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     search(params: VideosSearchParams): Promise<GoogleResponse>;
@@ -2009,7 +2044,7 @@ declare class VideosClient {
  */
 declare class GoogleClient {
     /** Google Web Search (SERP) — with optional deferred AI Overview follow-up. */
-    readonly search: SearchClient$2;
+    readonly search: SearchClient$4;
     /** Google Maps — places, reviews, photos, posts. */
     readonly maps: MapsClient;
     /** Google News — articles, topics, trending. */
@@ -2031,7 +2066,7 @@ declare class GoogleClient {
     /** Google Images. */
     readonly images: ImagesClient;
     /** Google Videos. */
-    readonly videos: VideosClient;
+    readonly videos: VideosClient$1;
     /** Google Finance — stock and index quotes. */
     readonly finance: FinanceClient;
     /** Google AI Mode — generative answer responses. */
@@ -2043,7 +2078,7 @@ declare class GoogleClient {
     /** Google Flights — one-way, round-trip, and multi-city itineraries. */
     readonly flights: FlightsClient;
     /** Google Products — immersive product detail. */
-    readonly products: ProductsClient$1;
+    readonly products: ProductsClient$2;
     constructor(client: BaseClient);
 }
 
@@ -2840,7 +2875,7 @@ interface DomainPostsResponse {
  * const domainPosts = await client.reddit.search.domainPosts({ domain: "github.com" });
  * ```
  */
-declare class SearchClient$1 {
+declare class SearchClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -3297,7 +3332,7 @@ declare class SubredditsClient {
  * const comments = await client.reddit.users.comments("spez", { sort: "new" });
  * ```
  */
-declare class UsersClient {
+declare class UsersClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -3449,13 +3484,13 @@ declare class UsersClient {
  */
 declare class RedditClient {
     /** Client for search operations (posts, subreddits, users, domain posts) */
-    readonly search: SearchClient$1;
+    readonly search: SearchClient$3;
     /** Client for post operations (trending, details, comments, duplicates) */
     readonly posts: PostsClient;
     /** Client for subreddit operations (details, posts, rules, moderators, wiki) */
     readonly subreddits: SubredditsClient;
     /** Client for user operations (profile, posts, comments, moderated, trophies) */
-    readonly users: UsersClient;
+    readonly users: UsersClient$1;
     /**
      * Create a new Reddit client.
      *
@@ -3529,7 +3564,7 @@ interface CategoryInfo {
 /**
  * Per-star rating distribution (percentages 0-100).
  */
-interface RatingBreakdown {
+interface RatingBreakdown$1 {
     five_star: number | null;
     four_star: number | null;
     three_star: number | null;
@@ -3623,7 +3658,7 @@ interface Product {
     discount_percent: number | null;
     rating: number | null;
     ratings_total: number | null;
-    rating_breakdown: RatingBreakdown | null;
+    rating_breakdown: RatingBreakdown$1 | null;
     bought_past_month: string | null;
     in_stock: boolean | null;
     availability: string | null;
@@ -3665,7 +3700,7 @@ interface Product {
 /**
  * A single search / category-browse result row.
  */
-interface SearchResult {
+interface SearchResult$1 {
     position: number;
     asin: string;
     title: string | null;
@@ -3848,7 +3883,7 @@ interface AutocompleteSuggestion {
 interface SearchResponse {
     query: string;
     domain: string;
-    results: SearchResult[];
+    results: SearchResult$1[];
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3875,7 +3910,7 @@ interface ReviewsResponse {
     reviews: Review[];
     rating: number | null;
     ratings_total: number | null;
-    rating_breakdown: RatingBreakdown | null;
+    rating_breakdown: RatingBreakdown$1 | null;
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3911,7 +3946,7 @@ interface DealsResponse {
 interface CategoryResponse {
     domain: string;
     node: string;
-    results: SearchResult[];
+    results: SearchResult$1[];
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3925,7 +3960,7 @@ interface SellerProfileResponse {
 interface SellerProductsResponse {
     domain: string;
     seller_id: string;
-    products: SearchResult[];
+    products: SearchResult$1[];
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3946,7 +3981,7 @@ interface AutocompleteResponse {
     suggestions: AutocompleteSuggestion[];
 }
 /** Response from the /markets endpoint. */
-interface MarketsResponse {
+interface MarketsResponse$1 {
     markets: MarketInfo[];
 }
 /** Response from the /categories endpoint. */
@@ -4073,7 +4108,7 @@ interface AmazonAutocompleteParams {
  * const suggestions = await client.amazon.search.autocomplete("lapt");
  * ```
  */
-declare class SearchClient {
+declare class SearchClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4117,7 +4152,7 @@ declare class SearchClient {
  * const reviews = await client.amazon.products.reviews("B08N5WRWNW");
  * ```
  */
-declare class ProductsClient {
+declare class ProductsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4269,7 +4304,7 @@ declare class SellersClient {
  * const categories = await client.amazon.reference.categories();
  * ```
  */
-declare class ReferenceClient {
+declare class ReferenceClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4277,7 +4312,7 @@ declare class ReferenceClient {
      *
      * @returns Markets response with all supported marketplaces.
      */
-    markets(): Promise<MarketsResponse>;
+    markets(): Promise<MarketsResponse$1>;
     /**
      * Get the reference department / category aliases.
      *
@@ -4324,15 +4359,15 @@ declare class ReferenceClient {
  */
 declare class AmazonClient {
     /** Client for keyword search and autocomplete */
-    readonly search: SearchClient;
+    readonly search: SearchClient$2;
     /** Client for product detail, offers, and reviews */
-    readonly products: ProductsClient;
+    readonly products: ProductsClient$1;
     /** Client for bestsellers, new releases, deals, and category browse */
     readonly listings: ListingsClient;
     /** Client for seller profile, products, and feedback */
     readonly sellers: SellersClient;
     /** Client for reference data (markets, categories) */
-    readonly reference: ReferenceClient;
+    readonly reference: ReferenceClient$2;
     /**
      * Create a new Amazon client.
      *
@@ -4341,6 +4376,1614 @@ declare class AmazonClient {
     constructor(client: BaseClient);
 }
 
+/**
+ * TypeScript types for Shopee API responses.
+ *
+ * These interfaces mirror the backend `shopee_scraper` response schema
+ * field-for-field. Optional / nullable backend fields are typed as
+ * `Type | null`; backend list fields default to `[]` and are typed as arrays.
+ * Every timestamp field ships in BOTH `*_utc` (number) and `*_at` (string) form.
+ *
+ * Supported markets: id, ph, vn, br, my, th, sg, tw, co, cl, mx.
+ */
+/**
+ * Per-star rating counts for a product.
+ */
+interface RatingBreakdown {
+    rating_star: number | null;
+    /** Array of counts per star level [1★, 2★, 3★, 4★, 5★] */
+    rating_count: number[];
+    rcount_with_context: number | null;
+    rcount_with_image: number | null;
+}
+/**
+ * A product image with its CDN hash and resolved URL.
+ */
+interface ProductImage {
+    hash: string;
+    url: string;
+}
+/**
+ * A purchasable variation (SKU) of a product.
+ */
+interface ProductModel {
+    model_id: number | null;
+    name: string | null;
+    /** Normalised price in market currency */
+    price: number | null;
+    /** Raw Shopee-scaled integer price (×100000) */
+    price_raw: number | null;
+    price_before_discount: number | null;
+    stock: number | null;
+    sold: number | null;
+    currency: string | null;
+    sku: string | null;
+}
+/**
+ * A name/value specification attribute of a product.
+ */
+interface ProductAttribute {
+    name: string | null;
+    value: string | null;
+    id: number | null;
+}
+/**
+ * A Shopee product — covers both search-result and full PDP shapes.
+ */
+interface ShopeeProduct {
+    item_id: number;
+    shop_id: number;
+    name: string | null;
+    /** Normalised price in market currency */
+    price: number | null;
+    /** Raw Shopee-scaled integer price (×100000) */
+    price_raw: number | null;
+    price_min: number | null;
+    price_max: number | null;
+    price_before_discount: number | null;
+    discount: string | null;
+    currency: string | null;
+    rating_star: number | null;
+    rating_count_total: number | null;
+    rating: RatingBreakdown | null;
+    stock: number | null;
+    sold: number | null;
+    historical_sold: number | null;
+    liked_count: number | null;
+    comment_count: number | null;
+    view_count: number | null;
+    image: string | null;
+    images: ProductImage[];
+    description: string | null;
+    brand: string | null;
+    categories: string[];
+    attributes: ProductAttribute[];
+    models: ProductModel[];
+    tier_variations: Record<string, unknown>[];
+    shop_location: string | null;
+    shop_name: string | null;
+    is_official_shop: boolean | null;
+    is_preferred_plus_seller: boolean | null;
+    item_status: string | null;
+    is_adult: boolean | null;
+    condition: number | null;
+    /** Unix timestamp of item creation */
+    ctime_utc: number | null;
+    /** ISO-8601 UTC string of item creation */
+    created_at: string | null;
+    url: string | null;
+}
+/**
+ * A page of search/category results.
+ */
+interface SearchResult {
+    market: string;
+    keyword: string | null;
+    category_id: number | null;
+    total_count: number | null;
+    page: number;
+    limit: number;
+    has_more: boolean;
+    next_offset: number | null;
+    items: ShopeeProduct[];
+}
+/**
+ * A seller's reply to a review.
+ */
+interface ReviewReply {
+    comment: string | null;
+    ctime_utc: number | null;
+    created_at: string | null;
+}
+/**
+ * A single product rating/review.
+ */
+interface ShopeeReview {
+    comment_id: number | null;
+    item_id: number | null;
+    shop_id: number | null;
+    order_id: number | null;
+    rating_star: number | null;
+    comment: string | null;
+    author_username: string | null;
+    author_shopid: number | null;
+    author_portrait: string | null;
+    anonymous: boolean | null;
+    images: string[];
+    videos: Record<string, unknown>[];
+    product_variation: string | null;
+    like_count: number | null;
+    reply: ReviewReply | null;
+    ctime_utc: number | null;
+    created_at: string | null;
+    editable: number | null;
+    is_hidden: boolean | null;
+}
+/**
+ * Aggregate rating summary returned alongside reviews.
+ */
+interface ReviewSummary {
+    rating_star: number | null;
+    rating_total: number | null;
+    /** Array of counts per star level */
+    rating_count: number[];
+    rcount_with_media: number | null;
+    rcount_with_context: number | null;
+}
+/**
+ * A page of reviews for a product.
+ */
+interface ReviewsResult {
+    market: string;
+    item_id: number;
+    shop_id: number;
+    offset: number;
+    limit: number;
+    has_more: boolean;
+    next_offset: number | null;
+    summary: ReviewSummary | null;
+    reviews: ShopeeReview[];
+}
+/**
+ * A node in the Shopee category tree.
+ */
+interface CategoryNode {
+    category_id: number;
+    parent_id: number | null;
+    name: string | null;
+    display_name: string | null;
+    image: string | null;
+    no_sub: boolean | null;
+    block_buyer_platform: number[];
+    children: CategoryNode[];
+}
+/**
+ * The full category tree for a market.
+ */
+interface CategoryTree {
+    market: string;
+    categories: CategoryNode[];
+}
+/**
+ * A single supported Shopee marketplace.
+ */
+interface ShopeeMarket {
+    /** Market code (e.g. "sg", "my", "ph") */
+    code: string;
+    /** Shopee domain (e.g. "shopee.sg") */
+    domain: string;
+    /** Country name */
+    country: string;
+    /** Currency code (e.g. "SGD") */
+    currency: string;
+    /** Locale (e.g. "en") */
+    locale: string;
+    /** Market display name */
+    name: string;
+}
+/**
+ * Response from the /v1/shopee/markets endpoint.
+ */
+interface MarketsResponse {
+    markets: ShopeeMarket[];
+}
+/** Parameters for searching Shopee products. */
+interface ShopeeSearchParams {
+    /** Search keyword string */
+    keyword: string;
+    /** Shopee market code (default: "sg") */
+    market?: string;
+    /** Maximum number of results (default: 60) */
+    limit?: number;
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Sort order (default: "relevancy") */
+    sort_by?: "relevancy" | "ctime" | "sales" | "price_low_to_high" | "price_high_to_low";
+}
+/** Parameters for category-items listing. */
+interface ShopeeCategoryItemsParams {
+    /** Shopee market code (default: "sg") */
+    market?: string;
+    /** Maximum number of results (default: 60) */
+    limit?: number;
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Sort order (default: "relevancy") */
+    sort_by?: "relevancy" | "ctime" | "sales" | "price_low_to_high" | "price_high_to_low";
+}
+/** Options for fetching product detail. */
+interface ShopeeProductParams {
+    /** Shopee market code (default: "sg") */
+    market?: string;
+}
+/** Options for fetching product reviews. */
+interface ShopeeReviewsParams {
+    /** Shopee market code (default: "sg") */
+    market?: string;
+    /** Maximum number of reviews (default: 20) */
+    limit?: number;
+    /** Pagination offset (default: 0) */
+    offset?: number;
+    /** Star filter — 0=all, 1-5 for a specific star count (default: 0) */
+    rating?: number;
+    /** Content filter — 0=all, 1=comment, 2=media, 3=local (default: 0) */
+    filter?: number;
+}
+/** Options for fetching the category tree. */
+interface ShopeeCategoriesParams {
+    /** Shopee market code (default: "sg") */
+    market?: string;
+}
+
+/**
+ * Shopee Search API client.
+ *
+ * Provides methods for keyword search and category-item listing.
+ */
+
+/**
+ * Client for Shopee search and category-items endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const results = await client.shopee.search.search({
+ *   keyword: "wireless headphones",
+ *   market: "sg",
+ * });
+ * for (const item of results.items) {
+ *   console.log(`${item.name}: ${item.price} ${item.currency}`);
+ * }
+ *
+ * const cat = await client.shopee.search.categoryItems(100001, { market: "sg" });
+ * ```
+ */
+declare class SearchClient$1 {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Search Shopee for products by keyword.
+     *
+     * @param params - Search parameters including keyword, market, pagination, and sort.
+     * @returns Search result page with matched products and pagination metadata.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the parameters are invalid.
+     */
+    search(params: ShopeeSearchParams): Promise<SearchResult>;
+    /**
+     * List products within a specific Shopee category.
+     *
+     * @param categoryId - The Shopee category ID.
+     * @param options - Optional parameters (market, limit, offset, sort_by).
+     * @returns Search result page with products in the category.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the category ID or market is invalid.
+     */
+    categoryItems(categoryId: number, options?: ShopeeCategoryItemsParams): Promise<SearchResult>;
+}
+
+/**
+ * Shopee Products API client.
+ *
+ * Provides methods for fetching full product detail pages (PDP).
+ */
+
+/**
+ * Client for the Shopee product detail endpoint.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const product = await client.shopee.products.get(12345, 67890, { market: "sg" });
+ * console.log(`${product.name}: ${product.price} ${product.currency}`);
+ *
+ * for (const model of product.models) {
+ *   console.log(`  Variant: ${model.name} — ${model.price}`);
+ * }
+ * ```
+ */
+declare class ProductsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get full product detail (PDP) for a Shopee item.
+     *
+     * @param shopId - The Shopee shop identifier.
+     * @param itemId - The Shopee item identifier.
+     * @param options - Optional parameters (market).
+     * @returns Full product detail including pricing, ratings, images, and variations.
+     * @throws NotFoundError - If the product doesn't exist.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the market code is invalid.
+     */
+    get(shopId: number, itemId: number, options?: ShopeeProductParams): Promise<ShopeeProduct>;
+}
+
+/**
+ * Shopee Reviews API client.
+ *
+ * Provides methods for fetching product reviews and rating summaries.
+ */
+
+/**
+ * Client for the Shopee product reviews endpoint.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const reviews = await client.shopee.reviews.get(12345, 67890, { market: "sg" });
+ * console.log(`${reviews.summary?.rating_total} reviews`);
+ * for (const review of reviews.reviews) {
+ *   console.log(`${review.author_username}: ${review.rating_star}* ${review.comment}`);
+ * }
+ * ```
+ */
+declare class ReviewsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get product reviews for a Shopee item.
+     *
+     * @param shopId - The Shopee shop identifier.
+     * @param itemId - The Shopee item identifier.
+     * @param options - Optional parameters (market, limit, offset, rating, filter).
+     * @returns Reviews result page with review items and aggregate summary.
+     * @throws NotFoundError - If the product doesn't exist.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the parameters are invalid.
+     */
+    get(shopId: number, itemId: number, options?: ShopeeReviewsParams): Promise<ReviewsResult>;
+}
+
+/**
+ * Shopee Reference Data API client.
+ *
+ * Provides methods for fetching the static category tree and markets list.
+ */
+
+/**
+ * Client for Shopee reference data endpoints (markets, categories).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const markets = await client.shopee.reference.markets();
+ * for (const m of markets.markets) {
+ *   console.log(`${m.code}: ${m.domain} (${m.currency})`);
+ * }
+ *
+ * const tree = await client.shopee.reference.categories({ market: "sg" });
+ * for (const cat of tree.categories) {
+ *   console.log(`${cat.category_id}: ${cat.display_name}`);
+ * }
+ * ```
+ */
+declare class ReferenceClient$1 {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get all supported Shopee marketplaces.
+     *
+     * @returns Markets response with all supported Shopee markets (0 credits).
+     */
+    markets(): Promise<MarketsResponse>;
+    /**
+     * Get the full category tree for a Shopee market.
+     *
+     * @param options - Optional parameters (market).
+     * @returns Category tree with all top-level and nested category nodes.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the market code is invalid.
+     */
+    categories(options?: ShopeeCategoriesParams): Promise<CategoryTree>;
+}
+
+/**
+ * Shopee API client.
+ *
+ * Provides access to all Shopee API endpoints through specialized sub-clients.
+ */
+
+/**
+ * Shopee API client with access to all Shopee endpoints.
+ *
+ * Provides sub-clients for different resource types:
+ * - `search` - Keyword search and category-item listing
+ * - `products` - Full product detail pages (PDP)
+ * - `reviews` - Product reviews and rating summaries
+ * - `reference` - Reference data (markets, category tree)
+ *
+ * Supported markets: id, ph, vn, br, my, th, sg, tw, co, cl, mx.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * // Search products
+ * const results = await client.shopee.search.search({
+ *   keyword: "wireless headphones",
+ *   market: "sg",
+ * });
+ *
+ * // Get product detail
+ * const product = await client.shopee.products.get(12345, 67890, { market: "sg" });
+ *
+ * // Get reviews
+ * const reviews = await client.shopee.reviews.get(12345, 67890, { rating: 5 });
+ *
+ * // Get reference data
+ * const markets = await client.shopee.reference.markets();
+ * const tree = await client.shopee.reference.categories({ market: "sg" });
+ * ```
+ */
+declare class ShopeeClient {
+    /** Client for keyword search and category-item listing */
+    readonly search: SearchClient$1;
+    /** Client for full product detail pages */
+    readonly products: ProductsClient;
+    /** Client for product reviews and rating summaries */
+    readonly reviews: ReviewsClient;
+    /** Client for reference data (markets, category tree) */
+    readonly reference: ReferenceClient$1;
+    /**
+     * Create a new Shopee client.
+     *
+     * @param client - The base HTTP client for making requests.
+     */
+    constructor(client: BaseClient);
+}
+
+/**
+ * TypeScript types for TikTok API responses.
+ *
+ * These interfaces mirror the backend `tiktok_scraper` response schema
+ * field-for-field. Optional / nullable backend fields are typed as
+ * `Type | null`; backend list fields default to `[]` and are typed as arrays.
+ * Every datetime field ships in BOTH `*_utc` (number) and `*_at` (string) form.
+ */
+/**
+ * Author summary embedded in a video, comment, or search result.
+ */
+interface TikTokAuthor {
+    id: string;
+    sec_uid?: string | null;
+    /** @handle */
+    unique_id: string;
+    nickname?: string | null;
+    avatar_thumb?: string | null;
+    avatar_medium?: string | null;
+    avatar_larger?: string | null;
+    /** bio */
+    signature?: string | null;
+    verified: boolean;
+    private_account?: boolean | null;
+    follower_count?: number | null;
+    following_count?: number | null;
+    /** total likes received */
+    heart_count?: number | null;
+    video_count?: number | null;
+    /** likes given */
+    digg_count?: number | null;
+    region?: string | null;
+    sec_uid_present: boolean;
+    short_id?: string | null;
+    /** custom_verify / enterprise_verify_reason text */
+    verify_reason?: string | null;
+    verification_type?: number | null;
+    account_region?: string | null;
+    language?: string | null;
+    original_musician?: boolean | null;
+    /** featured / star creator */
+    is_star?: boolean | null;
+    ins_id?: string | null;
+    twitter_name?: string | null;
+    youtube_channel_title?: string | null;
+    /** non-empty when live */
+    room_id?: string | null;
+    commerce_user_level?: number | null;
+    with_shop_entry?: boolean | null;
+}
+/**
+ * Engagement statistics for a video.
+ */
+interface TikTokStats {
+    /** views */
+    play_count: number;
+    /** likes */
+    digg_count: number;
+    comment_count: number;
+    share_count: number;
+    /** saves / bookmarks */
+    collect_count: number;
+    download_count?: number | null;
+    forward_count?: number | null;
+    whatsapp_share_count?: number | null;
+    repost_count?: number | null;
+}
+/**
+ * Playable-media metadata for a video.
+ */
+interface TikTokVideoMeta {
+    height?: number | null;
+    width?: number | null;
+    /** seconds */
+    duration?: number | null;
+    ratio?: string | null;
+    format?: string | null;
+    definition?: string | null;
+    codec_type?: string | null;
+    encoded_type?: string | null;
+    bitrate?: number | null;
+    cover?: string | null;
+    origin_cover?: string | null;
+    dynamic_cover?: string | null;
+    animated_cover?: string | null;
+    ai_dynamic_cover?: string | null;
+    share_cover?: string | null;
+    /** direct play URL */
+    play_addr?: string | null;
+    /** direct download URL (watermarked) */
+    download_addr?: string | null;
+    /** clean MP4 */
+    download_no_watermark_addr?: string | null;
+    has_watermark?: boolean | null;
+    volume_loudness?: number | null;
+    volume_peak?: number | null;
+}
+/**
+ * Sound / music attached to a video, or a standalone music entity.
+ */
+interface TikTokMusic {
+    id: string;
+    title?: string | null;
+    author_name?: string | null;
+    album?: string | null;
+    /** seconds */
+    duration?: number | null;
+    play_url?: string | null;
+    cover_thumb?: string | null;
+    cover_medium?: string | null;
+    cover_large?: string | null;
+    original?: boolean | null;
+    is_copyrighted?: boolean | null;
+    mid?: string | null;
+    owner_id?: string | null;
+    owner_nickname?: string | null;
+    is_commerce_music?: boolean | null;
+    is_original_sound?: boolean | null;
+    /** Present only on standalone music endpoints */
+    video_count?: number | null;
+    user_count?: number | null;
+}
+/**
+ * A hashtag/challenge as referenced from a video.
+ */
+interface TikTokChallenge {
+    id: string;
+    /** hashtag text, no '#' */
+    title: string;
+    desc?: string | null;
+    cover?: string | null;
+    is_commerce?: boolean | null;
+}
+/**
+ * An effect / sticker applied to a video.
+ */
+interface TikTokEffectSticker {
+    id: string;
+    name?: string | null;
+    photo_url?: string | null;
+}
+/**
+ * An entity (hashtag mention or @user mention) inside the caption.
+ */
+interface TikTokTextExtra {
+    /** "hashtag" | "mention" */
+    type?: string | null;
+    hashtag_name?: string | null;
+    user_unique_id?: string | null;
+    user_id?: string | null;
+    start?: number | null;
+    end?: number | null;
+}
+/**
+ * A subtitle/caption track for a video.
+ */
+interface TikTokSubtitle {
+    language?: string | null;
+    language_code?: string | null;
+    url?: string | null;
+    /** ASR vs creator */
+    source?: string | null;
+    version?: string | null;
+    format?: string | null;
+}
+/**
+ * Moderation / availability state of a post (mobile aweme `status` block).
+ */
+interface TikTokVideoStatus {
+    is_delete?: boolean | null;
+    allow_share?: boolean | null;
+    allow_comment?: boolean | null;
+    /** 0 public, 1 friends, 2 private */
+    private_status?: number | null;
+    in_reviewing?: boolean | null;
+    reviewed?: boolean | null;
+    is_prohibited?: boolean | null;
+    download_status?: number | null;
+    self_see?: boolean | null;
+}
+/**
+ * Per-post interaction permissions (mobile aweme `video_control` block).
+ */
+interface TikTokVideoControl {
+    allow_download?: boolean | null;
+    allow_duet?: boolean | null;
+    allow_stitch?: boolean | null;
+    allow_react?: boolean | null;
+    allow_comment?: boolean | null;
+    share_type?: number | null;
+    prevent_download?: boolean | null;
+}
+/**
+ * A link/shopping/POI anchor attached to a post.
+ */
+interface TikTokAnchor {
+    id?: string | null;
+    type?: number | null;
+    keyword?: string | null;
+    url?: string | null;
+    icon?: string | null;
+}
+/**
+ * A TikTok post (video or photo slideshow) with full metadata.
+ */
+interface TikTokVideo {
+    id: string;
+    /** caption text */
+    description: string;
+    text_language?: string | null;
+    create_time_utc?: number | null;
+    create_time_at?: string | null;
+    /** locationCreated */
+    region?: string | null;
+    /** web video URL */
+    url: string;
+    /** canonical share link (mobile share_url) */
+    share_url?: string | null;
+    group_id?: string | null;
+    /** 0 video, 150 photo/slideshow, … */
+    aweme_type?: number | null;
+    /** mobile content_type label */
+    content_type?: string | null;
+    author?: TikTokAuthor | null;
+    music?: TikTokMusic | null;
+    stats: TikTokStats;
+    video?: TikTokVideoMeta | null;
+    status?: TikTokVideoStatus | null;
+    video_control?: TikTokVideoControl | null;
+    anchors: TikTokAnchor[];
+    hashtags: string[];
+    mentions: string[];
+    text_extra: TikTokTextExtra[];
+    challenges: TikTokChallenge[];
+    effect_stickers: TikTokEffectSticker[];
+    is_slideshow: boolean;
+    image_urls: string[];
+    is_ad: boolean;
+    is_aigc?: boolean | null;
+    aigc_description?: string | null;
+    is_pinned: boolean;
+    is_muted?: boolean | null;
+    secret?: boolean | null;
+    private_item?: boolean | null;
+    duet_enabled?: boolean | null;
+    stitch_enabled?: boolean | null;
+    share_enabled?: boolean | null;
+    comment_status?: string | null;
+    can_repost?: boolean | null;
+    is_paid_content?: boolean | null;
+    is_on_this_day?: boolean | null;
+    /** supports bullet comments */
+    support_danmaku?: boolean | null;
+    subtitles: TikTokSubtitle[];
+    voice_to_text?: string | null;
+    diversification_labels: string[];
+    suggested_words: string[];
+}
+/**
+ * Aggregate counts for a user profile.
+ */
+interface TikTokUserStats {
+    follower_count: number;
+    following_count: number;
+    /** total likes received */
+    heart_count: number;
+    video_count: number;
+    /** likes given */
+    digg_count: number;
+    friend_count?: number | null;
+}
+/**
+ * A full TikTok user profile.
+ */
+interface TikTokUser {
+    id: string;
+    /** needed to call list endpoints */
+    sec_uid: string;
+    /** @handle */
+    unique_id: string;
+    nickname?: string | null;
+    /** bio */
+    signature?: string | null;
+    bio_link?: string | null;
+    verified: boolean;
+    /** enterprise_verify_reason / custom_verify text */
+    verify_reason?: string | null;
+    verification_type?: number | null;
+    private_account: boolean;
+    is_commerce_account?: boolean | null;
+    /** TikTok Shop seller */
+    is_seller?: boolean | null;
+    is_organization?: boolean | null;
+    original_musician?: boolean | null;
+    is_star?: boolean | null;
+    region?: string | null;
+    language?: string | null;
+    ins_id?: string | null;
+    twitter_name?: string | null;
+    youtube_channel_title?: string | null;
+    avatar_thumb?: string | null;
+    avatar_medium?: string | null;
+    avatar_larger?: string | null;
+    stats: TikTokUserStats;
+    open_favorite?: boolean | null;
+    comment_setting?: number | null;
+    duet_setting?: number | null;
+    stitch_setting?: number | null;
+    download_setting?: number | null;
+    following_visibility?: number | null;
+    is_live?: boolean | null;
+    room_id?: string | null;
+    commerce_category?: string | null;
+    commerce_user_level?: number | null;
+    with_shop_entry?: boolean | null;
+    create_time_utc?: number | null;
+    create_time_at?: string | null;
+    profile_url: string;
+}
+/**
+ * A comment (or reply) on a video.
+ */
+interface TikTokComment {
+    /** cid */
+    id: string;
+    text: string;
+    /** parent video id */
+    aweme_id?: string | null;
+    parent_comment_id?: string | null;
+    digg_count: number;
+    reply_count: number;
+    create_time_utc?: number | null;
+    create_time_at?: string | null;
+    liked_by_author?: boolean | null;
+    pinned_by_author?: boolean | null;
+    comment_language?: string | null;
+    status?: number | null;
+    /** @users in the comment */
+    mentions: string[];
+    text_extra: TikTokTextExtra[];
+    /** comment sticker/images */
+    image_urls: string[];
+    author?: TikTokAuthor | null;
+    replies: TikTokComment[];
+}
+/**
+ * A hashtag / challenge detail.
+ */
+interface TikTokHashtag {
+    id: string;
+    /** name without '#' */
+    title: string;
+    description?: string | null;
+    cover?: string | null;
+    profile_larger?: string | null;
+    video_count?: number | null;
+    view_count?: number | null;
+    is_commerce?: boolean | null;
+    url: string;
+}
+interface TikTokTrendingHashtag {
+    name: string;
+    id?: string | null;
+    rank?: number | null;
+    rank_diff?: number | null;
+    country_code?: string | null;
+    industry?: string | null;
+    /** videos using it */
+    publish_count?: number | null;
+    view_count?: number | null;
+    /** distinct creators using it (mobile source) */
+    user_count?: number | null;
+    is_promoted?: boolean | null;
+    is_new?: boolean | null;
+    url?: string | null;
+}
+interface TikTokTrendingSong {
+    title: string;
+    id?: string | null;
+    author?: string | null;
+    rank?: number | null;
+    rank_diff?: number | null;
+    country_code?: string | null;
+    duration?: number | null;
+    /** videos using this sound (mobile trending metric) */
+    user_count?: number | null;
+    cover?: string | null;
+    play_url?: string | null;
+    is_new?: boolean | null;
+    link?: string | null;
+}
+interface TikTokOEmbed {
+    version: string;
+    type: string;
+    title?: string | null;
+    author_name?: string | null;
+    author_url?: string | null;
+    provider_name: string;
+    provider_url: string;
+    html?: string | null;
+    thumbnail_url?: string | null;
+    thumbnail_width?: number | null;
+    thumbnail_height?: number | null;
+    embed_product_id?: string | null;
+    embed_type?: string | null;
+}
+/**
+ * Cursor pagination metadata shared by all list endpoints.
+ */
+interface TikTokCursorPage {
+    has_more: boolean;
+    /** opaque; pass back as ?cursor= */
+    cursor?: string | null;
+    /** number of items in THIS page */
+    count: number;
+    /** search endpoints chain rid → search_id */
+    search_id?: string | null;
+}
+/** Response from the /users/{username} endpoint. */
+interface ProfileResponse {
+    user: TikTokUser;
+    region: string;
+}
+/** Response from the /videos/{video_id} endpoint. */
+interface VideoResponse {
+    video: TikTokVideo;
+    region: string;
+}
+/** Response wrapping a cursor-paginated list of videos. */
+interface VideoListResponse {
+    videos: TikTokVideo[];
+    pagination: TikTokCursorPage;
+    region: string;
+}
+/** Response from the /videos/{video_id}/comments endpoint. */
+interface CommentListResponse {
+    comments: TikTokComment[];
+    pagination: TikTokCursorPage;
+    region: string;
+}
+/** Followers / following lists. */
+interface UserListResponse {
+    users: TikTokAuthor[];
+    pagination: TikTokCursorPage;
+    region: string;
+}
+/** Response from the /hashtags/{name} endpoint. */
+interface HashtagResponse {
+    hashtag: TikTokHashtag;
+    region: string;
+}
+/** Response from the /music/{music_id} endpoint. */
+interface MusicResponse {
+    music: TikTokMusic;
+    region: string;
+}
+/** Response from the /search/users endpoint. */
+interface UserSearchResponse {
+    users: TikTokAuthor[];
+    pagination: TikTokCursorPage;
+    region: string;
+}
+/** Response from the /search/hashtags endpoint. */
+interface HashtagSearchResponse {
+    hashtags: TikTokHashtag[];
+    pagination: TikTokCursorPage;
+    region: string;
+}
+/** Response from the /videos/{video_id}/transcript endpoint. */
+interface TranscriptResponse {
+    video_id: string;
+    subtitles: TikTokSubtitle[];
+    voice_to_text?: string | null;
+    region: string;
+}
+/** Response from the /trending/hashtags endpoint. */
+interface TrendingHashtagsResponse {
+    hashtags: TikTokTrendingHashtag[];
+    region: string;
+}
+/** Response from the /trending/songs endpoint. */
+interface TrendingSongsResponse {
+    songs: TikTokTrendingSong[];
+    region: string;
+}
+interface TikTokAdVideo {
+    video_url?: string | null;
+    cover_img?: string | null;
+}
+interface TikTokAd {
+    id: string;
+    /** advertiser name */
+    name?: string | null;
+    audit_status?: string | null;
+    type?: string | null;
+    /** epoch ms */
+    first_shown_date?: number | null;
+    /** epoch ms */
+    last_shown_date?: number | null;
+    videos: TikTokAdVideo[];
+}
+interface AdLibraryPage {
+    has_more: boolean;
+    total?: number | null;
+    /** pass to the next page request */
+    search_id?: string | null;
+    offset: number;
+}
+/** Response from the /ads/search endpoint. */
+interface AdLibrarySearchResponse {
+    ads: TikTokAd[];
+    pagination: AdLibraryPage;
+    region: string;
+}
+interface RegionInfo {
+    code: string;
+    country_code: string;
+    locale: string;
+    name: string;
+}
+/** Response from the /regions endpoint. */
+interface RegionsResponse {
+    regions: RegionInfo[];
+}
+/** Options for the user profile endpoint. */
+interface TikTokUserParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+}
+/** Options for cursor-paginated user list endpoints (videos/followers/following/liked/reposts). */
+interface TikTokUserListParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+    /**
+     * Opaque cursor from a previous page.
+     * Only accepted by: user videos, followers, following.
+     * Reposts and liked ignore this param — remove before sending.
+     */
+    cursor?: string;
+}
+/** Options for the video detail endpoint. */
+interface TikTokVideoParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Author handle (skips oEmbed lookup) */
+    username?: string;
+}
+/** Options for the video comments endpoint. */
+interface TikTokCommentsParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+    /**
+     * Pagination cursor from a prior response's pagination.cursor; omit for the first page.
+     */
+    cursor?: string;
+}
+/** Options for the comment replies endpoint. */
+interface TikTokCommentRepliesParams {
+    /** Parent video id (required) */
+    videoId: string;
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50, default 20) */
+    count?: number;
+    /**
+     * Pagination cursor from a prior response's pagination.cursor; omit for the first page.
+     */
+    cursor?: string;
+}
+/** Options for the related-videos endpoint. */
+interface TikTokRelatedParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+}
+/** Options for the transcript endpoint. */
+interface TikTokTranscriptParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+}
+/** Options for the oEmbed endpoint. */
+interface TikTokOEmbedParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+}
+/** Options for the hashtag detail endpoint. */
+interface TikTokHashtagParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+}
+/** Options for hashtag/music video listings. */
+interface TikTokListVideosParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+    /**
+     * Pagination cursor from a prior response's pagination.cursor; omit for the first page.
+     */
+    cursor?: string;
+}
+/** Options for the music detail endpoint. */
+interface TikTokMusicParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+}
+/** Options for the keyword search endpoints (general/videos/users/hashtags). */
+interface TikTokSearchParams {
+    /** Search keyword (required) */
+    query: string;
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+    /**
+     * Pagination cursor from a prior response's pagination.cursor; omit for the first page.
+     */
+    cursor?: string;
+}
+/** Options for the trending videos endpoint. */
+interface TikTokTrendingVideosParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+}
+/** Options for the trending hashtags / songs endpoints. */
+interface TikTokTrendingParams {
+    /** Content region (ISO 3166-1 alpha-2, default "US") */
+    region?: string;
+    /** Trailing window in days (default 7) */
+    period?: number;
+    /** Number of items to return (1-50) */
+    count?: number;
+}
+/** Options for the Ad Library search endpoint. */
+interface TikTokAdSearchParams {
+    /** Keyword (ignored when advertiserId is set) */
+    query?: string;
+    /** Advertiser business id(s) for advertiser search */
+    advertiser_id?: string;
+    /** EU region code (the Ad Library is EU-only, default "DE") */
+    region?: string;
+    /** Trailing window in days (1-365, default 30) */
+    days?: number;
+    /** Sort order (default "last_shown_date,desc") */
+    sort?: string;
+    /** Result offset for pagination */
+    offset?: number;
+    /** Opaque search id chained from a previous page */
+    search_id?: string;
+    /** Number of items to return (1-50) */
+    count?: number;
+}
+
+/**
+ * TikTok Users API client.
+ *
+ * Provides methods for user profiles and their cursor-paginated lists
+ * (videos, followers, following, liked, reposts).
+ */
+
+/**
+ * Client for TikTok user endpoints (profile, videos, followers, following, liked, reposts).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const profile = await client.tiktok.users.get("charlidamelio");
+ * console.log(profile.user.stats.follower_count);
+ *
+ * const videos = await client.tiktok.users.videos("charlidamelio", { count: 30 });
+ * ```
+ */
+declare class UsersClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a TikTok user's full profile.
+     *
+     * @param username - The user's @handle (without the leading '@').
+     * @param options - Optional parameters (region).
+     * @returns The user profile response.
+     * @throws NotFoundError - If the user doesn't exist.
+     */
+    get(username: string, options?: TikTokUserParams): Promise<ProfileResponse>;
+    /**
+     * Get a TikTok user's posted videos.
+     *
+     * @param username - The user's @handle.
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of videos.
+     */
+    videos(username: string, options?: TikTokUserListParams): Promise<VideoListResponse>;
+    /**
+     * 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.
+     *
+     * @param username - The user's @handle.
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of follower authors.
+     */
+    followers(username: string, options?: TikTokUserListParams): Promise<UserListResponse>;
+    /**
+     * 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.
+     *
+     * @param username - The user's @handle.
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of followed authors.
+     */
+    following(username: string, options?: TikTokUserListParams): Promise<UserListResponse>;
+    /**
+     * 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.
+     *
+     * @param username - The user's @handle.
+     * @param options - Optional parameters (region, count).
+     * @returns A cursor-paginated list of videos.
+     */
+    liked(username: string, options?: TikTokUserListParams): Promise<VideoListResponse>;
+    /**
+     * Get videos a TikTok user has reposted.
+     *
+     * @param username - The user's @handle.
+     * @param options - Optional parameters (region, count).
+     * @returns A cursor-paginated list of videos.
+     */
+    reposts(username: string, options?: TikTokUserListParams): Promise<VideoListResponse>;
+}
+
+/**
+ * TikTok Videos API client.
+ *
+ * Provides methods for video detail, comments, comment replies, related
+ * videos, transcript, and oEmbed metadata.
+ */
+
+/**
+ * Client for TikTok video endpoints (detail, comments, replies, related, transcript, oEmbed).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const video = await client.tiktok.videos.get("7372...");
+ * console.log(video.video.stats.play_count);
+ *
+ * const comments = await client.tiktok.videos.comments("7372...");
+ * ```
+ */
+declare class VideosClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get full metadata for a single TikTok video/post.
+     *
+     * @param videoId - The video/post id.
+     * @param options - Optional parameters (region, username).
+     * @returns The video detail response.
+     * @throws NotFoundError - If the video doesn't exist.
+     */
+    get(videoId: string, options?: TikTokVideoParams): Promise<VideoResponse>;
+    /**
+     * Get top-level comments on a TikTok video.
+     *
+     * @param videoId - The video/post id.
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of comments.
+     */
+    comments(videoId: string, options?: TikTokCommentsParams): Promise<CommentListResponse>;
+    /**
+     * Get replies to a TikTok comment (best-effort).
+     *
+     * @param commentId - The comment id.
+     * @param options - Parameters including the required `videoId` (region, count, cursor).
+     * @returns A cursor-paginated list of reply comments.
+     */
+    commentReplies(commentId: string, options: TikTokCommentRepliesParams): Promise<CommentListResponse>;
+    /**
+     * Get TikTok's related videos for a given video.
+     *
+     * @param videoId - The video/post id.
+     * @param options - Optional parameters (region, count).
+     * @returns A cursor-paginated list of related videos.
+     */
+    related(videoId: string, options?: TikTokRelatedParams): Promise<VideoListResponse>;
+    /**
+     * Get subtitle/caption tracks for a TikTok video.
+     *
+     * @param videoId - The video/post id.
+     * @param options - Optional parameters (region).
+     * @returns The transcript response with subtitle tracks and voice-to-text.
+     */
+    transcript(videoId: string, options?: TikTokTranscriptParams): Promise<TranscriptResponse>;
+    /**
+     * Get cheap unauthenticated oEmbed metadata for a TikTok URL.
+     *
+     * @param url - Full TikTok video or profile URL.
+     * @param options - Optional parameters (region).
+     * @returns The oEmbed metadata.
+     */
+    oembed(url: string, options?: TikTokOEmbedParams): Promise<TikTokOEmbed>;
+}
+
+/**
+ * TikTok Search API client.
+ *
+ * Provides keyword search across videos, users, and hashtags.
+ */
+
+/**
+ * Client for TikTok search endpoints (general, videos, users, hashtags).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const top = await client.tiktok.search.search({ query: "skincare" });
+ * const users = await client.tiktok.search.users({ query: "skincare" });
+ * ```
+ */
+declare class SearchClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * General TikTok search — video results from the Top feed.
+     *
+     * @param params - Search parameters including query, region, count, cursor.
+     * @returns A cursor-paginated list of videos.
+     */
+    search(params: TikTokSearchParams): Promise<VideoListResponse>;
+    /**
+     * Search TikTok videos by keyword.
+     *
+     * @param params - Search parameters including query, region, count, cursor.
+     * @returns A cursor-paginated list of videos.
+     */
+    videos(params: TikTokSearchParams): Promise<VideoListResponse>;
+    /**
+     * Search TikTok users by keyword.
+     *
+     * @param params - Search parameters including query, region, count, cursor.
+     * @returns A cursor-paginated list of matching users.
+     */
+    users(params: TikTokSearchParams): Promise<UserSearchResponse>;
+    /**
+     * Search TikTok hashtags by keyword.
+     *
+     * @param params - Search parameters including query, region, count, cursor.
+     * @returns A cursor-paginated list of matching hashtags.
+     */
+    hashtags(params: TikTokSearchParams): Promise<HashtagSearchResponse>;
+}
+
+/**
+ * TikTok Music API client.
+ *
+ * Provides sound/music detail and the videos using a given sound.
+ */
+
+/**
+ * Client for TikTok music endpoints (detail, videos).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const music = await client.tiktok.music.get("6975...");
+ * const videos = await client.tiktok.music.videos("6975...");
+ * ```
+ */
+declare class MusicClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get TikTok sound/music detail.
+     *
+     * @param musicId - The sound/music id.
+     * @param options - Optional parameters (region).
+     * @returns The music detail response.
+     * @throws NotFoundError - If the music doesn't exist.
+     */
+    get(musicId: string, options?: TikTokMusicParams): Promise<MusicResponse>;
+    /**
+     * Get videos using a given TikTok sound.
+     *
+     * @param musicId - The sound/music id.
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of videos.
+     */
+    videos(musicId: string, options?: TikTokListVideosParams): Promise<VideoListResponse>;
+}
+
+/**
+ * TikTok Hashtags API client.
+ *
+ * Provides hashtag/challenge detail and the videos tagged with a hashtag.
+ */
+
+/**
+ * Client for TikTok hashtag endpoints (detail, videos).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const tag = await client.tiktok.hashtags.get("fyp");
+ * const videos = await client.tiktok.hashtags.videos("fyp");
+ * ```
+ */
+declare class HashtagsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get TikTok hashtag/challenge detail.
+     *
+     * @param name - The hashtag name (without the leading '#').
+     * @param options - Optional parameters (region).
+     * @returns The hashtag detail response.
+     * @throws NotFoundError - If the hashtag doesn't exist.
+     */
+    get(name: string, options?: TikTokHashtagParams): Promise<HashtagResponse>;
+    /**
+     * Get videos tagged with a TikTok hashtag.
+     *
+     * @param name - The hashtag name (without the leading '#').
+     * @param options - Optional parameters (region, count, cursor).
+     * @returns A cursor-paginated list of videos.
+     */
+    videos(name: string, options?: TikTokListVideosParams): Promise<VideoListResponse>;
+}
+
+/**
+ * TikTok Trending API client.
+ *
+ * Provides trending videos, hashtags, and songs.
+ */
+
+/**
+ * Client for TikTok trending endpoints (videos, hashtags, songs).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const videos = await client.tiktok.trending.videos({ region: "US" });
+ * const hashtags = await client.tiktok.trending.hashtags({ region: "US", period: 7 });
+ * const songs = await client.tiktok.trending.songs({ region: "US" });
+ * ```
+ */
+declare class TrendingClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get trending videos from the TikTok Explore feed.
+     *
+     * @param options - Optional parameters (region, count).
+     * @returns A cursor-paginated list of trending videos.
+     */
+    videos(options?: TikTokTrendingVideosParams): Promise<VideoListResponse>;
+    /**
+     * Get trending hashtags (mobile Discover surface — view_count + creators).
+     *
+     * @param options - Optional parameters (region, period, count).
+     * @returns The trending hashtags response.
+     */
+    hashtags(options?: TikTokTrendingParams): Promise<TrendingHashtagsResponse>;
+    /**
+     * Get trending songs/sounds (mobile hot-music feed — ranked by usage).
+     *
+     * @param options - Optional parameters (region, period, count).
+     * @returns The trending songs response.
+     */
+    songs(options?: TikTokTrendingParams): Promise<TrendingSongsResponse>;
+}
+
+/**
+ * TikTok Ads API client.
+ *
+ * Provides access to TikTok's Commercial Content Library (EU-DSA ad
+ * transparency) via keyword or advertiser search.
+ */
+
+/**
+ * Client for the TikTok Ad Library (Commercial Content Library) endpoint.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const ads = await client.tiktok.ads.search({ query: "shoes", region: "DE" });
+ * for (const ad of ads.ads) {
+ *   console.log(ad.name);
+ * }
+ * ```
+ */
+declare class AdsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Search TikTok's Commercial Content Library (ad transparency) by keyword or advertiser.
+     *
+     * @param params - Optional parameters (query, advertiser_id, region, days, sort, offset, search_id, count).
+     * @returns The ad-library search response with ads and pagination.
+     */
+    search(params?: TikTokAdSearchParams): Promise<AdLibrarySearchResponse>;
+}
+
+/**
+ * TikTok Reference Data API client.
+ *
+ * Provides the supported-regions list and a service health check.
+ */
+
+/**
+ * Client for TikTok reference data endpoints (regions, health).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const regions = await client.tiktok.reference.regions();
+ * for (const r of regions.regions) {
+ *   console.log(`${r.code}: ${r.name} (${r.locale})`);
+ * }
+ * ```
+ */
+declare class ReferenceClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * List supported TikTok content regions.
+     *
+     * @returns The regions response with all supported content regions.
+     */
+    regions(): Promise<RegionsResponse>;
+    /**
+     * Check the health of the TikTok scraper service.
+     *
+     * @returns The raw health payload from the scraper service.
+     */
+    health(): Promise<unknown>;
+}
+
+/**
+ * TikTok API client.
+ *
+ * Provides access to all TikTok API endpoints through specialized sub-clients.
+ */
+
+/**
+ * TikTok API client with access to all TikTok endpoints.
+ *
+ * Provides sub-clients for different resource types:
+ * - `users` - Profiles, videos, followers, following, liked, reposts
+ * - `videos` - Detail, comments, replies, related, transcript, oEmbed
+ * - `search` - Keyword search across videos, users, and hashtags
+ * - `music` - Sound/music detail and videos using a sound
+ * - `hashtags` - Hashtag detail and tagged videos
+ * - `trending` - Trending videos, hashtags, and songs
+ * - `ads` - The Commercial Content Library (ad transparency)
+ * - `reference` - Reference data (regions) and service health
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * // Get a user profile
+ * const profile = await client.tiktok.users.get("charlidamelio");
+ *
+ * // Get video detail
+ * const video = await client.tiktok.videos.get("7372...");
+ *
+ * // Search videos
+ * const results = await client.tiktok.search.videos({ query: "skincare" });
+ *
+ * // Get trending songs
+ * const songs = await client.tiktok.trending.songs({ region: "US" });
+ *
+ * // Search the ad library
+ * const ads = await client.tiktok.ads.search({ query: "shoes", region: "DE" });
+ *
+ * // List regions
+ * const regions = await client.tiktok.reference.regions();
+ * ```
+ */
+declare class TikTokClient {
+    /** Client for profiles, videos, followers, following, liked, reposts */
+    readonly users: UsersClient;
+    /** Client for video detail, comments, replies, related, transcript, oEmbed */
+    readonly videos: VideosClient;
+    /** Client for keyword search across videos, users, and hashtags */
+    readonly search: SearchClient;
+    /** Client for sound/music detail and videos using a sound */
+    readonly music: MusicClient;
+    /** Client for hashtag detail and tagged videos */
+    readonly hashtags: HashtagsClient;
+    /** Client for trending videos, hashtags, and songs */
+    readonly trending: TrendingClient;
+    /** Client for the Commercial Content Library (ad transparency) */
+    readonly ads: AdsClient;
+    /** Client for reference data (regions) and service health */
+    readonly reference: ReferenceClient;
+    /**
+     * Create a new TikTok client.
+     *
+     * @param client - The base HTTP client for making requests.
+     */
+    constructor(client: BaseClient);
+}
+
 /**
  * Main ScrapeBadger client.
  *
@@ -4393,6 +6036,10 @@ declare class ScrapeBadger {
     readonly reddit: RedditClient;
     /** Amazon scraper API client — 14 endpoints */
     readonly amazon: AmazonClient;
+    /** Shopee scraper API client — 6 endpoints across 11 markets */
+    readonly shopee: ShopeeClient;
+    /** TikTok scraper API client — 26 endpoints */
+    readonly tiktok: TikTokClient;
     /**
      * Create a new ScrapeBadger client.
      *
@@ -4421,4 +6068,4 @@ declare class ScrapeBadger {
     constructor(config?: Partial<ScrapeBadgerConfig>);
 }
 
-export { type AiListItem, type AiModeResponse, type AiModeSearchParams, type AiReference, type AiTableRow, type AiTextBlock, type AmazonAutocompleteParams, type AutocompleteResponse as AmazonAutocompleteResponse, type AutocompleteSuggestion as AmazonAutocompleteSuggestion, type Bestseller as AmazonBestseller, type BestsellersRankEntry as AmazonBestsellersRankEntry, type BestsellersResponse as AmazonBestsellersResponse, type Buybox as AmazonBuybox, type CategoriesResponse as AmazonCategoriesResponse, type CategoryInfo as AmazonCategoryInfo, type AmazonCategoryParams, type CategoryResponse as AmazonCategoryResponse, AmazonClient, type Coupon as AmazonCoupon, type Deal as AmazonDeal, type AmazonDealsParams, type DealsResponse as AmazonDealsResponse, type Delivery as AmazonDelivery, type FeedbackWindow as AmazonFeedbackWindow, ListingsClient as AmazonListingsClient, type AmazonListingsParams, type MarketInfo as AmazonMarketInfo, type MarketsResponse as AmazonMarketsResponse, type NewReleasesResponse as AmazonNewReleasesResponse, type Offer as AmazonOffer, type OfferCondition as AmazonOfferCondition, type OfferDelivery as AmazonOfferDelivery, type OfferSeller as AmazonOfferSeller, type AmazonOffersParams, type OffersResponse as AmazonOffersResponse, type Pagination as AmazonPagination, type AmazonPrice, type Product as AmazonProduct, type ProductBadges as AmazonProductBadges, type ProductDeal as AmazonProductDeal, type ProductDetailResponse as AmazonProductDetailResponse, type AmazonProductParams, type ProductVariant as AmazonProductVariant, ProductsClient as AmazonProductsClient, type RatingBreakdown as AmazonRatingBreakdown, ReferenceClient as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse as AmazonReviewsResponse, SearchClient as AmazonSearchClient, type AmazonSearchParams, type SearchResponse as AmazonSearchResponse, type SearchResult as AmazonSearchResult, type Seller as AmazonSeller, type SellerFeedbackEntry as AmazonSellerFeedbackEntry, type SellerFeedbackResponse as AmazonSellerFeedbackResponse, type SellerFeedbackSummary as AmazonSellerFeedbackSummary, type AmazonSellerListParams, type AmazonSellerParams, type SellerProductsResponse as AmazonSellerProductsResponse, type SellerProfileResponse as AmazonSellerProfileResponse, SellersClient as AmazonSellersClient, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type FinanceQuoteParams, type FlightsSearchParams, type FlightsStopsFilter, type FlightsTravelClass, type FlightsTripType, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient$1 as GoogleProductsClient, type GoogleResponse, ScholarClient as GoogleScholarClient, SearchClient$2 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient as GoogleVideosClient, type HotelsDetailsParams, type HotelsSearchParams, type ImagesSearchParams, type JobsSearchParams, type LensSearchParams, type MapsPhotosParams, type MapsPlaceParams, type MapsPostsParams, type MapsReviewsParams, type MapsSearchParams, type NewsSearchParams, type NewsTopicsParams, type NewsTrendingParams, type PatentsDetailParams, type PatentsSearchParams, type PopularSubredditsResponse, type PostCommentsResponse, type PostDetailResponse, type PostDuplicatesResponse, type ProductsDetailParams, type RedditAward, RedditClient, type RedditComment, type RedditModeratedSubreddit, type RedditPagination, type RedditPost, PostsClient as RedditPostsClient, type RedditRule, SearchClient$1 as RedditSearchClient, type RedditSubreddit, SubredditsClient as RedditSubredditsClient, type RedditTrophy, type RedditUser, type UserProfileResponse as RedditUserProfileResponse, type RedditUserSubreddit, UsersClient as RedditUsersClient, type RedditWikiPage, type ScholarAuthorCitationParams, type ScholarAuthorParams, type ScholarCiteParams, type ScholarProfilesParams, type ScholarSearchParams, ScrapeBadger, ScrapeBadgerConfig, type ScrapeOptions, type ScrapeResult, type SearchPostsResponse, type SearchSubredditsResponse, type SearchUsersResponse, type ShoppingClickParams, type ShoppingProductParams, type ShoppingSearchParams, type ShortsSearchParams, type SubredditDetailResponse, type SubredditPostsResponse, type SubredditRulesResponse, type SubredditWikiPagesResponse, type TrendingPostsResponse, type TrendsAutocompleteParams, type TrendsInterestParams, type TrendsRegionsParams, type TrendsRelatedParams, type TrendsTrendingParams, TwitterClient, type UserCommentsResponse, type UserModeratedResponse, type UserPostsResponse, type UserTrophiesResponse, type VideosSearchParams, type VintedBrand, type BrandsResponse as VintedBrandsResponse, VintedClient, type VintedColor, type ColorsResponse as VintedColorsResponse, type VintedItemDetail, type ItemDetailResponse as VintedItemDetailResponse, type VintedItemSummary, ItemsClient as VintedItemsClient, type VintedMarket, type MarketsResponse$1 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$1 as VintedReferenceClient, SearchClient$3 as VintedSearchClient, type VintedSearchParams, type SearchResponse$1 as VintedSearchResponse, type VintedSellerSummary, type VintedStatus, type StatusesResponse as VintedStatusesResponse, type UserItemsResponse as VintedUserItemsResponse, type VintedUserProfile, type UserProfileResponse$1 as VintedUserProfileResponse, type VintedUserSummary, UsersClient$1 as VintedUsersClient, WebClient, type WikiPageResponse };
+export { type AiListItem, type AiModeResponse, type AiModeSearchParams, type AiReference, type AiTableRow, type AiTextBlock, type AmazonAutocompleteParams, type AutocompleteResponse as AmazonAutocompleteResponse, type AutocompleteSuggestion as AmazonAutocompleteSuggestion, type Bestseller as AmazonBestseller, type BestsellersRankEntry as AmazonBestsellersRankEntry, type BestsellersResponse as AmazonBestsellersResponse, type Buybox as AmazonBuybox, type CategoriesResponse as AmazonCategoriesResponse, type CategoryInfo as AmazonCategoryInfo, type AmazonCategoryParams, type CategoryResponse as AmazonCategoryResponse, AmazonClient, type Coupon as AmazonCoupon, type Deal as AmazonDeal, type AmazonDealsParams, type DealsResponse as AmazonDealsResponse, type Delivery as AmazonDelivery, type FeedbackWindow as AmazonFeedbackWindow, ListingsClient as AmazonListingsClient, type AmazonListingsParams, type MarketInfo as AmazonMarketInfo, type MarketsResponse$1 as AmazonMarketsResponse, type NewReleasesResponse as AmazonNewReleasesResponse, type Offer as AmazonOffer, type OfferCondition as AmazonOfferCondition, type OfferDelivery as AmazonOfferDelivery, type OfferSeller as AmazonOfferSeller, type AmazonOffersParams, type OffersResponse as AmazonOffersResponse, type Pagination as AmazonPagination, type AmazonPrice, type Product as AmazonProduct, type ProductBadges as AmazonProductBadges, type ProductDeal as AmazonProductDeal, type ProductDetailResponse as AmazonProductDetailResponse, type AmazonProductParams, type ProductVariant as AmazonProductVariant, ProductsClient$1 as AmazonProductsClient, type RatingBreakdown$1 as AmazonRatingBreakdown, ReferenceClient$2 as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse as AmazonReviewsResponse, SearchClient$2 as AmazonSearchClient, type AmazonSearchParams, type SearchResponse as AmazonSearchResponse, type SearchResult$1 as AmazonSearchResult, type Seller as AmazonSeller, type SellerFeedbackEntry as AmazonSellerFeedbackEntry, type SellerFeedbackResponse as AmazonSellerFeedbackResponse, type SellerFeedbackSummary as AmazonSellerFeedbackSummary, type AmazonSellerListParams, type AmazonSellerParams, type SellerProductsResponse as AmazonSellerProductsResponse, type SellerProfileResponse as AmazonSellerProfileResponse, SellersClient as AmazonSellersClient, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type FinanceQuoteParams, type FlightsSearchParams, type FlightsStopsFilter, type FlightsTravelClass, type FlightsTripType, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient$2 as GoogleProductsClient, type GoogleResponse, ScholarClient as GoogleScholarClient, SearchClient$4 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient$1 as GoogleVideosClient, type HotelsDetailsParams, type HotelsSearchParams, type ImagesSearchParams, type JobsSearchParams, type LensSearchParams, type MapsPhotosParams, type MapsPlaceParams, type MapsPostsParams, type MapsReviewsParams, type MapsSearchParams, type NewsSearchParams, type NewsTopicsParams, type NewsTrendingParams, type PatentsDetailParams, type PatentsSearchParams, type PopularSubredditsResponse, type PostCommentsResponse, type PostDetailResponse, type PostDuplicatesResponse, type ProductsDetailParams, type RedditAward, RedditClient, type RedditComment, type RedditModeratedSubreddit, type RedditPagination, type RedditPost, PostsClient as RedditPostsClient, type RedditRule, SearchClient$3 as RedditSearchClient, type RedditSubreddit, SubredditsClient as RedditSubredditsClient, type RedditTrophy, type RedditUser, type UserProfileResponse as RedditUserProfileResponse, type RedditUserSubreddit, UsersClient$1 as RedditUsersClient, type RedditWikiPage, type ScholarAuthorCitationParams, type ScholarAuthorParams, type ScholarCiteParams, type ScholarProfilesParams, type ScholarSearchParams, ScrapeBadger, ScrapeBadgerConfig, type ScrapeOptions, type ScrapeResult, type SearchPostsResponse, type SearchSubredditsResponse, type SearchUsersResponse, type ShopeeCategoriesParams, type ShopeeCategoryItemsParams, type CategoryNode as ShopeeCategoryNode, type CategoryTree as ShopeeCategoryTree, ShopeeClient, type ShopeeMarket, type MarketsResponse as ShopeeMarketsResponse, type ShopeeProduct, type ProductAttribute as ShopeeProductAttribute, type ProductImage as ShopeeProductImage, type ProductModel as ShopeeProductModel, type ShopeeProductParams, ProductsClient as ShopeeProductsClient, type RatingBreakdown as ShopeeRatingBreakdown, ReferenceClient$1 as ShopeeReferenceClient, type ShopeeReview, type ReviewReply as ShopeeReviewReply, type ReviewSummary as ShopeeReviewSummary, ReviewsClient as ShopeeReviewsClient, type ShopeeReviewsParams, type ReviewsResult as ShopeeReviewsResult, SearchClient$1 as ShopeeSearchClient, type ShopeeSearchParams, type SearchResult as ShopeeSearchResult, type ShoppingClickParams, type ShoppingProductParams, type ShoppingSearchParams, type ShortsSearchParams, type SubredditDetailResponse, type SubredditPostsResponse, type SubredditRulesResponse, type SubredditWikiPagesResponse, type TikTokAd, type AdLibraryPage as TikTokAdLibraryPage, type AdLibrarySearchResponse as TikTokAdLibrarySearchResponse, type TikTokAdSearchParams, type TikTokAdVideo, AdsClient as TikTokAdsClient, type TikTokAnchor, type TikTokAuthor, type TikTokChallenge, TikTokClient, type TikTokComment, type CommentListResponse as TikTokCommentListResponse, type TikTokCommentRepliesParams, type TikTokCommentsParams, type TikTokCursorPage, type TikTokEffectSticker, type TikTokHashtag, type TikTokHashtagParams, type HashtagResponse as TikTokHashtagResponse, type HashtagSearchResponse as TikTokHashtagSearchResponse, HashtagsClient as TikTokHashtagsClient, type TikTokListVideosParams, type TikTokMusic, MusicClient as TikTokMusicClient, type TikTokMusicParams, type MusicResponse as TikTokMusicResponse, type TikTokOEmbed, type TikTokOEmbedParams, type ProfileResponse as TikTokProfileResponse, ReferenceClient as TikTokReferenceClient, type RegionInfo as TikTokRegionInfo, type RegionsResponse as TikTokRegionsResponse, type TikTokRelatedParams, SearchClient as TikTokSearchClient, type TikTokSearchParams, type TikTokStats, type TikTokSubtitle, type TikTokTextExtra, type TikTokTranscriptParams, type TranscriptResponse as TikTokTranscriptResponse, TrendingClient as TikTokTrendingClient, type TikTokTrendingHashtag, type TrendingHashtagsResponse as TikTokTrendingHashtagsResponse, type TikTokTrendingParams, type TikTokTrendingSong, type TrendingSongsResponse as TikTokTrendingSongsResponse, type TikTokTrendingVideosParams, type TikTokUser, type TikTokUserListParams, type UserListResponse as TikTokUserListResponse, type TikTokUserParams, type UserSearchResponse as TikTokUserSearchResponse, type TikTokUserStats, UsersClient as TikTokUsersClient, type TikTokVideo, type TikTokVideoControl, type VideoListResponse as TikTokVideoListResponse, type TikTokVideoMeta, type TikTokVideoParams, type VideoResponse as TikTokVideoResponse, type TikTokVideoStatus, VideosClient as TikTokVideosClient, type TrendingPostsResponse, type TrendsAutocompleteParams, type TrendsInterestParams, type TrendsRegionsParams, type TrendsRelatedParams, type TrendsTrendingParams, TwitterClient, type UserCommentsResponse, type UserModeratedResponse, type UserPostsResponse, type UserTrophiesResponse, type VideosSearchParams, type VintedBrand, type BrandsResponse as VintedBrandsResponse, VintedClient, type VintedColor, type ColorsResponse as VintedColorsResponse, type VintedItemDetail, type ItemDetailResponse as VintedItemDetailResponse, type VintedItemSummary, ItemsClient as VintedItemsClient, type VintedMarket, type MarketsResponse$2 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$3 as VintedReferenceClient, SearchClient$5 as VintedSearchClient, type VintedSearchParams, type SearchResponse$1 as VintedSearchResponse, type VintedSellerSummary, type VintedStatus, type StatusesResponse as VintedStatusesResponse, type UserItemsResponse as VintedUserItemsResponse, type VintedUserProfile, type UserProfileResponse$1 as VintedUserProfileResponse, type VintedUserSummary, UsersClient$2 as VintedUsersClient, WebClient, type WikiPageResponse };