scrapebadger 0.15.0 → 0.15.2

package/dist/index.d.ts

@@ -411,7 +411,7 @@ interface VintedPagination {
 /**
  * Response from the search endpoint.
  */
-interface SearchResponse$2 {
+interface SearchResponse$3 {
     /** List of matching items */
     items: VintedItemSummary[];
     /** Pagination metadata */
@@ -479,7 +479,7 @@ interface StatusesResponse {
 /**
  * Response from the markets endpoint.
  */
-interface MarketsResponse$3 {
+interface MarketsResponse$4 {
     /** List of available markets */
     markets: VintedMarket[];
 }
@@ -550,7 +550,7 @@ interface VintedSearchParams {
  * });
  * ```
  */
-declare class SearchClient$6 {
+declare class SearchClient$7 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -586,7 +586,7 @@ declare class SearchClient$6 {
      * }
      * ```
      */
-    search(params: VintedSearchParams): Promise<SearchResponse$2>;
+    search(params: VintedSearchParams): Promise<SearchResponse$3>;
 }
 
 /**
@@ -741,7 +741,7 @@ declare class UsersClient$2 {
  * }
  * ```
  */
-declare class ReferenceClient$4 {
+declare class ReferenceClient$5 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -819,7 +819,7 @@ declare class ReferenceClient$4 {
      * }
      * ```
      */
-    markets(): Promise<MarketsResponse$3>;
+    markets(): Promise<MarketsResponse$4>;
 }
 
 /**
@@ -856,13 +856,13 @@ declare class ReferenceClient$4 {
  */
 declare class VintedClient {
     /** Client for item search operations */
-    readonly search: SearchClient$6;
+    readonly search: SearchClient$7;
     /** Client for individual item operations */
     readonly items: ItemsClient$1;
     /** Client for user operations */
     readonly users: UsersClient$2;
     /** Client for reference data (brands, colors, statuses, markets) */
-    readonly reference: ReferenceClient$4;
+    readonly reference: ReferenceClient$5;
     /**
      * Create a new Vinted client.
      *
@@ -1848,7 +1848,7 @@ declare class ScholarClient {
  * }
  * ```
  */
-declare class SearchClient$5 {
+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$5;
+    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$4 {
+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$4;
+    readonly search: SearchClient$5;
     /** Client for post operations (trending, details, comments, duplicates) */
     readonly posts: PostsClient;
     /** Client for subreddit operations (details, posts, rules, moderators, wiki) */
@@ -3534,7 +3534,7 @@ interface Pagination$1 {
 /**
  * A single supported marketplace (for /markets).
  */
-interface MarketInfo$1 {
+interface MarketInfo$2 {
     /** Market code (e.g. "US", "UK", "DE") */
     code: string;
     /** Amazon domain suffix (e.g. "com", "co.uk") */
@@ -3700,7 +3700,7 @@ interface Product {
 /**
  * A single search / category-browse result row.
  */
-interface SearchResult$2 {
+interface SearchResult$3 {
     position: number;
     asin: string;
     title: string | null;
@@ -3880,10 +3880,10 @@ interface AutocompleteSuggestion$1 {
     alias: string | null;
 }
 /** Response from the /search endpoint. */
-interface SearchResponse$1 {
+interface SearchResponse$2 {
     query: string;
     domain: string;
-    results: SearchResult$2[];
+    results: SearchResult$3[];
     pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3946,7 +3946,7 @@ interface DealsResponse {
 interface CategoryResponse$1 {
     domain: string;
     node: string;
-    results: SearchResult$2[];
+    results: SearchResult$3[];
     pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3960,7 +3960,7 @@ interface SellerProfileResponse$1 {
 interface SellerProductsResponse {
     domain: string;
     seller_id: string;
-    products: SearchResult$2[];
+    products: SearchResult$3[];
     pagination: Pagination$1;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -3975,17 +3975,17 @@ interface SellerFeedbackResponse$1 {
     scraped_at: string | null;
 }
 /** Response from the /autocomplete endpoint. */
-interface AutocompleteResponse$1 {
+interface AutocompleteResponse$2 {
     query: string;
     domain: string;
     suggestions: AutocompleteSuggestion$1[];
 }
 /** Response from the /markets endpoint. */
-interface MarketsResponse$2 {
-    markets: MarketInfo$1[];
+interface MarketsResponse$3 {
+    markets: MarketInfo$2[];
 }
 /** Response from the /categories endpoint. */
-interface CategoriesResponse$1 {
+interface CategoriesResponse$2 {
     categories: CategoryInfo$1[];
 }
 /** Parameters for searching Amazon products. */
@@ -4108,7 +4108,7 @@ interface AmazonAutocompleteParams {
  * const suggestions = await client.amazon.search.autocomplete("lapt");
  * ```
  */
-declare class SearchClient$3 {
+declare class SearchClient$4 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4119,7 +4119,7 @@ declare class SearchClient$3 {
      * @throws AuthenticationError - If the API key is invalid.
      * @throws ValidationError - If the parameters are invalid.
      */
-    search(params: AmazonSearchParams): Promise<SearchResponse$1>;
+    search(params: AmazonSearchParams): Promise<SearchResponse$2>;
     /**
      * Get Amazon keyword autocomplete suggestions.
      *
@@ -4127,7 +4127,7 @@ declare class SearchClient$3 {
      * @param options - Optional parameters (domain).
      * @returns Autocomplete suggestions.
      */
-    autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse$1>;
+    autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse$2>;
 }
 
 /**
@@ -4304,7 +4304,7 @@ declare class SellersClient$1 {
  * const categories = await client.amazon.reference.categories();
  * ```
  */
-declare class ReferenceClient$3 {
+declare class ReferenceClient$4 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4312,13 +4312,13 @@ declare class ReferenceClient$3 {
      *
      * @returns Markets response with all supported marketplaces.
      */
-    markets(): Promise<MarketsResponse$2>;
+    markets(): Promise<MarketsResponse$3>;
     /**
      * Get the reference department / category aliases.
      *
      * @returns Categories response with all category aliases.
      */
-    categories(): Promise<CategoriesResponse$1>;
+    categories(): Promise<CategoriesResponse$2>;
 }
 
 /**
@@ -4359,7 +4359,7 @@ declare class ReferenceClient$3 {
  */
 declare class AmazonClient {
     /** Client for keyword search and autocomplete */
-    readonly search: SearchClient$3;
+    readonly search: SearchClient$4;
     /** Client for product detail, offers, and reviews */
     readonly products: ProductsClient$1;
     /** Client for bestsellers, new releases, deals, and category browse */
@@ -4367,7 +4367,7 @@ declare class AmazonClient {
     /** Client for seller profile, products, and feedback */
     readonly sellers: SellersClient$1;
     /** Client for reference data (markets, categories) */
-    readonly reference: ReferenceClient$3;
+    readonly reference: ReferenceClient$4;
     /**
      * Create a new Amazon client.
      *
@@ -4476,7 +4476,7 @@ interface ShopeeProduct {
 /**
  * A page of search/category results.
  */
-interface SearchResult$1 {
+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$1 {
+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$2 {
+declare class SearchClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4670,7 +4670,7 @@ declare class SearchClient$2 {
      * @throws AuthenticationError - If the API key is invalid.
      * @throws ValidationError - If the parameters are invalid.
      */
-    search(params: ShopeeSearchParams): Promise<SearchResult$1>;
+    search(params: ShopeeSearchParams): Promise<SearchResult$2>;
     /**
      * List products within a specific Shopee category.
      *
@@ -4680,7 +4680,7 @@ declare class SearchClient$2 {
      * @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$1>;
+    categoryItems(categoryId: number, options?: ShopeeCategoryItemsParams): Promise<SearchResult$2>;
 }
 
 /**
@@ -4782,7 +4782,7 @@ declare class ReviewsClient {
  * }
  * ```
  */
-declare class ReferenceClient$2 {
+declare class ReferenceClient$3 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -4790,7 +4790,7 @@ declare class ReferenceClient$2 {
      *
      * @returns Markets response with all supported Shopee markets (0 credits).
      */
-    markets(): Promise<MarketsResponse$1>;
+    markets(): Promise<MarketsResponse$2>;
     /**
      * Get the full category tree for a Shopee market.
      *
@@ -4842,13 +4842,13 @@ declare class ReferenceClient$2 {
  */
 declare class ShopeeClient {
     /** Client for keyword search and category-item listing */
-    readonly search: SearchClient$2;
+    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$2;
+    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$1 {
+declare class SearchClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5744,7 +5744,7 @@ declare class SearchClient$1 {
  * 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$1 {
+declare class ReferenceClient$2 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -5908,7 +5908,7 @@ declare class ReferenceClient$1 {
      *
      * @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$1;
+    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$1;
+    readonly reference: ReferenceClient$2;
     /**
      * Create a new TikTok client.
      *
@@ -6021,7 +6021,7 @@ interface Pagination {
 /**
  * A single supported marketplace (for /markets).
  */
-interface MarketInfo {
+interface MarketInfo$1 {
     /** Market code (e.g. "US", "GB", "DE") */
     code: string;
     /** eBay domain suffix (e.g. "com", "co.uk") */
@@ -6069,7 +6069,7 @@ interface ShippingOption {
 /**
  * One eBay search/listing card (search, seller items, category, sold).
  */
-interface SearchResult {
+interface SearchResult$1 {
     position: number;
     item_id: string | null;
     product_id: string | null;
@@ -6087,6 +6087,8 @@ interface SearchResult {
     is_auction: boolean;
     bids: number | null;
     time_left: string | null;
+    /** Auctions: the current high bid (mirrors `price`); null for non-auctions */
+    current_bid: EbayPrice | null;
     shipping: string | null;
     shipping_cost: EbayPrice | null;
     free_shipping: boolean | null;
@@ -6151,6 +6153,14 @@ interface Item {
     is_auction: boolean;
     bids: number | null;
     time_left: string | null;
+    /** Auctions: the current high bid (mirrors `price`); null for non-auctions */
+    current_bid: EbayPrice | null;
+    /** Absolute auction end time, Unix timestamp (float seconds); null for non-auctions */
+    end_time_utc: number | null;
+    /** Absolute auction end time, ISO-8601 Z string; null for non-auctions */
+    end_time_at: string | null;
+    /** BIN price: fixed-price listings (== price) or auction-with-Buy-It-Now; null for pure auctions */
+    buy_it_now_price: EbayPrice | null;
     best_offer_enabled: boolean | null;
     brand: string | null;
     mpn: string | null;
@@ -6249,12 +6259,12 @@ interface AutocompleteSuggestion {
     value: string;
 }
 /** Response from the /search and /completed endpoints. */
-interface SearchResponse {
+interface SearchResponse$1 {
     query: string | null;
     domain: string;
     category_id: string | null;
     sold: boolean;
-    results: SearchResult[];
+    results: SearchResult$1[];
     facets: Record<string, string[]>;
     pagination: Pagination;
     scraped_utc: number | null;
@@ -6274,7 +6284,7 @@ interface SellerProfileResponse {
 interface SellerItemsResponse {
     domain: string;
     username: string;
-    results: SearchResult[];
+    results: SearchResult$1[];
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
@@ -6305,24 +6315,24 @@ interface ReviewsResponse {
 interface CategoryResponse {
     domain: string;
     category_id: string;
-    results: SearchResult[];
+    results: SearchResult$1[];
     facets: Record<string, string[]>;
     pagination: Pagination;
     scraped_utc: number | null;
     scraped_at: string | null;
 }
 /** Response from the /autocomplete endpoint. */
-interface AutocompleteResponse {
+interface AutocompleteResponse$1 {
     query: string;
     domain: string;
     suggestions: AutocompleteSuggestion[];
 }
 /** Response from the /markets endpoint. */
-interface MarketsResponse {
-    markets: MarketInfo[];
+interface MarketsResponse$1 {
+    markets: MarketInfo$1[];
 }
 /** Response from the /categories endpoint. */
-interface CategoriesResponse {
+interface CategoriesResponse$1 {
     categories: CategoryInfo[];
 }
 /** Sort order for search / listing endpoints. */
@@ -6459,7 +6469,7 @@ interface EbayAutocompleteParams {
  * const suggestions = await client.ebay.search.autocomplete("ipho");
  * ```
  */
-declare class SearchClient {
+declare class SearchClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -6470,14 +6480,14 @@ declare class SearchClient {
      * @throws AuthenticationError - If the API key is invalid.
      * @throws ValidationError - If the parameters are invalid.
      */
-    search(params: EbaySearchParams): Promise<SearchResponse>;
+    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>;
+    completed(params: EbayCompletedParams): Promise<SearchResponse$1>;
     /**
      * Get eBay keyword autocomplete suggestions.
      *
@@ -6485,7 +6495,7 @@ declare class SearchClient {
      * @param options - Optional parameters (domain).
      * @returns Autocomplete suggestions.
      */
-    autocomplete(query: string, options?: EbayAutocompleteParams): Promise<AutocompleteResponse>;
+    autocomplete(query: string, options?: EbayAutocompleteParams): Promise<AutocompleteResponse$1>;
 }
 
 /**
@@ -6618,7 +6628,7 @@ declare class CategoriesClient {
      *
      * @returns Categories response with all category aliases.
      */
-    list(): Promise<CategoriesResponse>;
+    list(): Promise<CategoriesResponse$1>;
 }
 
 /**
@@ -6640,7 +6650,7 @@ declare class CategoriesClient {
  * }
  * ```
  */
-declare class ReferenceClient {
+declare class ReferenceClient$1 {
     private readonly client;
     constructor(client: BaseClient);
     /**
@@ -6648,7 +6658,7 @@ declare class ReferenceClient {
      *
      * @returns Markets response with all supported marketplaces.
      */
-    markets(): Promise<MarketsResponse>;
+    markets(): Promise<MarketsResponse$1>;
 }
 
 /**
@@ -6695,7 +6705,7 @@ declare class ReferenceClient {
  */
 declare class EbayClient {
     /** Client for active search, completed/sold search, and autocomplete */
-    readonly search: SearchClient;
+    readonly search: SearchClient$1;
     /** Client for item detail and catalog product reviews */
     readonly items: ItemsClient;
     /** Client for seller profile, items, and feedback */
@@ -6703,7 +6713,7 @@ declare class EbayClient {
     /** Client for category browse and the reference category list */
     readonly categories: CategoriesClient;
     /** Client for reference data (markets) */
-    readonly reference: ReferenceClient;
+    readonly reference: ReferenceClient$1;
     /**
      * Create a new eBay client.
      *
@@ -6712,6 +6722,1517 @@ declare class EbayClient {
     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.
  *
@@ -6770,6 +8291,8 @@ declare class ScrapeBadger {
     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.
      *
@@ -6798,4 +8321,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$1 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$1 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$1 as AmazonMarketInfo, type MarketsResponse$2 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$3 as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review$1 as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse$1 as AmazonReviewsResponse, SearchClient$3 as AmazonSearchClient, type AmazonSearchParams, type SearchResponse$1 as AmazonSearchResponse, type SearchResult$2 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 as EbayAutocompleteResponse, type AutocompleteSuggestion as EbayAutocompleteSuggestion, type EbayBuyingFormat, CategoriesClient as EbayCategoriesClient, type CategoriesResponse 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 as EbayMarketInfo, type MarketsResponse as EbayMarketsResponse, type Pagination as EbayPagination, type EbayPrice, type RatingHistogram as EbayRatingHistogram, ReferenceClient as EbayReferenceClient, type ReturnsPolicy as EbayReturnsPolicy, type Review as EbayReview, type EbayReviewsParams, type ReviewsResponse as EbayReviewsResponse, SearchClient as EbaySearchClient, type EbaySearchParams, type SearchResponse as EbaySearchResponse, type SearchResult 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$5 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$4 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$1 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$2 as ShopeeReferenceClient, type ShopeeReview, type ReviewReply as ShopeeReviewReply, type ReviewSummary as ShopeeReviewSummary, ReviewsClient as ShopeeReviewsClient, type ShopeeReviewsParams, type ReviewsResult as ShopeeReviewsResult, SearchClient$2 as ShopeeSearchClient, type ShopeeSearchParams, type SearchResult$1 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$1 as TikTokReferenceClient, type RegionInfo as TikTokRegionInfo, type RegionsResponse as TikTokRegionsResponse, type TikTokRelatedParams, SearchClient$1 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$1 as VintedItemDetailResponse, type VintedItemSummary, ItemsClient$1 as VintedItemsClient, type VintedMarket, type MarketsResponse$3 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$4 as VintedReferenceClient, SearchClient$6 as VintedSearchClient, type VintedSearchParams, type SearchResponse$2 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 };