scrapebadger 0.14.0 → 0.15.1

package/dist/index.d.cts

@@ -411,7 +411,7 @@ interface VintedPagination {
 /**
  * Response from the search endpoint.
  */
-interface SearchResponse$1 {
+interface SearchResponse$3 {
     /** List of matching items */
     items: VintedItemSummary[];
     /** Pagination metadata */
@@ -427,7 +427,7 @@ interface SearchResponse$1 {
 /**
  * Response from the item detail endpoint.
  */
-interface ItemDetailResponse {
+interface ItemDetailResponse$1 {
     /** Full item details */
     item: VintedItemDetail;
     /** Market code used */
@@ -479,7 +479,7 @@ interface StatusesResponse {
 /**
  * Response from the markets endpoint.
  */
-interface MarketsResponse$2 {
+interface MarketsResponse$4 {
     /** List of available markets */
     markets: VintedMarket[];
 }
@@ -550,7 +550,7 @@ interface VintedSearchParams {
  * });
  * ```
  */
-declare class SearchClient$5 {
+declare class SearchClient$7 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -586,7 +586,7 @@ declare class SearchClient$5 {
      * }
      * ```
      */
-    search(params: VintedSearchParams): Promise<SearchResponse$1>;
+    search(params: VintedSearchParams): Promise<SearchResponse$3>;
 }
 
 /**
@@ -607,7 +607,7 @@ declare class SearchClient$5 {
  * console.log(`Seller: ${item.item.seller.login}`);
  * ```
  */
-declare class ItemsClient {
+declare class ItemsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -631,7 +631,7 @@ declare class ItemsClient {
      */
     get(itemId: number, options?: {
         market?: string;
-    }): Promise<ItemDetailResponse>;
+    }): Promise<ItemDetailResponse$1>;
 }
 
 /**
@@ -741,7 +741,7 @@ declare class UsersClient$2 {
  * }
  * ```
  */
-declare class ReferenceClient$3 {
+declare class ReferenceClient$5 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -819,7 +819,7 @@ declare class ReferenceClient$3 {
      * }
      * ```
      */
-    markets(): Promise<MarketsResponse$2>;
+    markets(): Promise<MarketsResponse$4>;
 }
 
 /**
@@ -856,13 +856,13 @@ declare class ReferenceClient$3 {
  */
 declare class VintedClient {
     /** Client for item search operations */
-    readonly search: SearchClient$5;
+    readonly search: SearchClient$7;
     /** Client for individual item operations */
-    readonly items: ItemsClient;
+    readonly items: ItemsClient$1;
     /** Client for user operations */
     readonly users: UsersClient$2;
     /** Client for reference data (brands, colors, statuses, markets) */
-    readonly reference: ReferenceClient$3;
+    readonly reference: ReferenceClient$5;
     /**
      * Create a new Vinted client.
      *
@@ -1848,7 +1848,7 @@ declare class ScholarClient {
  * }
  * ```
  */
-declare class SearchClient$4 {
+declare class SearchClient$6 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -1934,7 +1934,7 @@ declare class ShoppingClient {
  * }
  * ```
  */
-declare class ShortsClient {
+declare class ShortsClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     search(params: ShortsSearchParams): Promise<GoogleResponse>;
@@ -2001,7 +2001,7 @@ declare class TrendsClient {
  * }
  * ```
  */
-declare class VideosClient$1 {
+declare class VideosClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     search(params: VideosSearchParams): Promise<GoogleResponse>;
@@ -2044,7 +2044,7 @@ declare class VideosClient$1 {
  */
 declare class GoogleClient {
     /** Google Web Search (SERP) — with optional deferred AI Overview follow-up. */
-    readonly search: SearchClient$4;
+    readonly search: SearchClient$6;
     /** Google Maps — places, reviews, photos, posts. */
     readonly maps: MapsClient;
     /** Google News — articles, topics, trending. */
@@ -2066,7 +2066,7 @@ declare class GoogleClient {
     /** Google Images. */
     readonly images: ImagesClient;
     /** Google Videos. */
-    readonly videos: VideosClient$1;
+    readonly videos: VideosClient$2;
     /** Google Finance — stock and index quotes. */
     readonly finance: FinanceClient;
     /** Google AI Mode — generative answer responses. */
@@ -2074,7 +2074,7 @@ declare class GoogleClient {
     /** Google Lens — visual image search. */
     readonly lens: LensClient;
     /** Google Shorts — short-form vertical video results (udm=39). */
-    readonly shorts: ShortsClient;
+    readonly shorts: ShortsClient$1;
     /** Google Flights — one-way, round-trip, and multi-city itineraries. */
     readonly flights: FlightsClient;
     /** Google Products — immersive product detail. */
@@ -2875,7 +2875,7 @@ interface DomainPostsResponse {
  * const domainPosts = await client.reddit.search.domainPosts({ domain: "github.com" });
  * ```
  */
-declare class SearchClient$3 {
+declare class SearchClient$5 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -3484,7 +3484,7 @@ declare class UsersClient$1 {
  */
 declare class RedditClient {
     /** Client for search operations (posts, subreddits, users, domain posts) */
-    readonly search: SearchClient$3;
+    readonly search: SearchClient$5;
     /** Client for post operations (trending, details, comments, duplicates) */
     readonly posts: PostsClient;
     /** Client for subreddit operations (details, posts, rules, moderators, wiki) */
@@ -3523,7 +3523,7 @@ interface AmazonPrice {
 /**
  * Page-number pagination (Amazon listings use 1-based page numbers).
  */
-interface Pagination {
+interface Pagination$1 {
     /** Current page number (1-indexed) */
     current_page: number;
     /** Total number of pages, if known */
@@ -3534,7 +3534,7 @@ interface Pagination {
 /**
  * A single supported marketplace (for /markets).
  */
-interface MarketInfo {
+interface MarketInfo$2 {
     /** Market code (e.g. "US", "UK", "DE") */
     code: string;
     /** Amazon domain suffix (e.g. "com", "co.uk") */
@@ -3551,7 +3551,7 @@ interface MarketInfo {
 /**
  * A reference category / department alias (for /categories).
  */
-interface CategoryInfo {
+interface CategoryInfo$1 {
     /** Category display name */
     name: string;
     /** Category alias */
@@ -3693,14 +3693,14 @@ interface Product {
     also_bought: RelatedProduct[];
     answered_questions: number | null;
     /** The product page's embedded featured reviews (max 8). */
-    top_reviews: Review[];
+    top_reviews: Review$1[];
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /**
  * A single search / category-browse result row.
  */
-interface SearchResult$1 {
+interface SearchResult$3 {
     position: number;
     asin: string;
     title: string | null;
@@ -3773,7 +3773,7 @@ interface ReviewProfile {
 /**
  * A single product review.
  */
-interface Review {
+interface Review$1 {
     id: string | null;
     title: string | null;
     body: string | null;
@@ -3849,7 +3849,7 @@ interface SellerFeedbackSummary {
 /**
  * A seller profile.
  */
-interface Seller {
+interface Seller$1 {
     seller_id: string;
     name: string | null;
     link: string | null;
@@ -3875,16 +3875,16 @@ interface SellerFeedbackEntry {
 /**
  * A single keyword suggestion.
  */
-interface AutocompleteSuggestion {
+interface AutocompleteSuggestion$1 {
     value: string;
     alias: string | null;
 }
 /** Response from the /search endpoint. */
-interface SearchResponse {
+interface SearchResponse$2 {
     query: string;
     domain: string;
-    results: SearchResult$1[];
-    pagination: Pagination;
+    results: SearchResult$3[];
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
@@ -3904,14 +3904,14 @@ interface OffersResponse {
     scraped_at: string | null;
 }
 /** Response from the /products/{asin}/reviews endpoint. */
-interface ReviewsResponse {
+interface ReviewsResponse$1 {
     asin: string;
     domain: string;
-    reviews: Review[];
+    reviews: Review$1[];
     rating: number | null;
     ratings_total: number | null;
     rating_breakdown: RatingBreakdown$1 | null;
-    pagination: Pagination;
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
@@ -3920,7 +3920,7 @@ interface BestsellersResponse {
     domain: string;
     category: string | null;
     bestsellers: Bestseller[];
-    pagination: Pagination;
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
@@ -3929,7 +3929,7 @@ interface NewReleasesResponse {
     domain: string;
     category: string | null;
     new_releases: Bestseller[];
-    pagination: Pagination;
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
@@ -3938,55 +3938,55 @@ interface DealsResponse {
     domain: string;
     category: string | null;
     deals: Deal[];
-    pagination: Pagination;
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /** Response from the /category endpoint. */
-interface CategoryResponse {
+interface CategoryResponse$1 {
     domain: string;
     node: string;
-    results: SearchResult$1[];
-    pagination: Pagination;
+    results: SearchResult$3[];
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /** Response from the /sellers/{seller_id} endpoint. */
-interface SellerProfileResponse {
+interface SellerProfileResponse$1 {
     domain: string;
-    seller: Seller;
+    seller: Seller$1;
 }
 /** Response from the /sellers/{seller_id}/products endpoint. */
 interface SellerProductsResponse {
     domain: string;
     seller_id: string;
-    products: SearchResult$1[];
-    pagination: Pagination;
+    products: SearchResult$3[];
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /** Response from the /sellers/{seller_id}/feedback endpoint. */
-interface SellerFeedbackResponse {
+interface SellerFeedbackResponse$1 {
     domain: string;
     seller_id: string;
     feedback: SellerFeedbackEntry[];
-    pagination: Pagination;
+    pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /** Response from the /autocomplete endpoint. */
-interface AutocompleteResponse {
+interface AutocompleteResponse$2 {
     query: string;
     domain: string;
-    suggestions: AutocompleteSuggestion[];
+    suggestions: AutocompleteSuggestion$1[];
 }
 /** Response from the /markets endpoint. */
-interface MarketsResponse$1 {
-    markets: MarketInfo[];
+interface MarketsResponse$3 {
+    markets: MarketInfo$2[];
 }
 /** Response from the /categories endpoint. */
-interface CategoriesResponse {
-    categories: CategoryInfo[];
+interface CategoriesResponse$2 {
+    categories: CategoryInfo$1[];
 }
 /** Parameters for searching Amazon products. */
 interface AmazonSearchParams {
@@ -4108,7 +4108,7 @@ interface AmazonAutocompleteParams {
  * const suggestions = await client.amazon.search.autocomplete("lapt");
  * ```
  */
-declare class SearchClient$2 {
+declare class SearchClient$4 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4119,7 +4119,7 @@ declare class SearchClient$2 {
      * @throws AuthenticationError - If the API key is invalid.
      * @throws ValidationError - If the parameters are invalid.
      */
-    search(params: AmazonSearchParams): Promise<SearchResponse>;
+    search(params: AmazonSearchParams): Promise<SearchResponse$2>;
     /**
      * Get Amazon keyword autocomplete suggestions.
      *
@@ -4127,7 +4127,7 @@ declare class SearchClient$2 {
      * @param options - Optional parameters (domain).
      * @returns Autocomplete suggestions.
      */
-    autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse>;
+    autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse$2>;
 }
 
 /**
@@ -4179,7 +4179,7 @@ declare class ProductsClient$1 {
      * @param options - Optional parameters (domain, page, sort_by, star, verified_only, media_only).
      * @returns Reviews response with reviews, aggregate rating, and breakdown.
      */
-    reviews(asin: string, options?: AmazonReviewsParams): Promise<ReviewsResponse>;
+    reviews(asin: string, options?: AmazonReviewsParams): Promise<ReviewsResponse$1>;
 }
 
 /**
@@ -4231,7 +4231,7 @@ declare class ListingsClient {
      * @param params - Parameters including the required node ID.
      * @returns Category response with result rows and pagination.
      */
-    category(params: AmazonCategoryParams): Promise<CategoryResponse>;
+    category(params: AmazonCategoryParams): Promise<CategoryResponse$1>;
 }
 
 /**
@@ -4253,7 +4253,7 @@ declare class ListingsClient {
  * const products = await client.amazon.sellers.products("A2L77EE7U53NWQ");
  * ```
  */
-declare class SellersClient {
+declare class SellersClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4264,7 +4264,7 @@ declare class SellersClient {
      * @returns Seller profile response.
      * @throws NotFoundError - If the seller doesn't exist.
      */
-    get(sellerId: string, options?: AmazonSellerParams): Promise<SellerProfileResponse>;
+    get(sellerId: string, options?: AmazonSellerParams): Promise<SellerProfileResponse$1>;
     /**
      * Get a seller's storefront listings.
      *
@@ -4280,7 +4280,7 @@ declare class SellersClient {
      * @param options - Optional parameters (domain, page).
      * @returns Seller feedback response with feedback entries and pagination.
      */
-    feedback(sellerId: string, options?: AmazonSellerListParams): Promise<SellerFeedbackResponse>;
+    feedback(sellerId: string, options?: AmazonSellerListParams): Promise<SellerFeedbackResponse$1>;
 }
 
 /**
@@ -4304,7 +4304,7 @@ declare class SellersClient {
  * const categories = await client.amazon.reference.categories();
  * ```
  */
-declare class ReferenceClient$2 {
+declare class ReferenceClient$4 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4312,13 +4312,13 @@ declare class ReferenceClient$2 {
      *
      * @returns Markets response with all supported marketplaces.
      */
-    markets(): Promise<MarketsResponse$1>;
+    markets(): Promise<MarketsResponse$3>;
     /**
      * Get the reference department / category aliases.
      *
      * @returns Categories response with all category aliases.
      */
-    categories(): Promise<CategoriesResponse>;
+    categories(): Promise<CategoriesResponse$2>;
 }
 
 /**
@@ -4359,15 +4359,15 @@ declare class ReferenceClient$2 {
  */
 declare class AmazonClient {
     /** Client for keyword search and autocomplete */
-    readonly search: SearchClient$2;
+    readonly search: SearchClient$4;
     /** Client for product detail, offers, and reviews */
     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;
+    readonly sellers: SellersClient$1;
     /** Client for reference data (markets, categories) */
-    readonly reference: ReferenceClient$2;
+    readonly reference: ReferenceClient$4;
     /**
      * Create a new Amazon client.
      *
@@ -4476,7 +4476,7 @@ interface ShopeeProduct {
 /**
  * A page of search/category results.
  */
-interface SearchResult {
+interface SearchResult$2 {
     market: string;
     keyword: string | null;
     category_id: number | null;
@@ -4584,7 +4584,7 @@ interface ShopeeMarket {
 /**
  * Response from the /v1/shopee/markets endpoint.
  */
-interface MarketsResponse {
+interface MarketsResponse$2 {
     markets: ShopeeMarket[];
 }
 /** Parameters for searching Shopee products. */
@@ -4659,7 +4659,7 @@ interface ShopeeCategoriesParams {
  * const cat = await client.shopee.search.categoryItems(100001, { market: "sg" });
  * ```
  */
-declare class SearchClient$1 {
+declare class SearchClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4670,7 +4670,7 @@ declare class SearchClient$1 {
      * @throws AuthenticationError - If the API key is invalid.
      * @throws ValidationError - If the parameters are invalid.
      */
-    search(params: ShopeeSearchParams): Promise<SearchResult>;
+    search(params: ShopeeSearchParams): Promise<SearchResult$2>;
     /**
      * List products within a specific Shopee category.
      *
@@ -4680,7 +4680,7 @@ declare class SearchClient$1 {
      * @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>;
+    categoryItems(categoryId: number, options?: ShopeeCategoryItemsParams): Promise<SearchResult$2>;
 }
 
 /**
@@ -4782,7 +4782,7 @@ declare class ReviewsClient {
  * }
  * ```
  */
-declare class ReferenceClient$1 {
+declare class ReferenceClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4790,7 +4790,7 @@ declare class ReferenceClient$1 {
      *
      * @returns Markets response with all supported Shopee markets (0 credits).
      */
-    markets(): Promise<MarketsResponse>;
+    markets(): Promise<MarketsResponse$2>;
     /**
      * Get the full category tree for a Shopee market.
      *
@@ -4842,13 +4842,13 @@ declare class ReferenceClient$1 {
  */
 declare class ShopeeClient {
     /** Client for keyword search and category-item listing */
-    readonly search: SearchClient$1;
+    readonly search: SearchClient$3;
     /** 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;
+    readonly reference: ReferenceClient$3;
     /**
      * Create a new Shopee client.
      *
@@ -5304,7 +5304,7 @@ interface UserListResponse {
     region: string;
 }
 /** Response from the /hashtags/{name} endpoint. */
-interface HashtagResponse {
+interface HashtagResponse$1 {
     hashtag: TikTokHashtag;
     region: string;
 }
@@ -5378,7 +5378,7 @@ interface RegionInfo {
     name: string;
 }
 /** Response from the /regions endpoint. */
-interface RegionsResponse {
+interface RegionsResponse$1 {
     regions: RegionInfo[];
 }
 /** Options for the user profile endpoint. */
@@ -5623,7 +5623,7 @@ declare class UsersClient {
  * const comments = await client.tiktok.videos.comments("7372...");
  * ```
  */
-declare class VideosClient {
+declare class VideosClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5694,7 +5694,7 @@ declare class VideosClient {
  * const users = await client.tiktok.search.users({ query: "skincare" });
  * ```
  */
-declare class SearchClient {
+declare class SearchClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5744,7 +5744,7 @@ declare class SearchClient {
  * const videos = await client.tiktok.music.videos("6975...");
  * ```
  */
-declare class MusicClient {
+declare class MusicClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5794,7 +5794,7 @@ declare class HashtagsClient {
      * @returns The hashtag detail response.
      * @throws NotFoundError - If the hashtag doesn't exist.
      */
-    get(name: string, options?: TikTokHashtagParams): Promise<HashtagResponse>;
+    get(name: string, options?: TikTokHashtagParams): Promise<HashtagResponse$1>;
     /**
      * Get videos tagged with a TikTok hashtag.
      *
@@ -5823,7 +5823,7 @@ declare class HashtagsClient {
  * const songs = await client.tiktok.trending.songs({ region: "US" });
  * ```
  */
-declare class TrendingClient {
+declare class TrendingClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5900,7 +5900,7 @@ declare class AdsClient {
  * }
  * ```
  */
-declare class ReferenceClient {
+declare class ReferenceClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5908,7 +5908,7 @@ declare class ReferenceClient {
      *
      * @returns The regions response with all supported content regions.
      */
-    regions(): Promise<RegionsResponse>;
+    regions(): Promise<RegionsResponse$1>;
     /**
      * Check the health of the TikTok scraper service.
      *
@@ -5963,19 +5963,19 @@ 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;
+    readonly videos: VideosClient$1;
     /** Client for keyword search across videos, users, and hashtags */
-    readonly search: SearchClient;
+    readonly search: SearchClient$2;
     /** Client for sound/music detail and videos using a sound */
-    readonly music: MusicClient;
+    readonly music: MusicClient$1;
     /** Client for hashtag detail and tagged videos */
     readonly hashtags: HashtagsClient;
     /** Client for trending videos, hashtags, and songs */
-    readonly trending: TrendingClient;
+    readonly trending: TrendingClient$1;
     /** Client for the Commercial Content Library (ad transparency) */
     readonly ads: AdsClient;
     /** Client for reference data (regions) and service health */
-    readonly reference: ReferenceClient;
+    readonly reference: ReferenceClient$2;
     /**
      * Create a new TikTok client.
      *
@@ -5984,6 +5984,2245 @@ declare class TikTokClient {
     constructor(client: BaseClient);
 }
 
+/**
+ * TypeScript types for eBay API responses.
+ *
+ * These interfaces mirror the backend `ebay_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.
+ */
+/**
+ * A parsed price with both the numeric value and its raw rendering.
+ */
+interface EbayPrice {
+    /** Numeric price value */
+    value: number | null;
+    /** ISO currency code (e.g. "USD") */
+    currency: string | null;
+    /** Currency symbol (e.g. "$") */
+    symbol: string | null;
+    /** Raw rendered price string (e.g. "$29.99") */
+    raw: string | null;
+}
+/**
+ * Page-number pagination (eBay listings use 1-based `_pgn` numbers).
+ */
+interface Pagination {
+    /** Current page number (1-indexed) */
+    current_page: number;
+    /** Results per page, if known */
+    per_page: number | null;
+    /** Total number of pages, if known */
+    total_pages: number | null;
+    /** Total number of results, if known */
+    total_results: number | null;
+}
+/**
+ * A single supported marketplace (for /markets).
+ */
+interface MarketInfo$1 {
+    /** Market code (e.g. "US", "GB", "DE") */
+    code: string;
+    /** eBay domain suffix (e.g. "com", "co.uk") */
+    domain: string;
+    /** Country name */
+    country: string;
+    /** Currency code (e.g. "USD") */
+    currency: string;
+    /** Locale (e.g. "en-US") */
+    locale: string;
+    /** Market display name */
+    name: string;
+    /** eBay site id */
+    site_id: number;
+}
+/**
+ * A reference category alias (for /categories).
+ */
+interface CategoryInfo {
+    /** Category display name */
+    name: string;
+    /** Category id */
+    category_id: string;
+    /** Parent category name, if any */
+    parent: string | null;
+}
+/**
+ * A single image with optional dimensions.
+ */
+interface Image {
+    url: string;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * A single shipping option (per-destination rate from JSON-LD or DOM).
+ */
+interface ShippingOption {
+    cost: EbayPrice | null;
+    is_free: boolean | null;
+    service: string | null;
+    destination_country: string | null;
+    delivery_estimate: string | null;
+}
+/**
+ * One eBay search/listing card (search, seller items, category, sold).
+ */
+interface SearchResult$1 {
+    position: number;
+    item_id: string | null;
+    product_id: string | null;
+    title: string | null;
+    url: string | null;
+    image: string | null;
+    price: EbayPrice | null;
+    original_price: EbayPrice | null;
+    discount_percent: number | null;
+    currency: string | null;
+    condition: string | null;
+    brand: string | null;
+    /** "Buy It Now" | "Auction" | "Best Offer" */
+    buying_format: string | null;
+    is_auction: boolean;
+    bids: number | null;
+    time_left: string | null;
+    shipping: string | null;
+    shipping_cost: EbayPrice | null;
+    free_shipping: boolean | null;
+    location: string | null;
+    returns: string | null;
+    sold_count: number | null;
+    watchers: number | null;
+    coupon: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    seller_name: string | null;
+    seller_feedback_percent: number | null;
+    seller_feedback_score: number | null;
+    /** e.g. "eBay Refurbished" */
+    program_badge: string | null;
+    is_sponsored: boolean;
+}
+/**
+ * The seller summary attached to an item.
+ */
+interface ItemSeller {
+    username: string | null;
+    url: string | null;
+    feedback_score: number | null;
+    feedback_percent: number | null;
+    store_name: string | null;
+    store_url: string | null;
+}
+/**
+ * The returns policy for an item.
+ */
+interface ReturnsPolicy {
+    accepted: boolean | null;
+    /** e.g. "30 days" */
+    period: string | null;
+    /** "buyer" | "seller" */
+    cost_paid_by: string | null;
+    raw: string | null;
+}
+/**
+ * Full item detail (PDP).
+ */
+interface Item {
+    item_id: string;
+    product_id: string | null;
+    legacy_item_id: string | null;
+    title: string | null;
+    subtitle: string | null;
+    url: string | null;
+    condition: string | null;
+    condition_id: string | null;
+    condition_description: string | null;
+    price: EbayPrice | null;
+    original_price: EbayPrice | null;
+    discount_percent: number | null;
+    currency: string | null;
+    availability: string | null;
+    quantity_available: number | null;
+    quantity_sold: number | null;
+    watchers: number | null;
+    buying_format: string | null;
+    is_auction: boolean;
+    bids: number | null;
+    time_left: string | null;
+    best_offer_enabled: boolean | null;
+    brand: string | null;
+    mpn: string | null;
+    model: string | null;
+    color: string | null;
+    gtin: string | null;
+    main_image: string | null;
+    images: Image[];
+    images_count: number;
+    description: string | null;
+    seller_notes: string | null;
+    item_specifics: Record<string, string>;
+    categories: string[];
+    category_id: string | null;
+    shipping_options: ShippingOption[];
+    shipping_cost: EbayPrice | null;
+    free_shipping: boolean | null;
+    item_location: string | null;
+    ships_to: string[];
+    returns: ReturnsPolicy | null;
+    seller: ItemSeller | null;
+    rating: number | null;
+    ratings_total: number | null;
+    date_modified_utc: number | null;
+    date_modified_at: string | null;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/**
+ * Positive / neutral / negative feedback counts for a window.
+ */
+interface FeedbackBreakdown {
+    positive: number | null;
+    neutral: number | null;
+    negative: number | null;
+}
+/**
+ * A seller profile.
+ */
+interface Seller {
+    username: string;
+    url: string | null;
+    store_name: string | null;
+    store_url: string | null;
+    feedback_score: number | null;
+    feedback_percent: number | null;
+    member_since: string | null;
+    location: string | null;
+    items_for_sale: number | null;
+    feedback_12mo: FeedbackBreakdown | null;
+    top_rated: boolean | null;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/**
+ * A single seller feedback entry.
+ */
+interface FeedbackEntry {
+    /** "positive" | "neutral" | "negative" */
+    rating: string | null;
+    comment: string | null;
+    rater: string | null;
+    item: string | null;
+    date_raw: string | null;
+    date_utc: number | null;
+    date_at: string | null;
+}
+/**
+ * Per-star rating distribution.
+ */
+interface RatingHistogram {
+    five_star: number | null;
+    four_star: number | null;
+    three_star: number | null;
+    two_star: number | null;
+    one_star: number | null;
+}
+/**
+ * A single catalog product review.
+ */
+interface Review {
+    title: string | null;
+    body: string | null;
+    rating: number | null;
+    author: string | null;
+    date_raw: string | null;
+    date_utc: number | null;
+    date_at: string | null;
+    helpful_votes: number | null;
+    verified_purchase: boolean;
+}
+/**
+ * A single keyword suggestion.
+ */
+interface AutocompleteSuggestion {
+    value: string;
+}
+/** Response from the /search and /completed endpoints. */
+interface SearchResponse$1 {
+    query: string | null;
+    domain: string;
+    category_id: string | null;
+    sold: boolean;
+    results: SearchResult$1[];
+    facets: Record<string, string[]>;
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /items/{item_id} endpoint. */
+interface ItemDetailResponse {
+    domain: string;
+    item: Item;
+}
+/** Response from the /sellers/{username} endpoint. */
+interface SellerProfileResponse {
+    domain: string;
+    seller: Seller;
+}
+/** Response from the /sellers/{username}/items endpoint. */
+interface SellerItemsResponse {
+    domain: string;
+    username: string;
+    results: SearchResult$1[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /sellers/{username}/feedback endpoint. */
+interface SellerFeedbackResponse {
+    domain: string;
+    username: string;
+    feedback: FeedbackEntry[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /items/{item_id}/reviews endpoint. */
+interface ReviewsResponse {
+    domain: string;
+    item_id: string | null;
+    product_id: string | null;
+    rating: number | null;
+    ratings_total: number | null;
+    histogram: RatingHistogram | null;
+    reviews: Review[];
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /categories/{category_id}/items endpoint. */
+interface CategoryResponse {
+    domain: string;
+    category_id: string;
+    results: SearchResult$1[];
+    facets: Record<string, string[]>;
+    pagination: Pagination;
+    scraped_utc: number | null;
+    scraped_at: string | null;
+}
+/** Response from the /autocomplete endpoint. */
+interface AutocompleteResponse$1 {
+    query: string;
+    domain: string;
+    suggestions: AutocompleteSuggestion[];
+}
+/** Response from the /markets endpoint. */
+interface MarketsResponse$1 {
+    markets: MarketInfo$1[];
+}
+/** Response from the /categories endpoint. */
+interface CategoriesResponse$1 {
+    categories: CategoryInfo[];
+}
+/** Sort order for search / listing endpoints. */
+type EbaySortBy = "best_match" | "ending_soonest" | "newly_listed" | "price_low_to_high" | "price_high_to_low";
+/** Item condition filter. */
+type EbayCondition = "new" | "open_box" | "refurbished" | "used" | "for_parts";
+/** Buying-format filter. */
+type EbayBuyingFormat = "auction" | "buy_it_now" | "best_offer";
+/** Parameters for searching active eBay listings. */
+interface EbaySearchParams {
+    /** Search keywords (required) */
+    query: string;
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Restrict to a category id */
+    category_id?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Results per page (60, 120 or 240; clamped) */
+    per_page?: number;
+    /** Sort order */
+    sort_by?: EbaySortBy;
+    /** Item condition filter */
+    condition?: EbayCondition;
+    /** Buying-format filter */
+    buying_format?: EbayBuyingFormat;
+    /** Minimum price filter */
+    min_price?: number;
+    /** Maximum price filter */
+    max_price?: number;
+    /** Restrict to free-shipping listings */
+    free_shipping?: boolean;
+}
+/** Parameters for searching completed / sold eBay listings. */
+interface EbayCompletedParams {
+    /** Search keywords (required) */
+    query: string;
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Restrict to a category id */
+    category_id?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Results per page (60, 120 or 240; clamped) */
+    per_page?: number;
+    /** Sort order */
+    sort_by?: EbaySortBy;
+    /** Item condition filter */
+    condition?: EbayCondition;
+    /** Minimum price filter */
+    min_price?: number;
+    /** Maximum price filter */
+    max_price?: number;
+}
+/** Options for the item detail endpoint. */
+interface EbayItemParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+}
+/** Options for the item reviews endpoint. */
+interface EbayReviewsParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Fetch reviews by catalog product id instead of item id */
+    productId?: string;
+}
+/** Options for the seller profile endpoint. */
+interface EbaySellerParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+}
+/** Options for the seller items endpoint. */
+interface EbaySellerItemsParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Filter the seller's listings by keyword */
+    query?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Results per page (60, 120 or 240; clamped) */
+    per_page?: number;
+}
+/** Options for the seller feedback endpoint. */
+interface EbaySellerFeedbackParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+}
+/** Options for the category-browse endpoint. */
+interface EbayCategoryParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Results per page (60, 120 or 240; clamped) */
+    per_page?: number;
+    /** Sort order */
+    sort_by?: EbaySortBy;
+    /** Minimum price filter */
+    min_price?: number;
+    /** Maximum price filter */
+    max_price?: number;
+}
+/** Options for the autocomplete endpoint. */
+interface EbayAutocompleteParams {
+    /** Marketplace domain (default: "com") */
+    domain?: string;
+}
+
+/**
+ * eBay Search API client.
+ *
+ * Provides methods for active search, completed/sold search, and keyword
+ * autocomplete suggestions.
+ */
+
+/**
+ * Client for eBay search, completed-listings, and autocomplete endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const results = await client.ebay.search.search({ query: "nintendo switch" });
+ * for (const item of results.results) {
+ *   console.log(`${item.position}. ${item.title}`);
+ * }
+ *
+ * const sold = await client.ebay.search.completed({ query: "nintendo switch" });
+ *
+ * const suggestions = await client.ebay.search.autocomplete("ipho");
+ * ```
+ */
+declare class SearchClient$1 {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Search an eBay marketplace for active listings.
+     *
+     * @param params - Search parameters including query, filters, and pagination.
+     * @returns Search results with cards, facets, and pagination metadata.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the parameters are invalid.
+     */
+    search(params: EbaySearchParams): Promise<SearchResponse$1>;
+    /**
+     * Search completed / sold listings — eBay's sold-price history.
+     *
+     * @param params - Search parameters including query, filters, and pagination.
+     * @returns Search results (with `sold: true`), facets, and pagination.
+     */
+    completed(params: EbayCompletedParams): Promise<SearchResponse$1>;
+    /**
+     * Get eBay keyword autocomplete suggestions.
+     *
+     * @param query - Partial search query prefix.
+     * @param options - Optional parameters (domain).
+     * @returns Autocomplete suggestions.
+     */
+    autocomplete(query: string, options?: EbayAutocompleteParams): Promise<AutocompleteResponse$1>;
+}
+
+/**
+ * eBay Items API client.
+ *
+ * Provides methods for fetching item detail and catalog product reviews.
+ */
+
+/**
+ * Client for eBay item endpoints (detail, reviews).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const detail = await client.ebay.items.get("123456789012");
+ * console.log(detail.item.title);
+ *
+ * const reviews = await client.ebay.items.reviews("123456789012");
+ * console.log(`${reviews.ratings_total} reviews`);
+ * ```
+ */
+declare class ItemsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a single eBay listing's full detail.
+     *
+     * @param itemId - The eBay item id.
+     * @param options - Optional parameters (domain).
+     * @returns Item detail including specifics, shipping, and seller summary.
+     * @throws NotFoundError - If the item doesn't exist.
+     */
+    get(itemId: string, options?: EbayItemParams): Promise<ItemDetailResponse>;
+    /**
+     * Get the catalog product reviews shown on an eBay listing.
+     *
+     * @param itemId - The eBay item id.
+     * @param options - Optional parameters (domain, page, productId).
+     * @returns Reviews response with reviews, aggregate rating, and histogram.
+     */
+    reviews(itemId: string, options?: EbayReviewsParams): Promise<ReviewsResponse>;
+}
+
+/**
+ * eBay Sellers API client.
+ *
+ * Provides methods for seller profile, storefront listings, and feedback.
+ */
+
+/**
+ * Client for eBay seller endpoints (profile, items, feedback).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const profile = await client.ebay.sellers.get("musicmagpie");
+ * console.log(profile.seller.feedback_score);
+ *
+ * const items = await client.ebay.sellers.items("musicmagpie");
+ * const feedback = await client.ebay.sellers.feedback("musicmagpie");
+ * ```
+ */
+declare class SellersClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get an eBay seller's public profile.
+     *
+     * @param username - The seller username.
+     * @param options - Optional parameters (domain).
+     * @returns Seller profile response.
+     * @throws NotFoundError - If the seller doesn't exist.
+     */
+    get(username: string, options?: EbaySellerParams): Promise<SellerProfileResponse>;
+    /**
+     * List the active listings of a single eBay seller.
+     *
+     * @param username - The seller username.
+     * @param options - Optional parameters (domain, query, page, per_page).
+     * @returns Seller items response with result cards and pagination.
+     */
+    items(username: string, options?: EbaySellerItemsParams): Promise<SellerItemsResponse>;
+    /**
+     * Get a seller's recent feedback comments.
+     *
+     * @param username - The seller username.
+     * @param options - Optional parameters (domain, page).
+     * @returns Seller feedback response with feedback entries and pagination.
+     */
+    feedback(username: string, options?: EbaySellerFeedbackParams): Promise<SellerFeedbackResponse>;
+}
+
+/**
+ * eBay Categories API client.
+ *
+ * Provides methods for browsing a category's listings and listing the
+ * reference category aliases.
+ */
+
+/**
+ * Client for eBay category endpoints (browse, list).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const listings = await client.ebay.categories.browse("9355");
+ * for (const item of listings.results) {
+ *   console.log(item.title);
+ * }
+ *
+ * const categories = await client.ebay.categories.list();
+ * ```
+ */
+declare class CategoriesClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * List active listings within an eBay category.
+     *
+     * @param categoryId - The eBay category id.
+     * @param options - Optional parameters (domain, page, per_page, sort_by, min_price, max_price).
+     * @returns Category response with result cards, facets, and pagination.
+     */
+    browse(categoryId: string, options?: EbayCategoryParams): Promise<CategoryResponse>;
+    /**
+     * List eBay's reference top-level category ids.
+     *
+     * @returns Categories response with all category aliases.
+     */
+    list(): Promise<CategoriesResponse$1>;
+}
+
+/**
+ * eBay Reference Data API client.
+ *
+ * Provides methods for fetching the static marketplace list.
+ */
+
+/**
+ * Client for eBay reference data endpoints (markets).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const markets = await client.ebay.reference.markets();
+ * for (const m of markets.markets) {
+ *   console.log(`${m.code}: ${m.domain} (${m.currency})`);
+ * }
+ * ```
+ */
+declare class ReferenceClient$1 {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get all supported eBay marketplaces.
+     *
+     * @returns Markets response with all supported marketplaces.
+     */
+    markets(): Promise<MarketsResponse$1>;
+}
+
+/**
+ * eBay API client.
+ *
+ * Provides access to all eBay API endpoints through specialized sub-clients.
+ */
+
+/**
+ * eBay API client with access to all eBay endpoints.
+ *
+ * Provides sub-clients for different resource types:
+ * - `search` - Active search, completed/sold search, and autocomplete
+ * - `items` - Item detail and catalog product reviews
+ * - `sellers` - Seller profile, storefront items, and feedback
+ * - `categories` - Category browse and reference category list
+ * - `reference` - Reference data (markets)
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * // Search active listings
+ * const results = await client.ebay.search.search({ query: "nintendo switch" });
+ *
+ * // Sold-price history
+ * const sold = await client.ebay.search.completed({ query: "nintendo switch" });
+ *
+ * // Get item detail
+ * const item = await client.ebay.items.get("123456789012");
+ *
+ * // Get item reviews
+ * const reviews = await client.ebay.items.reviews("123456789012");
+ *
+ * // Get a seller profile
+ * const seller = await client.ebay.sellers.get("musicmagpie");
+ *
+ * // Browse a category
+ * const listings = await client.ebay.categories.browse("9355");
+ *
+ * // Reference data
+ * const markets = await client.ebay.reference.markets();
+ * ```
+ */
+declare class EbayClient {
+    /** Client for active search, completed/sold search, and autocomplete */
+    readonly search: SearchClient$1;
+    /** Client for item detail and catalog product reviews */
+    readonly items: ItemsClient;
+    /** Client for seller profile, items, and feedback */
+    readonly sellers: SellersClient;
+    /** Client for category browse and the reference category list */
+    readonly categories: CategoriesClient;
+    /** Client for reference data (markets) */
+    readonly reference: ReferenceClient$1;
+    /**
+     * Create a new eBay client.
+     *
+     * @param client - The base HTTP client for making requests.
+     */
+    constructor(client: BaseClient);
+}
+
+/**
+ * TypeScript types for YouTube API responses.
+ *
+ * These interfaces mirror the backend `youtube_scraper` response schema
+ * field-for-field (see `scrapers/youtube/src/youtube_scraper/models/*.py`).
+ * 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.
+ *
+ * All list endpoints paginate via an opaque `continuation` token (no page
+ * numbers). Region is controlled by `gl` (content region) + `hl` (UI language).
+ */
+/**
+ * A single image variant.
+ */
+interface Thumbnail {
+    url: string;
+    width: number | null;
+    height: number | null;
+}
+/**
+ * Result of resolving a handle / custom URL to canonical ids.
+ */
+interface ResolveResult {
+    input: string;
+    /** "channel" | "video" | "playlist" */
+    type: string | null;
+    channel_id: string | null;
+    channel_username: string | null;
+    video_id: string | null;
+    playlist_id: string | null;
+    canonical_url: string | null;
+}
+/**
+ * A reference lookup row (category / language / region).
+ */
+interface ReferenceRow {
+    id: string;
+    title: string;
+}
+/**
+ * YouTube public oEmbed response (https://www.youtube.com/oembed).
+ */
+interface OEmbed {
+    type: string | null;
+    version: string | null;
+    title: string | null;
+    author_name: string | null;
+    author_url: string | null;
+    provider_name: string | null;
+    provider_url: string | null;
+    thumbnail_url: string | null;
+    thumbnail_width: number | null;
+    thumbnail_height: number | null;
+    width: number | null;
+    height: number | null;
+    html: string | null;
+}
+/**
+ * A video chapter (manual or auto).
+ */
+interface Chapter {
+    title: string | null;
+    start_seconds: number | null;
+    start_time_text: string | null;
+    thumbnail: string | null;
+}
+/**
+ * A most-replayed graph point.
+ */
+interface HeatMarker {
+    start_seconds: number | null;
+    duration_seconds: number | null;
+    /** 0.0-1.0 normalized score */
+    intensity: number | null;
+}
+/**
+ * A multi-language audio track (auto-dubbing / original).
+ */
+interface AudioTrack {
+    id: string | null;
+    display_name: string | null;
+    language: string | null;
+    is_default: boolean | null;
+    is_original: boolean | null;
+}
+/**
+ * A single streaming format (muxed or adaptive).
+ */
+interface Format {
+    itag: number | null;
+    mime_type: string | null;
+    codecs: string | null;
+    bitrate: number | null;
+    average_bitrate: number | null;
+    width: number | null;
+    height: number | null;
+    fps: number | null;
+    quality: string | null;
+    quality_label: string | null;
+    audio_quality: string | null;
+    audio_sample_rate: number | null;
+    audio_channels: number | null;
+    /** stable-volume (dynamic range compression) audio */
+    is_drc: boolean | null;
+    loudness_db: number | null;
+    audio_track: AudioTrack | null;
+    content_length: number | null;
+    approx_duration_ms: number | null;
+    /** may require a PO token (best-effort) */
+    url: string | null;
+    signature_cipher: string | null;
+    projection_type: string | null;
+}
+/**
+ * Streaming metadata from `player.streamingData` (best-effort URLs).
+ */
+interface StreamingData {
+    expires_in_seconds: number | null;
+    hls_manifest_url: string | null;
+    dash_manifest_url: string | null;
+    formats: Format[];
+    adaptive_formats: Format[];
+}
+/**
+ * A product shelf entry attached to a video.
+ */
+interface ShoppingResult {
+    title: string | null;
+    price: string | null;
+    vendor: string | null;
+    thumbnail: string | null;
+    link: string | null;
+}
+/**
+ * Live/premiere timing details.
+ */
+interface LiveStreamingDetails {
+    actual_start_at: string | null;
+    actual_start_utc: number | null;
+    actual_end_at: string | null;
+    actual_end_utc: number | null;
+    scheduled_start_at: string | null;
+    scheduled_start_utc: number | null;
+    scheduled_end_at: string | null;
+    scheduled_end_utc: number | null;
+    concurrent_viewers: number | null;
+    active_live_chat_id: string | null;
+}
+/**
+ * Region availability restrictions.
+ */
+interface RegionRestriction {
+    allowed: string[];
+    blocked: string[];
+}
+/**
+ * Full video detail — merged `player` + `next` (the flagship entity).
+ */
+interface Video {
+    video_id: string;
+    title: string | null;
+    url: string | null;
+    description: string | null;
+    description_links: Record<string, unknown>[];
+    length_seconds: number | null;
+    /** HH:MM:SS */
+    duration: string | null;
+    view_count: number | null;
+    view_count_text: string | null;
+    like_count: number | null;
+    like_count_text: string | null;
+    comment_count: number | null;
+    /** private platform-wide since 2021 (null) */
+    dislike_count: number | null;
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_username: string | null;
+    channel_url: string | null;
+    channel_thumbnail: string | null;
+    channel_is_verified: boolean | null;
+    is_official_artist: boolean | null;
+    number_of_subscribers: number | null;
+    subscriber_count_text: string | null;
+    published_at: string | null;
+    published_utc: number | null;
+    upload_at: string | null;
+    upload_utc: number | null;
+    published_time_text: string | null;
+    keywords: string[];
+    tags: string[];
+    hashtags: string[];
+    category: string | null;
+    category_id: string | null;
+    topic_categories: string[];
+    thumbnails: Thumbnail[];
+    thumbnail: string | null;
+    storyboards: Record<string, unknown> | null;
+    chapters: Chapter[];
+    heatmap: HeatMarker[];
+    is_live_content: boolean | null;
+    live_now: boolean | null;
+    is_upcoming: boolean | null;
+    is_post_live_dvr: boolean | null;
+    premiere_utc: number | null;
+    premiere_at: string | null;
+    live_streaming_details: LiveStreamingDetails | null;
+    is_family_safe: boolean | null;
+    is_age_restricted: boolean | null;
+    is_members_only: boolean | null;
+    is_unlisted: boolean | null;
+    is_private: boolean | null;
+    is_crawlable: boolean | null;
+    is_shorts_eligible: boolean | null;
+    is_short: boolean | null;
+    allow_ratings: boolean | null;
+    is_monetized: boolean | null;
+    comments_turned_off: boolean | null;
+    has_paid_product_placement: boolean | null;
+    available_countries: string[];
+    region_restriction: RegionRestriction | null;
+    playability_status: string | null;
+    playability_reason: string | null;
+    /** hd / sd */
+    definition: string | null;
+    /** 2d / 3d */
+    dimension: string | null;
+    /** rectangular / 360 */
+    projection: string | null;
+    captions_available: boolean | null;
+    caption_languages: string[];
+    shopping_results: ShoppingResult[];
+    additional_info: Record<string, unknown>[];
+    game_info: Record<string, unknown> | null;
+    end_screen_videos: Record<string, unknown>[];
+    related_videos: Record<string, unknown>[];
+    related_videos_continuation: string | null;
+    sound_id: string | null;
+    sound_title: string | null;
+    sound_artist: string | null;
+    streams: StreamingData | null;
+    embed_url: string | null;
+    scraped_at: string | null;
+    scraped_utc: number | null;
+}
+/**
+ * A Shorts (vertical reel) — Video subtype with `is_short=true`.
+ */
+interface Short extends Video {
+    thumbnail_vertical: string | null;
+}
+/**
+ * Response for POST /videos/batch.
+ */
+interface BatchResponse {
+    videos: Video[];
+    errors: Record<string, unknown>[];
+    count: number;
+}
+/**
+ * An external link from a channel's about page / header.
+ */
+interface ChannelLink {
+    title: string | null;
+    url: string | null;
+}
+/**
+ * Full channel detail (browse About tab + header).
+ */
+interface Channel {
+    channel_id: string;
+    title: string | null;
+    channel_name: string | null;
+    /** @handle */
+    channel_username: string | null;
+    custom_url: string | null;
+    channel_url: string | null;
+    description: string | null;
+    description_links: ChannelLink[];
+    number_of_subscribers: number | null;
+    subscriber_count_text: string | null;
+    hidden_subscriber_count: boolean | null;
+    channel_total_videos: number | null;
+    channel_total_videos_text: string | null;
+    channel_total_views: number | null;
+    channel_total_views_text: string | null;
+    joined_at: string | null;
+    joined_utc: number | null;
+    country: string | null;
+    channel_location: string | null;
+    keywords: string[];
+    tags: string[];
+    is_verified: boolean | null;
+    is_age_restricted: boolean | null;
+    is_family_safe: boolean | null;
+    is_monetized: boolean | null;
+    is_auto_generated: boolean | null;
+    made_for_kids: boolean | null;
+    avatar: string | null;
+    banner: string | null;
+    tv_banner: string | null;
+    mobile_banner: string | null;
+    avatar_thumbnails: Thumbnail[];
+    banner_thumbnails: Thumbnail[];
+    external_links: ChannelLink[];
+    tabs: string[];
+    available_countries: string[];
+    related_channels: Record<string, unknown>[];
+    latest_videos: Record<string, unknown>[];
+    scraped_at: string | null;
+    scraped_utc: number | null;
+}
+/**
+ * Lightweight channel about payload.
+ */
+interface ChannelAbout {
+    channel_id: string;
+    description: string | null;
+    links: ChannelLink[];
+    number_of_subscribers: number | null;
+    subscriber_count_text: string | null;
+    channel_total_views: number | null;
+    channel_total_videos: number | null;
+    joined_at: string | null;
+    joined_utc: number | null;
+    country: string | null;
+}
+/**
+ * Fast subscriber-count-only response.
+ */
+interface SubscriberCount {
+    channel_id: string;
+    number_of_subscribers: number | null;
+    subscriber_count_text: string | null;
+}
+/**
+ * A single entry in a playlist.
+ */
+interface PlaylistItem {
+    position: number | null;
+    video_id: string;
+    title: string | null;
+    url: string | null;
+    length_seconds: number | null;
+    duration: string | null;
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_url: string | null;
+    thumbnails: Thumbnail[];
+    thumbnail: string | null;
+    view_count: number | null;
+    view_count_text: string | null;
+    published_time_text: string | null;
+    is_playable: boolean | null;
+    /** per-playlist-entry id */
+    set_video_id: string | null;
+}
+/**
+ * Full playlist detail + first page of items.
+ */
+interface Playlist {
+    playlist_id: string;
+    title: string | null;
+    description: string | null;
+    playlist_url: string | null;
+    video_count: number | null;
+    view_count: number | null;
+    view_count_text: string | null;
+    last_updated_text: string | null;
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_url: string | null;
+    channel_is_verified: boolean | null;
+    thumbnails: Thumbnail[];
+    thumbnail: string | null;
+    privacy_status: string | null;
+    is_mix: boolean | null;
+    videos: PlaylistItem[];
+    continuation: string | null;
+    scraped_at: string | null;
+    scraped_utc: number | null;
+}
+/**
+ * A continuation page of playlist items.
+ */
+interface PlaylistItemsResponse {
+    playlist_id: string | null;
+    items: PlaylistItem[];
+    continuation: string | null;
+}
+/**
+ * A single comment or reply.
+ */
+interface Comment {
+    comment_id: string;
+    text: string | null;
+    published_time_text: string | null;
+    published_utc: number | null;
+    author: string | null;
+    author_channel_id: string | null;
+    author_channel_url: string | null;
+    author_thumbnail: string | null;
+    author_is_verified: boolean | null;
+    author_is_artist: boolean | null;
+    author_is_channel_owner: boolean | null;
+    author_badges: string[];
+    like_count: number | null;
+    reply_count: number | null;
+    has_creator_heart: boolean | null;
+    is_pinned: boolean | null;
+    is_reply: boolean | null;
+    reply_to_cid: string | null;
+    replies_continuation: string | null;
+    /** Super Thanks purchase amount */
+    paid_comment_amount: string | null;
+    video_id: string | null;
+}
+/**
+ * A page of top-level comments.
+ */
+interface CommentsResponse {
+    video_id: string | null;
+    comments: Comment[];
+    comment_count: number | null;
+    sorting_tokens: Record<string, unknown>[];
+    continuation: string | null;
+}
+/**
+ * A page of replies to a comment.
+ */
+interface RepliesResponse {
+    comment_id: string | null;
+    replies: Comment[];
+    continuation: string | null;
+}
+/**
+ * A polymorphic search/feed result (keyed by `type`).
+ */
+interface SearchResult {
+    /** "video" | "channel" | "playlist" | "movie" | "short" */
+    type: string;
+    position: number | null;
+    video_id: string | null;
+    title: string | null;
+    url: string | null;
+    thumbnails: Thumbnail[];
+    thumbnail: string | null;
+    duration: string | null;
+    length_seconds: number | null;
+    view_count: number | null;
+    view_count_text: string | null;
+    short_view_count_text: string | null;
+    published_time_text: string | null;
+    published_at: string | null;
+    published_utc: number | null;
+    description_snippet: string | null;
+    badges: string[];
+    extensions: string[];
+    is_live: boolean | null;
+    is_short: boolean | null;
+    is_members_only: boolean | null;
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_url: string | null;
+    channel_thumbnail: string | null;
+    channel_is_verified: boolean | null;
+    subscriber_count_text: string | null;
+    number_of_subscribers: number | null;
+    video_count_text: string | null;
+    channel_username: string | null;
+    is_verified: boolean | null;
+    playlist_id: string | null;
+    video_count: number | null;
+    first_video_id: string | null;
+}
+/**
+ * A search filter chip / refinement.
+ */
+interface SearchChip {
+    title: string | null;
+    is_selected: boolean | null;
+    continuation: string | null;
+}
+/**
+ * A page of search results.
+ */
+interface SearchResponse {
+    query: string | null;
+    results: SearchResult[];
+    total_results: number | null;
+    estimated_results: number | null;
+    chips: SearchChip[];
+    did_you_mean: string | null;
+    showing_results_for: string | null;
+    refinements: string[];
+    related_searches: Record<string, unknown>[];
+    continuation: string | null;
+}
+/**
+ * Keyword suggestions for a query prefix.
+ */
+interface AutocompleteResponse {
+    query: string;
+    suggestions: string[];
+}
+/**
+ * Related videos for a video (secondaryResults).
+ */
+interface RelatedResponse {
+    video_id: string | null;
+    results: SearchResult[];
+    continuation: string | null;
+}
+/**
+ * Videos under a hashtag.
+ */
+interface HashtagResponse {
+    tag: string;
+    results: SearchResult[];
+    continuation: string | null;
+}
+/**
+ * Guest home / recommendations feed (non-deterministic, best-effort).
+ */
+interface HomeResponse {
+    results: SearchResult[];
+    continuation: string | null;
+}
+/**
+ * A page of a channel's videos / shorts / streams.
+ */
+interface ChannelVideosResponse {
+    channel_id: string | null;
+    videos: SearchResult[];
+    continuation: string | null;
+}
+/**
+ * A generic page of a channel tab (videos/shorts/streams/playlists).
+ */
+interface ChannelTabResponse {
+    channel_id: string | null;
+    tab: string | null;
+    items: SearchResult[];
+    continuation: string | null;
+}
+/**
+ * A single timed transcript line.
+ */
+interface TranscriptSegment {
+    start_ms: number | null;
+    end_ms: number | null;
+    duration_ms: number | null;
+    start_time_text: string | null;
+    text: string | null;
+}
+/**
+ * A full video transcript in the selected language.
+ */
+interface Transcript {
+    video_id: string;
+    language: string | null;
+    language_name: string | null;
+    /** asr | manual */
+    type: string | null;
+    is_translatable: boolean | null;
+    available_transcripts: Record<string, unknown>[];
+    translation_languages: Record<string, unknown>[];
+    segments: TranscriptSegment[];
+    full_text: string | null;
+    srt: string | null;
+    vtt: string | null;
+}
+/**
+ * An available caption track (from player captions tracklist).
+ */
+interface CaptionTrack {
+    language: string | null;
+    language_name: string | null;
+    /** asr | manual */
+    type: string | null;
+    is_translatable: boolean | null;
+    base_url: string | null;
+}
+/**
+ * The list of available caption tracks for a video.
+ */
+interface CaptionsResponse {
+    video_id: string;
+    tracks: CaptionTrack[];
+    translation_languages: Record<string, unknown>[];
+}
+/**
+ * A trending video / short.
+ */
+interface TrendingItem {
+    position: number | null;
+    /** Now | Music | Gaming | Movies */
+    category: string | null;
+    video_id: string | null;
+    title: string | null;
+    url: string | null;
+    thumbnails: Thumbnail[];
+    thumbnail: string | null;
+    duration: string | null;
+    length_seconds: number | null;
+    view_count: number | null;
+    view_count_text: string | null;
+    published_time_text: string | null;
+    description_snippet: string | null;
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_url: string | null;
+    channel_thumbnail: string | null;
+    channel_is_verified: boolean | null;
+    badges: string[];
+    is_live: boolean | null;
+    is_short: boolean | null;
+}
+/**
+ * A page of trending items.
+ */
+interface TrendingResponse {
+    gl: string | null;
+    type: string | null;
+    items: TrendingItem[];
+    continuation: string | null;
+}
+/**
+ * A single poll option on a community post.
+ */
+interface PollChoice {
+    text: string | null;
+    percentage: number | null;
+    votes: number | null;
+    image: string | null;
+}
+/**
+ * A channel community / posts-tab entry.
+ */
+interface CommunityPost {
+    post_id: string;
+    post_url: string | null;
+    /** text | poll | image | video | shared */
+    post_type: string | null;
+    text: string | null;
+    text_links: Record<string, unknown>[];
+    channel_id: string | null;
+    channel_name: string | null;
+    channel_url: string | null;
+    channel_thumbnail: string | null;
+    published_time_text: string | null;
+    published_utc: number | null;
+    like_count: number | null;
+    like_count_text: string | null;
+    comment_count: number | null;
+    poll_choices: PollChoice[];
+    poll_total_votes: number | null;
+    images: Thumbnail[];
+    attached_video: Record<string, unknown> | null;
+    shared_post: Record<string, unknown> | null;
+    scraped_at: string | null;
+    scraped_utc: number | null;
+}
+/**
+ * A page of community posts.
+ */
+interface CommunityResponse {
+    channel_id: string | null;
+    posts: CommunityPost[];
+    continuation: string | null;
+}
+/**
+ * A single live-chat / chat-replay message.
+ */
+interface LiveChatMessage {
+    message_id: string | null;
+    /** text | super_chat | super_sticker | membership */
+    message_type: string | null;
+    text: string | null;
+    author: string | null;
+    author_channel_id: string | null;
+    author_thumbnail: string | null;
+    author_badges: string[];
+    is_moderator: boolean | null;
+    is_member: boolean | null;
+    is_verified: boolean | null;
+    timestamp_usec: number | null;
+    timestamp_text: string | null;
+    video_offset_time_msec: number | null;
+    /** super chat / sticker amount */
+    purchase_amount: string | null;
+    body_background_color: string | null;
+}
+/**
+ * A page of live-chat messages.
+ */
+interface LiveChatResponse {
+    video_id: string | null;
+    messages: LiveChatMessage[];
+    continuation: string | null;
+    is_replay: boolean | null;
+}
+/**
+ * Response from the /categories endpoint.
+ */
+interface CategoriesResponse {
+    gl: string;
+    categories: ReferenceRow[];
+}
+/**
+ * Response from the /languages endpoint.
+ */
+interface LanguagesResponse {
+    languages: ReferenceRow[];
+}
+/**
+ * Response from the /regions endpoint.
+ */
+interface RegionsResponse {
+    regions: ReferenceRow[];
+}
+/**
+ * A single geo-targeted scraper market (for /markets).
+ */
+interface MarketInfo {
+    /** Content region code (e.g. "US") */
+    gl: string;
+    /** UI language code (e.g. "en") */
+    hl: string;
+    /** Market display name */
+    name: string;
+}
+/**
+ * Response from the /markets endpoint.
+ */
+interface MarketsResponse {
+    markets: MarketInfo[];
+}
+/** Result-type filter for search. */
+type YoutubeSearchType = "video" | "channel" | "playlist" | "movie" | "all";
+/** Sort order for search. */
+type YoutubeSearchSort = "relevance" | "date" | "views" | "rating";
+/** Upload-date filter for search. */
+type YoutubeUploadDate = "hour" | "today" | "week" | "month" | "year";
+/** Duration filter for search. */
+type YoutubeDuration = "short" | "medium" | "long";
+/** Comment sort order. */
+type YoutubeCommentSort = "top" | "newest";
+/** Trending feed type. */
+type YoutubeTrendingType = "now" | "music" | "gaming" | "movies";
+/** Player client for the streams endpoint. */
+type YoutubeStreamsClient = "IOS" | "ANDROID" | "WEB";
+/** Region parameters shared by most endpoints. */
+interface YoutubeRegionParams {
+    /** Content region (US, GB, DE…) */
+    gl?: string;
+    /** UI language */
+    hl?: string;
+}
+/** Parameters for the search endpoint. */
+interface YoutubeSearchParams extends YoutubeRegionParams {
+    /** Search keywords (required) */
+    query: string;
+    /** Result-type filter */
+    type?: YoutubeSearchType;
+    /** Sort order */
+    sort_by?: YoutubeSearchSort;
+    /** Upload-date filter */
+    upload_date?: YoutubeUploadDate;
+    /** Duration filter */
+    duration?: YoutubeDuration;
+    /** Comma list: hd,4k,360,vr180,3d,hdr,cc,subtitles,live,location */
+    features?: string;
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the autocomplete endpoint. */
+interface YoutubeAutocompleteParams extends YoutubeRegionParams {
+}
+/** Options for the video detail endpoint. */
+interface YoutubeVideoParams extends YoutubeRegionParams {
+}
+/** Options for the related-videos endpoint. */
+interface YoutubeRelatedParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the video comments endpoint. */
+interface YoutubeCommentsParams extends YoutubeRegionParams {
+    /** Comment sort order (default: "top") */
+    sort_by?: YoutubeCommentSort;
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the comment replies endpoint. */
+interface YoutubeRepliesParams extends YoutubeRegionParams {
+    /** Replies continuation token (from a comment; required) */
+    continuation: string;
+}
+/** Options for the transcript endpoint. */
+interface YoutubeTranscriptParams extends YoutubeRegionParams {
+    /** BCP-47 language code */
+    language?: string;
+}
+/** Options for the captions endpoint. */
+interface YoutubeCaptionsParams extends YoutubeRegionParams {
+}
+/** Options for the streams endpoint. */
+interface YoutubeStreamsParams {
+    /** Content region */
+    gl?: string;
+    /** Player client (default: "IOS") */
+    client?: YoutubeStreamsClient;
+}
+/** Options for the live-chat endpoint. */
+interface YoutubeLiveChatParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+    /** Fetch chat replay for a finished stream */
+    replay?: boolean;
+}
+/** Parameters for the batch video endpoint. */
+interface YoutubeBatchParams extends YoutubeRegionParams {
+    /** Video ids to fetch (≤50, required) */
+    video_ids: string[];
+}
+/** Options for the oEmbed endpoint. */
+interface YoutubeOEmbedParams {
+    /** A YouTube video/playlist/channel URL (required) */
+    url: string;
+}
+/** Options for the channel detail / about / subscriber_count endpoints. */
+interface YoutubeChannelParams extends YoutubeRegionParams {
+}
+/** Options for a channel tab (videos/shorts/streams/playlists/community) endpoint. */
+interface YoutubeChannelTabParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the in-channel search endpoint. */
+interface YoutubeChannelSearchParams extends YoutubeRegionParams {
+    /** Search keywords (required) */
+    query: string;
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the channel resolve endpoint. */
+interface YoutubeResolveParams extends YoutubeRegionParams {
+    /** @handle or custom name */
+    handle?: string;
+    /** Full channel/video/playlist URL */
+    url?: string;
+}
+/** Options for the playlist detail / mix endpoints. */
+interface YoutubePlaylistParams extends YoutubeRegionParams {
+}
+/** Options for the playlist items endpoint. */
+interface YoutubePlaylistItemsParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the community post detail endpoint. */
+interface YoutubePostParams extends YoutubeRegionParams {
+}
+/** Options for the community post comments endpoint. */
+interface YoutubePostCommentsParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the single-short endpoint. */
+interface YoutubeShortParams extends YoutubeRegionParams {
+}
+/** Options for the shorts-by-sound endpoint. */
+interface YoutubeShortsBySoundParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the trending endpoint. */
+interface YoutubeTrendingParams extends YoutubeRegionParams {
+    /** Trending feed type (default: "now") */
+    type?: YoutubeTrendingType;
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the trending-shorts endpoint. */
+interface YoutubeTrendingShortsParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the hashtag endpoint. */
+interface YoutubeHashtagParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the home-feed endpoint. */
+interface YoutubeHomeParams extends YoutubeRegionParams {
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the music-search endpoint. */
+interface YoutubeMusicSearchParams extends YoutubeRegionParams {
+    /** Search keywords (required) */
+    query: string;
+    /** Pagination token */
+    continuation?: string;
+}
+/** Options for the categories reference endpoint. */
+interface YoutubeCategoriesParams {
+    /** Content region (default: "US") */
+    gl?: string;
+}
+
+/**
+ * YouTube Search API client.
+ *
+ * Provides methods for full-matrix search and keyword autocomplete.
+ */
+
+/**
+ * Client for YouTube search and autocomplete endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const results = await client.youtube.search.search({ query: "lofi beats" });
+ * for (const r of results.results) {
+ *   console.log(`${r.position}. ${r.title}`);
+ * }
+ *
+ * const suggestions = await client.youtube.search.autocomplete("lofi");
+ * ```
+ */
+declare class SearchClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Search YouTube videos / channels / playlists with the full filter matrix.
+     *
+     * @param params - Search parameters including query, filters, and continuation.
+     * @returns A page of search results with chips, refinements, and a continuation token.
+     * @throws AuthenticationError - If the API key is invalid.
+     * @throws ValidationError - If the parameters are invalid.
+     */
+    search(params: YoutubeSearchParams): Promise<SearchResponse>;
+    /**
+     * Get YouTube keyword autocomplete suggestions.
+     *
+     * @param query - Partial search query prefix.
+     * @param options - Optional region parameters (gl, hl).
+     * @returns Autocomplete suggestions.
+     */
+    autocomplete(query: string, options?: YoutubeAutocompleteParams): Promise<AutocompleteResponse>;
+}
+
+/**
+ * YouTube Videos API client.
+ *
+ * Provides methods for video detail, related videos, comments, replies,
+ * transcript, captions, stream formats, live chat, batch detail, and oEmbed.
+ */
+
+/**
+ * Client for YouTube video endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const video = await client.youtube.videos.get("dQw4w9WgXcQ");
+ * console.log(`${video.title} — ${video.view_count} views`);
+ *
+ * const comments = await client.youtube.videos.comments("dQw4w9WgXcQ");
+ * const transcript = await client.youtube.videos.transcript("dQw4w9WgXcQ");
+ * ```
+ */
+declare class VideosClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a single video's full detail (merged `player` + `next`).
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional region parameters (gl, hl).
+     * @returns Full video detail including engagement, channel, chapters, and heatmap.
+     * @throws NotFoundError - If the video doesn't exist or is unavailable.
+     */
+    get(videoId: string, options?: YoutubeVideoParams): Promise<Video>;
+    /**
+     * Get related / recommended videos for a video.
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional region parameters and a continuation token.
+     * @returns Related results with a continuation token.
+     */
+    related(videoId: string, options?: YoutubeRelatedParams): Promise<RelatedResponse>;
+    /**
+     * Get a page of top-level comments for a video.
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional sort order, continuation token, and region.
+     * @returns A page of comments with sorting tokens and a continuation token.
+     */
+    comments(videoId: string, options?: YoutubeCommentsParams): Promise<CommentsResponse>;
+    /**
+     * Get a page of replies to a single comment.
+     *
+     * @param videoId - The YouTube video id.
+     * @param commentId - The comment id whose replies to fetch.
+     * @param options - The required replies continuation token plus region.
+     * @returns A page of replies with a continuation token.
+     */
+    replies(videoId: string, commentId: string, options: YoutubeRepliesParams): Promise<RepliesResponse>;
+    /**
+     * Get a video's transcript in the selected language.
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional language and region parameters.
+     * @returns The transcript with timed segments and full text.
+     */
+    transcript(videoId: string, options?: YoutubeTranscriptParams): Promise<Transcript>;
+    /**
+     * List a video's available caption tracks.
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional region parameters.
+     * @returns The available caption tracks and translation languages.
+     */
+    captions(videoId: string, options?: YoutubeCaptionsParams): Promise<CaptionsResponse>;
+    /**
+     * Get a video's stream / format metadata (best-effort; URLs may be PO-token gated).
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional content region and player client.
+     * @returns Streaming metadata with muxed and adaptive formats.
+     */
+    streams(videoId: string, options?: YoutubeStreamsParams): Promise<StreamingData>;
+    /**
+     * Get a page of live-chat (or chat-replay) messages for a video.
+     *
+     * @param videoId - The YouTube video id.
+     * @param options - Optional continuation token, replay flag, and region.
+     * @returns A page of live-chat messages with a continuation token.
+     */
+    liveChat(videoId: string, options?: YoutubeLiveChatParams): Promise<LiveChatResponse>;
+    /**
+     * Fetch detail for up to 50 videos concurrently.
+     *
+     * @param params - The video ids (≤50) plus optional region parameters.
+     * @returns Successfully fetched videos plus per-id errors.
+     */
+    batch(params: YoutubeBatchParams): Promise<BatchResponse>;
+    /**
+     * Get public oEmbed metadata for a YouTube URL (no proxy/InnerTube needed).
+     *
+     * @param url - A YouTube video/playlist/channel URL.
+     * @returns The oEmbed metadata.
+     */
+    oembed(url: string): Promise<OEmbed>;
+    oembed(params: YoutubeOEmbedParams): Promise<OEmbed>;
+}
+
+/**
+ * YouTube Channels API client.
+ *
+ * Provides methods for channel detail, tab feeds (videos/shorts/streams/
+ * playlists/community), about, subscriber count, in-channel search, and resolve.
+ */
+
+/**
+ * Client for YouTube channel endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const channel = await client.youtube.channels.get("@MrBeast");
+ * console.log(`${channel.title} — ${channel.number_of_subscribers} subs`);
+ *
+ * const videos = await client.youtube.channels.videos("@MrBeast");
+ * const id = await client.youtube.channels.resolve({ handle: "@MrBeast" });
+ * ```
+ */
+declare class ChannelsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get full channel detail (accepts a UC id, @handle, or custom URL).
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional region parameters.
+     * @returns Full channel detail.
+     * @throws NotFoundError - If the channel doesn't exist.
+     */
+    get(channelId: string, options?: YoutubeChannelParams): Promise<Channel>;
+    /**
+     * Get a page of a channel's long-form videos.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional continuation token and region.
+     * @returns A page of video cards with a continuation token.
+     */
+    videos(channelId: string, options?: YoutubeChannelTabParams): Promise<ChannelTabResponse>;
+    /**
+     * Get a page of a channel's Shorts.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional continuation token and region.
+     * @returns A page of Shorts cards with a continuation token.
+     */
+    shorts(channelId: string, options?: YoutubeChannelTabParams): Promise<ChannelTabResponse>;
+    /**
+     * Get a page of a channel's live streams.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional continuation token and region.
+     * @returns A page of stream cards with a continuation token.
+     */
+    streams(channelId: string, options?: YoutubeChannelTabParams): Promise<ChannelTabResponse>;
+    /**
+     * Get a page of a channel's playlists.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional continuation token and region.
+     * @returns A page of playlist cards with a continuation token.
+     */
+    playlists(channelId: string, options?: YoutubeChannelTabParams): Promise<ChannelTabResponse>;
+    /**
+     * Get a page of a channel's community posts.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional continuation token and region.
+     * @returns A page of community posts with a continuation token.
+     */
+    community(channelId: string, options?: YoutubeChannelTabParams): Promise<CommunityResponse>;
+    /**
+     * Get a channel's lightweight about payload.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional region parameters.
+     * @returns The channel about payload.
+     */
+    about(channelId: string, options?: YoutubeChannelParams): Promise<ChannelAbout>;
+    /**
+     * Get a channel's subscriber count (fast).
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - Optional region parameters.
+     * @returns The subscriber count.
+     */
+    subscriberCount(channelId: string, options?: YoutubeChannelParams): Promise<SubscriberCount>;
+    /**
+     * Search within a single channel.
+     *
+     * @param channelId - The channel id, @handle, or custom URL.
+     * @param options - The required query plus optional continuation and region.
+     * @returns A page of search results scoped to the channel.
+     */
+    search(channelId: string, options: YoutubeChannelSearchParams): Promise<SearchResponse>;
+    /**
+     * Resolve a @handle or URL to canonical YouTube ids.
+     *
+     * @param options - A `handle` or `url` (one is required) plus optional region.
+     * @returns The resolved channel / video / playlist ids.
+     */
+    resolve(options?: YoutubeResolveParams): Promise<ResolveResult>;
+}
+
+/**
+ * YouTube Playlists API client.
+ *
+ * Provides methods for playlist detail, playlist items pagination, and mixes.
+ */
+
+/**
+ * Client for YouTube playlist and mix endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const playlist = await client.youtube.playlists.get("PL1234567890");
+ * console.log(`${playlist.title} — ${playlist.video_count} videos`);
+ *
+ * const page = await client.youtube.playlists.items("PL1234567890", {
+ *   continuation: playlist.continuation ?? undefined,
+ * });
+ *
+ * const mix = await client.youtube.playlists.mix("RDQM1234567890");
+ * ```
+ */
+declare class PlaylistsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get full playlist detail plus the first page of items.
+     *
+     * @param playlistId - The playlist id.
+     * @param options - Optional region parameters.
+     * @returns Full playlist detail with a continuation token.
+     * @throws NotFoundError - If the playlist doesn't exist.
+     */
+    get(playlistId: string, options?: YoutubePlaylistParams): Promise<Playlist>;
+    /**
+     * Get a continuation page of a playlist's items.
+     *
+     * @param playlistId - The playlist id.
+     * @param options - Optional continuation token and region.
+     * @returns A page of playlist items with a continuation token.
+     */
+    items(playlistId: string, options?: YoutubePlaylistItemsParams): Promise<PlaylistItemsResponse>;
+    /**
+     * Resolve an auto-generated mix / radio (RD…) queue.
+     *
+     * @param mixId - The mix / radio playlist id.
+     * @param options - Optional region parameters.
+     * @returns The mix as a playlist queue.
+     */
+    mix(mixId: string, options?: YoutubePlaylistParams): Promise<Playlist>;
+}
+
+/**
+ * YouTube Community API client.
+ *
+ * Provides methods for community post detail and post comments.
+ */
+
+/**
+ * Client for YouTube community post endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const post = await client.youtube.community.get("Ugkx1234567890");
+ * console.log(post.text);
+ *
+ * const comments = await client.youtube.community.comments("Ugkx1234567890");
+ * ```
+ */
+declare class CommunityClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a single community post's detail.
+     *
+     * @param postId - The community post id.
+     * @param options - Optional region parameters.
+     * @returns The community post.
+     * @throws NotFoundError - If the post doesn't exist.
+     */
+    get(postId: string, options?: YoutubePostParams): Promise<CommunityPost>;
+    /**
+     * Get a page of comments on a community post.
+     *
+     * @param postId - The community post id.
+     * @param options - Optional continuation token and region.
+     * @returns A page of comments with a continuation token.
+     */
+    comments(postId: string, options?: YoutubePostCommentsParams): Promise<CommentsResponse>;
+}
+
+/**
+ * YouTube Shorts API client.
+ *
+ * Provides methods for a single Short's detail and Shorts attributed to a sound.
+ */
+
+/**
+ * Client for YouTube Shorts endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const short = await client.youtube.shorts.get("abc123XYZ");
+ * console.log(`${short.title} — ${short.sound_title}`);
+ *
+ * const bySound = await client.youtube.shorts.bySound("sound-id-123");
+ * ```
+ */
+declare class ShortsClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a single Short's detail.
+     *
+     * @param videoId - The Short's video id.
+     * @param options - Optional region parameters.
+     * @returns The Short detail.
+     * @throws NotFoundError - If the Short doesn't exist or is unavailable.
+     */
+    get(videoId: string, options?: YoutubeShortParams): Promise<Short>;
+    /**
+     * Get a page of Shorts attributed to a given sound / music id (best-effort).
+     *
+     * @param soundId - The sound / music id.
+     * @param options - Optional continuation token and region.
+     * @returns A page of Shorts cards with a continuation token.
+     */
+    bySound(soundId: string, options?: YoutubeShortsBySoundParams): Promise<ChannelTabResponse>;
+}
+
+/**
+ * YouTube Trending API client.
+ *
+ * Provides methods for the trending feed, trending shorts, hashtag feed, and
+ * the guest home feed.
+ */
+
+/**
+ * Client for YouTube trending, hashtag, and home-feed endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const trending = await client.youtube.trending.get({ gl: "US", type: "music" });
+ * const shorts = await client.youtube.trending.shorts({ gl: "US" });
+ * const tagged = await client.youtube.trending.hashtag("minecraft");
+ * const home = await client.youtube.trending.home();
+ * ```
+ */
+declare class TrendingClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Get a page of the trending feed.
+     *
+     * @param options - Optional feed type, continuation token, and region.
+     * @returns A page of trending items with a continuation token.
+     */
+    get(options?: YoutubeTrendingParams): Promise<TrendingResponse>;
+    /**
+     * Get a page of trending Shorts.
+     *
+     * @param options - Optional continuation token and region.
+     * @returns A page of trending Shorts with a continuation token.
+     */
+    shorts(options?: YoutubeTrendingShortsParams): Promise<TrendingResponse>;
+    /**
+     * Get a page of videos under a hashtag.
+     *
+     * @param tag - The hashtag (with or without a leading `#`).
+     * @param options - Optional continuation token and region.
+     * @returns A page of hashtag results with a continuation token.
+     */
+    hashtag(tag: string, options?: YoutubeHashtagParams): Promise<HashtagResponse>;
+    /**
+     * Get a page of the guest home / recommendations feed (best-effort).
+     *
+     * @param options - Optional continuation token and region.
+     * @returns A page of home-feed results with a continuation token.
+     */
+    home(options?: YoutubeHomeParams): Promise<HomeResponse>;
+}
+
+/**
+ * YouTube Music API client.
+ *
+ * Provides a method for searching YouTube Music (WEB_REMIX client).
+ */
+
+/**
+ * Client for YouTube Music endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const results = await client.youtube.music.search({ query: "daft punk" });
+ * for (const r of results.results) {
+ *   console.log(r.title);
+ * }
+ * ```
+ */
+declare class MusicClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * Search YouTube Music (songs / albums / artists / playlists).
+     *
+     * @param params - The required query plus optional continuation and region.
+     * @returns A page of search results with a continuation token.
+     */
+    search(params: YoutubeMusicSearchParams): Promise<SearchResponse>;
+}
+
+/**
+ * YouTube Reference Data API client.
+ *
+ * Provides methods for the static categories, languages, regions, and the
+ * geo-targeted scraper market list (all zero-credit).
+ */
+
+/**
+ * Client for YouTube reference data endpoints.
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * const categories = await client.youtube.reference.categories({ gl: "US" });
+ * const languages = await client.youtube.reference.languages();
+ * const regions = await client.youtube.reference.regions();
+ * const markets = await client.youtube.reference.markets();
+ * ```
+ */
+declare class ReferenceClient {
+    private readonly client;
+    constructor(client: BaseClient);
+    /**
+     * List YouTube video categories (Data-API parity).
+     *
+     * @param options - Optional content region (default: "US").
+     * @returns The categories for the region.
+     */
+    categories(options?: YoutubeCategoriesParams): Promise<CategoriesResponse>;
+    /**
+     * List supported UI languages (hl codes).
+     *
+     * @returns The supported UI languages.
+     */
+    languages(): Promise<LanguagesResponse>;
+    /**
+     * List supported content regions (gl codes).
+     *
+     * @returns The supported content regions.
+     */
+    regions(): Promise<RegionsResponse>;
+    /**
+     * List the regions the scraper explicitly geo-targets (proxy-pinned).
+     *
+     * @returns The supported scraper markets.
+     */
+    markets(): Promise<MarketsResponse>;
+}
+
+/**
+ * YouTube API client.
+ *
+ * Provides access to all YouTube API endpoints through specialized sub-clients.
+ */
+
+/**
+ * YouTube API client with access to all YouTube endpoints.
+ *
+ * Provides sub-clients for different resource types:
+ * - `search` - Full-matrix search and keyword autocomplete
+ * - `videos` - Detail, related, comments, replies, transcript, captions, streams, live chat, batch, oEmbed
+ * - `channels` - Detail, tab feeds, about, subscriber count, in-channel search, resolve
+ * - `playlists` - Playlist detail, items pagination, mixes
+ * - `community` - Community post detail and post comments
+ * - `shorts` - Single Short detail and Shorts by sound
+ * - `trending` - Trending feed, trending shorts, hashtag feed, home feed
+ * - `music` - YouTube Music search
+ * - `reference` - Reference data (categories, languages, regions, markets)
+ *
+ * All list endpoints paginate via an opaque `continuation` token (no page
+ * numbers). Region is controlled by `gl` (content region) + `hl` (UI language).
+ *
+ * @example
+ * ```typescript
+ * const client = new ScrapeBadger({ apiKey: "key" });
+ *
+ * // Search
+ * const results = await client.youtube.search.search({ query: "lofi beats" });
+ *
+ * // Video detail
+ * const video = await client.youtube.videos.get("dQw4w9WgXcQ");
+ *
+ * // Channel detail (accepts a UC id, @handle, or custom URL)
+ * const channel = await client.youtube.channels.get("@MrBeast");
+ *
+ * // Playlist items
+ * const playlist = await client.youtube.playlists.get("PL1234567890");
+ *
+ * // Trending
+ * const trending = await client.youtube.trending.get({ gl: "US" });
+ *
+ * // Reference data
+ * const markets = await client.youtube.reference.markets();
+ * ```
+ */
+declare class YoutubeClient {
+    /** Client for full-matrix search and keyword autocomplete */
+    readonly search: SearchClient;
+    /** Client for video detail, comments, transcript, captions, streams, live chat, batch, and oEmbed */
+    readonly videos: VideosClient;
+    /** Client for channel detail, tab feeds, about, subscriber count, search, and resolve */
+    readonly channels: ChannelsClient;
+    /** Client for playlist detail, items pagination, and mixes */
+    readonly playlists: PlaylistsClient;
+    /** Client for community post detail and post comments */
+    readonly community: CommunityClient;
+    /** Client for single-Short detail and Shorts by sound */
+    readonly shorts: ShortsClient;
+    /** Client for the trending feed, trending shorts, hashtag feed, and home feed */
+    readonly trending: TrendingClient;
+    /** Client for YouTube Music search */
+    readonly music: MusicClient;
+    /** Client for reference data (categories, languages, regions, markets) */
+    readonly reference: ReferenceClient;
+    /**
+     * Create a new YouTube client.
+     *
+     * @param client - The base HTTP client for making requests.
+     */
+    constructor(client: BaseClient);
+}
+
 /**
  * Main ScrapeBadger client.
  *
@@ -6040,6 +8279,10 @@ declare class ScrapeBadger {
     readonly shopee: ShopeeClient;
     /** TikTok scraper API client — 26 endpoints */
     readonly tiktok: TikTokClient;
+    /** eBay scraper API client — 12 endpoints across 18 markets */
+    readonly ebay: EbayClient;
+    /** YouTube scraper API client — 39 endpoints */
+    readonly youtube: YoutubeClient;
     /**
      * Create a new ScrapeBadger client.
      *
@@ -6068,4 +8311,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$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 };
+export { type AiListItem, type AiModeResponse, type AiModeSearchParams, type AiReference, type AiTableRow, type AiTextBlock, type AmazonAutocompleteParams, type AutocompleteResponse$2 as AmazonAutocompleteResponse, type AutocompleteSuggestion$1 as AmazonAutocompleteSuggestion, type Bestseller as AmazonBestseller, type BestsellersRankEntry as AmazonBestsellersRankEntry, type BestsellersResponse as AmazonBestsellersResponse, type Buybox as AmazonBuybox, type CategoriesResponse$2 as AmazonCategoriesResponse, type CategoryInfo$1 as AmazonCategoryInfo, type AmazonCategoryParams, type CategoryResponse$1 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$2 as AmazonMarketInfo, type MarketsResponse$3 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$1 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$4 as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review$1 as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse$1 as AmazonReviewsResponse, SearchClient$4 as AmazonSearchClient, type AmazonSearchParams, type SearchResponse$2 as AmazonSearchResponse, type SearchResult$3 as AmazonSearchResult, type Seller$1 as AmazonSeller, type SellerFeedbackEntry as AmazonSellerFeedbackEntry, type SellerFeedbackResponse$1 as AmazonSellerFeedbackResponse, type SellerFeedbackSummary as AmazonSellerFeedbackSummary, type AmazonSellerListParams, type AmazonSellerParams, type SellerProductsResponse as AmazonSellerProductsResponse, type SellerProfileResponse$1 as AmazonSellerProfileResponse, SellersClient$1 as AmazonSellersClient, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type EbayAutocompleteParams, type AutocompleteResponse$1 as EbayAutocompleteResponse, type AutocompleteSuggestion as EbayAutocompleteSuggestion, type EbayBuyingFormat, CategoriesClient as EbayCategoriesClient, type CategoriesResponse$1 as EbayCategoriesResponse, type CategoryInfo as EbayCategoryInfo, type EbayCategoryParams, type CategoryResponse as EbayCategoryResponse, EbayClient, type EbayCompletedParams, type EbayCondition, type FeedbackBreakdown as EbayFeedbackBreakdown, type FeedbackEntry as EbayFeedbackEntry, type Image as EbayImage, type Item as EbayItem, type ItemDetailResponse as EbayItemDetailResponse, type EbayItemParams, type ItemSeller as EbayItemSeller, ItemsClient as EbayItemsClient, type MarketInfo$1 as EbayMarketInfo, type MarketsResponse$1 as EbayMarketsResponse, type Pagination as EbayPagination, type EbayPrice, type RatingHistogram as EbayRatingHistogram, ReferenceClient$1 as EbayReferenceClient, type ReturnsPolicy as EbayReturnsPolicy, type Review as EbayReview, type EbayReviewsParams, type ReviewsResponse as EbayReviewsResponse, SearchClient$1 as EbaySearchClient, type EbaySearchParams, type SearchResponse$1 as EbaySearchResponse, type SearchResult$1 as EbaySearchResult, type Seller as EbaySeller, type EbaySellerFeedbackParams, type SellerFeedbackResponse as EbaySellerFeedbackResponse, type EbaySellerItemsParams, type SellerItemsResponse as EbaySellerItemsResponse, type EbaySellerParams, type SellerProfileResponse as EbaySellerProfileResponse, SellersClient as EbaySellersClient, type ShippingOption as EbayShippingOption, type EbaySortBy, 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$6 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient$1 as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient$2 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$5 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$2 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$3 as ShopeeReferenceClient, type ShopeeReview, type ReviewReply as ShopeeReviewReply, type ReviewSummary as ShopeeReviewSummary, ReviewsClient as ShopeeReviewsClient, type ShopeeReviewsParams, type ReviewsResult as ShopeeReviewsResult, SearchClient$3 as ShopeeSearchClient, type ShopeeSearchParams, type SearchResult$2 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$1 as TikTokHashtagResponse, type HashtagSearchResponse as TikTokHashtagSearchResponse, HashtagsClient as TikTokHashtagsClient, type TikTokListVideosParams, type TikTokMusic, MusicClient$1 as TikTokMusicClient, type TikTokMusicParams, type MusicResponse as TikTokMusicResponse, type TikTokOEmbed, type TikTokOEmbedParams, type ProfileResponse as TikTokProfileResponse, ReferenceClient$2 as TikTokReferenceClient, type RegionInfo as TikTokRegionInfo, type RegionsResponse$1 as TikTokRegionsResponse, type TikTokRelatedParams, SearchClient$2 as TikTokSearchClient, type TikTokSearchParams, type TikTokStats, type TikTokSubtitle, type TikTokTextExtra, type TikTokTranscriptParams, type TranscriptResponse as TikTokTranscriptResponse, TrendingClient$1 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$1 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$1 as VintedItemDetailResponse, type VintedItemSummary, ItemsClient$1 as VintedItemsClient, type VintedMarket, type MarketsResponse$4 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$5 as VintedReferenceClient, SearchClient$7 as VintedSearchClient, type VintedSearchParams, type SearchResponse$3 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, type AudioTrack as YoutubeAudioTrack, type YoutubeAutocompleteParams, type AutocompleteResponse as YoutubeAutocompleteResponse, type YoutubeBatchParams, type BatchResponse as YoutubeBatchResponse, type CaptionTrack as YoutubeCaptionTrack, type YoutubeCaptionsParams, type CaptionsResponse as YoutubeCaptionsResponse, type YoutubeCategoriesParams, type CategoriesResponse as YoutubeCategoriesResponse, type Channel as YoutubeChannel, type ChannelAbout as YoutubeChannelAbout, type ChannelLink as YoutubeChannelLink, type YoutubeChannelParams, type YoutubeChannelSearchParams, type YoutubeChannelTabParams, type ChannelTabResponse as YoutubeChannelTabResponse, type ChannelVideosResponse as YoutubeChannelVideosResponse, ChannelsClient as YoutubeChannelsClient, type Chapter as YoutubeChapter, YoutubeClient, type Comment as YoutubeComment, type YoutubeCommentSort, type YoutubeCommentsParams, type CommentsResponse as YoutubeCommentsResponse, CommunityClient as YoutubeCommunityClient, type CommunityPost as YoutubeCommunityPost, type CommunityResponse as YoutubeCommunityResponse, type YoutubeDuration, type Format as YoutubeFormat, type YoutubeHashtagParams, type HashtagResponse as YoutubeHashtagResponse, type HeatMarker as YoutubeHeatMarker, type YoutubeHomeParams, type HomeResponse as YoutubeHomeResponse, type LanguagesResponse as YoutubeLanguagesResponse, type LiveChatMessage as YoutubeLiveChatMessage, type YoutubeLiveChatParams, type LiveChatResponse as YoutubeLiveChatResponse, type LiveStreamingDetails as YoutubeLiveStreamingDetails, type MarketInfo as YoutubeMarketInfo, type MarketsResponse as YoutubeMarketsResponse, MusicClient as YoutubeMusicClient, type YoutubeMusicSearchParams, type OEmbed as YoutubeOEmbed, type YoutubeOEmbedParams, type Playlist as YoutubePlaylist, type PlaylistItem as YoutubePlaylistItem, type YoutubePlaylistItemsParams, type PlaylistItemsResponse as YoutubePlaylistItemsResponse, type YoutubePlaylistParams, PlaylistsClient as YoutubePlaylistsClient, type PollChoice as YoutubePollChoice, type YoutubePostCommentsParams, type YoutubePostParams, ReferenceClient as YoutubeReferenceClient, type ReferenceRow as YoutubeReferenceRow, type YoutubeRegionParams, type RegionRestriction as YoutubeRegionRestriction, type RegionsResponse as YoutubeRegionsResponse, type YoutubeRelatedParams, type RelatedResponse as YoutubeRelatedResponse, type YoutubeRepliesParams, type RepliesResponse as YoutubeRepliesResponse, type YoutubeResolveParams, type ResolveResult as YoutubeResolveResult, type SearchChip as YoutubeSearchChip, SearchClient as YoutubeSearchClient, type YoutubeSearchParams, type SearchResponse as YoutubeSearchResponse, type SearchResult as YoutubeSearchResult, type YoutubeSearchSort, type YoutubeSearchType, type ShoppingResult as YoutubeShoppingResult, type Short as YoutubeShort, type YoutubeShortParams, type YoutubeShortsBySoundParams, ShortsClient as YoutubeShortsClient, type StreamingData as YoutubeStreamingData, type YoutubeStreamsClient, type YoutubeStreamsParams, type SubscriberCount as YoutubeSubscriberCount, type Thumbnail as YoutubeThumbnail, type Transcript as YoutubeTranscript, type YoutubeTranscriptParams, type TranscriptSegment as YoutubeTranscriptSegment, TrendingClient as YoutubeTrendingClient, type TrendingItem as YoutubeTrendingItem, type YoutubeTrendingParams, type TrendingResponse as YoutubeTrendingResponse, type YoutubeTrendingShortsParams, type YoutubeTrendingType, type YoutubeUploadDate, type Video as YoutubeVideo, type YoutubeVideoParams, VideosClient as YoutubeVideosClient };