scrapebadger 0.13.1 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -257,6 +257,11 @@ interface VintedItemSummary {
257
257
  photo: VintedPhoto;
258
258
  /** All photos */
259
259
  photos: VintedPhoto[];
260
+ /**
261
+ * Physical country of the seller as an upper-case ISO-2 code (e.g. "FR"),
262
+ * or null. Populated only when the `seller_country` search filter is used.
263
+ */
264
+ seller_country_code: string | null;
260
265
  }
261
266
  /**
262
267
  * Full item detail with all metadata.
@@ -406,18 +411,23 @@ interface VintedPagination {
406
411
  /**
407
412
  * Response from the search endpoint.
408
413
  */
409
- interface SearchResponse$1 {
414
+ interface SearchResponse$2 {
410
415
  /** List of matching items */
411
416
  items: VintedItemSummary[];
412
417
  /** Pagination metadata */
413
418
  pagination: VintedPagination;
414
419
  /** Market code used for this search */
415
420
  market: string;
421
+ /**
422
+ * Echo of the normalized `seller_country` filter applied to this search
423
+ * (comma-separated ISO-2 codes, e.g. "fr,be"), or null when no filter was used.
424
+ */
425
+ seller_country: string | null;
416
426
  }
417
427
  /**
418
428
  * Response from the item detail endpoint.
419
429
  */
420
- interface ItemDetailResponse {
430
+ interface ItemDetailResponse$1 {
421
431
  /** Full item details */
422
432
  item: VintedItemDetail;
423
433
  /** Market code used */
@@ -469,7 +479,7 @@ interface StatusesResponse {
469
479
  /**
470
480
  * Response from the markets endpoint.
471
481
  */
472
- interface MarketsResponse$2 {
482
+ interface MarketsResponse$3 {
473
483
  /** List of available markets */
474
484
  markets: VintedMarket[];
475
485
  }
@@ -497,6 +507,18 @@ interface VintedSearchParams {
497
507
  status_ids?: string;
498
508
  /** Sort order */
499
509
  order?: "relevance" | "newest_first" | "price_low_to_high" | "price_high_to_low";
510
+ /**
511
+ * Filter results to items whose seller is physically located in one of the
512
+ * given countries. A comma-separated list of ISO-2 country codes (e.g. "fr"
513
+ * or "fr,be"). Vinted federates cross-border EU listings into each market
514
+ * domain and has no native country filter, so this is applied by ScrapeBadger.
515
+ *
516
+ * When set, each returned item gains a `seller_country_code` and the response
517
+ * gains a top-level `seller_country` echo.
518
+ *
519
+ * Billing: 1 base credit + 1 credit per uncached seller looked up.
520
+ */
521
+ seller_country?: string;
500
522
  }
501
523
 
502
524
  /**
@@ -528,7 +550,7 @@ interface VintedSearchParams {
528
550
  * });
529
551
  * ```
530
552
  */
531
- declare class SearchClient$5 {
553
+ declare class SearchClient$6 {
532
554
  private readonly client;
533
555
  constructor(client: BaseClient);
534
556
  /**
@@ -550,8 +572,21 @@ declare class SearchClient$5 {
550
572
  * });
551
573
  * console.log(`Found ${results.pagination.total_entries} items`);
552
574
  * ```
575
+ *
576
+ * @example
577
+ * ```typescript
578
+ * // Filter results to sellers physically located in France or Belgium.
579
+ * // Billing: 1 base credit + 1 credit per uncached seller looked up.
580
+ * const local = await client.vinted.search.search({
581
+ * query: "vintage jacket",
582
+ * seller_country: "fr,be",
583
+ * });
584
+ * for (const item of local.items) {
585
+ * console.log(`${item.title} — seller in ${item.seller_country_code}`);
586
+ * }
587
+ * ```
553
588
  */
554
- search(params: VintedSearchParams): Promise<SearchResponse$1>;
589
+ search(params: VintedSearchParams): Promise<SearchResponse$2>;
555
590
  }
556
591
 
557
592
  /**
@@ -572,7 +607,7 @@ declare class SearchClient$5 {
572
607
  * console.log(`Seller: ${item.item.seller.login}`);
573
608
  * ```
574
609
  */
575
- declare class ItemsClient {
610
+ declare class ItemsClient$1 {
576
611
  private readonly client;
577
612
  constructor(client: BaseClient);
578
613
  /**
@@ -596,7 +631,7 @@ declare class ItemsClient {
596
631
  */
597
632
  get(itemId: number, options?: {
598
633
  market?: string;
599
- }): Promise<ItemDetailResponse>;
634
+ }): Promise<ItemDetailResponse$1>;
600
635
  }
601
636
 
602
637
  /**
@@ -706,7 +741,7 @@ declare class UsersClient$2 {
706
741
  * }
707
742
  * ```
708
743
  */
709
- declare class ReferenceClient$3 {
744
+ declare class ReferenceClient$4 {
710
745
  private readonly client;
711
746
  constructor(client: BaseClient);
712
747
  /**
@@ -784,7 +819,7 @@ declare class ReferenceClient$3 {
784
819
  * }
785
820
  * ```
786
821
  */
787
- markets(): Promise<MarketsResponse$2>;
822
+ markets(): Promise<MarketsResponse$3>;
788
823
  }
789
824
 
790
825
  /**
@@ -821,13 +856,13 @@ declare class ReferenceClient$3 {
821
856
  */
822
857
  declare class VintedClient {
823
858
  /** Client for item search operations */
824
- readonly search: SearchClient$5;
859
+ readonly search: SearchClient$6;
825
860
  /** Client for individual item operations */
826
- readonly items: ItemsClient;
861
+ readonly items: ItemsClient$1;
827
862
  /** Client for user operations */
828
863
  readonly users: UsersClient$2;
829
864
  /** Client for reference data (brands, colors, statuses, markets) */
830
- readonly reference: ReferenceClient$3;
865
+ readonly reference: ReferenceClient$4;
831
866
  /**
832
867
  * Create a new Vinted client.
833
868
  *
@@ -1813,7 +1848,7 @@ declare class ScholarClient {
1813
1848
  * }
1814
1849
  * ```
1815
1850
  */
1816
- declare class SearchClient$4 {
1851
+ declare class SearchClient$5 {
1817
1852
  private readonly client;
1818
1853
  constructor(client: BaseClient);
1819
1854
  /**
@@ -2009,7 +2044,7 @@ declare class VideosClient$1 {
2009
2044
  */
2010
2045
  declare class GoogleClient {
2011
2046
  /** Google Web Search (SERP) — with optional deferred AI Overview follow-up. */
2012
- readonly search: SearchClient$4;
2047
+ readonly search: SearchClient$5;
2013
2048
  /** Google Maps — places, reviews, photos, posts. */
2014
2049
  readonly maps: MapsClient;
2015
2050
  /** Google News — articles, topics, trending. */
@@ -2840,7 +2875,7 @@ interface DomainPostsResponse {
2840
2875
  * const domainPosts = await client.reddit.search.domainPosts({ domain: "github.com" });
2841
2876
  * ```
2842
2877
  */
2843
- declare class SearchClient$3 {
2878
+ declare class SearchClient$4 {
2844
2879
  private readonly client;
2845
2880
  constructor(client: BaseClient);
2846
2881
  /**
@@ -3449,7 +3484,7 @@ declare class UsersClient$1 {
3449
3484
  */
3450
3485
  declare class RedditClient {
3451
3486
  /** Client for search operations (posts, subreddits, users, domain posts) */
3452
- readonly search: SearchClient$3;
3487
+ readonly search: SearchClient$4;
3453
3488
  /** Client for post operations (trending, details, comments, duplicates) */
3454
3489
  readonly posts: PostsClient;
3455
3490
  /** Client for subreddit operations (details, posts, rules, moderators, wiki) */
@@ -3488,7 +3523,7 @@ interface AmazonPrice {
3488
3523
  /**
3489
3524
  * Page-number pagination (Amazon listings use 1-based page numbers).
3490
3525
  */
3491
- interface Pagination {
3526
+ interface Pagination$1 {
3492
3527
  /** Current page number (1-indexed) */
3493
3528
  current_page: number;
3494
3529
  /** Total number of pages, if known */
@@ -3499,7 +3534,7 @@ interface Pagination {
3499
3534
  /**
3500
3535
  * A single supported marketplace (for /markets).
3501
3536
  */
3502
- interface MarketInfo {
3537
+ interface MarketInfo$1 {
3503
3538
  /** Market code (e.g. "US", "UK", "DE") */
3504
3539
  code: string;
3505
3540
  /** Amazon domain suffix (e.g. "com", "co.uk") */
@@ -3516,7 +3551,7 @@ interface MarketInfo {
3516
3551
  /**
3517
3552
  * A reference category / department alias (for /categories).
3518
3553
  */
3519
- interface CategoryInfo {
3554
+ interface CategoryInfo$1 {
3520
3555
  /** Category display name */
3521
3556
  name: string;
3522
3557
  /** Category alias */
@@ -3658,14 +3693,14 @@ interface Product {
3658
3693
  also_bought: RelatedProduct[];
3659
3694
  answered_questions: number | null;
3660
3695
  /** The product page's embedded featured reviews (max 8). */
3661
- top_reviews: Review[];
3696
+ top_reviews: Review$1[];
3662
3697
  scraped_utc: number | null;
3663
3698
  scraped_at: string | null;
3664
3699
  }
3665
3700
  /**
3666
3701
  * A single search / category-browse result row.
3667
3702
  */
3668
- interface SearchResult$1 {
3703
+ interface SearchResult$2 {
3669
3704
  position: number;
3670
3705
  asin: string;
3671
3706
  title: string | null;
@@ -3738,7 +3773,7 @@ interface ReviewProfile {
3738
3773
  /**
3739
3774
  * A single product review.
3740
3775
  */
3741
- interface Review {
3776
+ interface Review$1 {
3742
3777
  id: string | null;
3743
3778
  title: string | null;
3744
3779
  body: string | null;
@@ -3814,7 +3849,7 @@ interface SellerFeedbackSummary {
3814
3849
  /**
3815
3850
  * A seller profile.
3816
3851
  */
3817
- interface Seller {
3852
+ interface Seller$1 {
3818
3853
  seller_id: string;
3819
3854
  name: string | null;
3820
3855
  link: string | null;
@@ -3840,16 +3875,16 @@ interface SellerFeedbackEntry {
3840
3875
  /**
3841
3876
  * A single keyword suggestion.
3842
3877
  */
3843
- interface AutocompleteSuggestion {
3878
+ interface AutocompleteSuggestion$1 {
3844
3879
  value: string;
3845
3880
  alias: string | null;
3846
3881
  }
3847
3882
  /** Response from the /search endpoint. */
3848
- interface SearchResponse {
3883
+ interface SearchResponse$1 {
3849
3884
  query: string;
3850
3885
  domain: string;
3851
- results: SearchResult$1[];
3852
- pagination: Pagination;
3886
+ results: SearchResult$2[];
3887
+ pagination: Pagination$1;
3853
3888
  scraped_utc: number | null;
3854
3889
  scraped_at: string | null;
3855
3890
  }
@@ -3869,14 +3904,14 @@ interface OffersResponse {
3869
3904
  scraped_at: string | null;
3870
3905
  }
3871
3906
  /** Response from the /products/{asin}/reviews endpoint. */
3872
- interface ReviewsResponse {
3907
+ interface ReviewsResponse$1 {
3873
3908
  asin: string;
3874
3909
  domain: string;
3875
- reviews: Review[];
3910
+ reviews: Review$1[];
3876
3911
  rating: number | null;
3877
3912
  ratings_total: number | null;
3878
3913
  rating_breakdown: RatingBreakdown$1 | null;
3879
- pagination: Pagination;
3914
+ pagination: Pagination$1;
3880
3915
  scraped_utc: number | null;
3881
3916
  scraped_at: string | null;
3882
3917
  }
@@ -3885,7 +3920,7 @@ interface BestsellersResponse {
3885
3920
  domain: string;
3886
3921
  category: string | null;
3887
3922
  bestsellers: Bestseller[];
3888
- pagination: Pagination;
3923
+ pagination: Pagination$1;
3889
3924
  scraped_utc: number | null;
3890
3925
  scraped_at: string | null;
3891
3926
  }
@@ -3894,7 +3929,7 @@ interface NewReleasesResponse {
3894
3929
  domain: string;
3895
3930
  category: string | null;
3896
3931
  new_releases: Bestseller[];
3897
- pagination: Pagination;
3932
+ pagination: Pagination$1;
3898
3933
  scraped_utc: number | null;
3899
3934
  scraped_at: string | null;
3900
3935
  }
@@ -3903,55 +3938,55 @@ interface DealsResponse {
3903
3938
  domain: string;
3904
3939
  category: string | null;
3905
3940
  deals: Deal[];
3906
- pagination: Pagination;
3941
+ pagination: Pagination$1;
3907
3942
  scraped_utc: number | null;
3908
3943
  scraped_at: string | null;
3909
3944
  }
3910
3945
  /** Response from the /category endpoint. */
3911
- interface CategoryResponse {
3946
+ interface CategoryResponse$1 {
3912
3947
  domain: string;
3913
3948
  node: string;
3914
- results: SearchResult$1[];
3915
- pagination: Pagination;
3949
+ results: SearchResult$2[];
3950
+ pagination: Pagination$1;
3916
3951
  scraped_utc: number | null;
3917
3952
  scraped_at: string | null;
3918
3953
  }
3919
3954
  /** Response from the /sellers/{seller_id} endpoint. */
3920
- interface SellerProfileResponse {
3955
+ interface SellerProfileResponse$1 {
3921
3956
  domain: string;
3922
- seller: Seller;
3957
+ seller: Seller$1;
3923
3958
  }
3924
3959
  /** Response from the /sellers/{seller_id}/products endpoint. */
3925
3960
  interface SellerProductsResponse {
3926
3961
  domain: string;
3927
3962
  seller_id: string;
3928
- products: SearchResult$1[];
3929
- pagination: Pagination;
3963
+ products: SearchResult$2[];
3964
+ pagination: Pagination$1;
3930
3965
  scraped_utc: number | null;
3931
3966
  scraped_at: string | null;
3932
3967
  }
3933
3968
  /** Response from the /sellers/{seller_id}/feedback endpoint. */
3934
- interface SellerFeedbackResponse {
3969
+ interface SellerFeedbackResponse$1 {
3935
3970
  domain: string;
3936
3971
  seller_id: string;
3937
3972
  feedback: SellerFeedbackEntry[];
3938
- pagination: Pagination;
3973
+ pagination: Pagination$1;
3939
3974
  scraped_utc: number | null;
3940
3975
  scraped_at: string | null;
3941
3976
  }
3942
3977
  /** Response from the /autocomplete endpoint. */
3943
- interface AutocompleteResponse {
3978
+ interface AutocompleteResponse$1 {
3944
3979
  query: string;
3945
3980
  domain: string;
3946
- suggestions: AutocompleteSuggestion[];
3981
+ suggestions: AutocompleteSuggestion$1[];
3947
3982
  }
3948
3983
  /** Response from the /markets endpoint. */
3949
- interface MarketsResponse$1 {
3950
- markets: MarketInfo[];
3984
+ interface MarketsResponse$2 {
3985
+ markets: MarketInfo$1[];
3951
3986
  }
3952
3987
  /** Response from the /categories endpoint. */
3953
- interface CategoriesResponse {
3954
- categories: CategoryInfo[];
3988
+ interface CategoriesResponse$1 {
3989
+ categories: CategoryInfo$1[];
3955
3990
  }
3956
3991
  /** Parameters for searching Amazon products. */
3957
3992
  interface AmazonSearchParams {
@@ -4073,7 +4108,7 @@ interface AmazonAutocompleteParams {
4073
4108
  * const suggestions = await client.amazon.search.autocomplete("lapt");
4074
4109
  * ```
4075
4110
  */
4076
- declare class SearchClient$2 {
4111
+ declare class SearchClient$3 {
4077
4112
  private readonly client;
4078
4113
  constructor(client: BaseClient);
4079
4114
  /**
@@ -4084,7 +4119,7 @@ declare class SearchClient$2 {
4084
4119
  * @throws AuthenticationError - If the API key is invalid.
4085
4120
  * @throws ValidationError - If the parameters are invalid.
4086
4121
  */
4087
- search(params: AmazonSearchParams): Promise<SearchResponse>;
4122
+ search(params: AmazonSearchParams): Promise<SearchResponse$1>;
4088
4123
  /**
4089
4124
  * Get Amazon keyword autocomplete suggestions.
4090
4125
  *
@@ -4092,7 +4127,7 @@ declare class SearchClient$2 {
4092
4127
  * @param options - Optional parameters (domain).
4093
4128
  * @returns Autocomplete suggestions.
4094
4129
  */
4095
- autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse>;
4130
+ autocomplete(query: string, options?: AmazonAutocompleteParams): Promise<AutocompleteResponse$1>;
4096
4131
  }
4097
4132
 
4098
4133
  /**
@@ -4144,7 +4179,7 @@ declare class ProductsClient$1 {
4144
4179
  * @param options - Optional parameters (domain, page, sort_by, star, verified_only, media_only).
4145
4180
  * @returns Reviews response with reviews, aggregate rating, and breakdown.
4146
4181
  */
4147
- reviews(asin: string, options?: AmazonReviewsParams): Promise<ReviewsResponse>;
4182
+ reviews(asin: string, options?: AmazonReviewsParams): Promise<ReviewsResponse$1>;
4148
4183
  }
4149
4184
 
4150
4185
  /**
@@ -4196,7 +4231,7 @@ declare class ListingsClient {
4196
4231
  * @param params - Parameters including the required node ID.
4197
4232
  * @returns Category response with result rows and pagination.
4198
4233
  */
4199
- category(params: AmazonCategoryParams): Promise<CategoryResponse>;
4234
+ category(params: AmazonCategoryParams): Promise<CategoryResponse$1>;
4200
4235
  }
4201
4236
 
4202
4237
  /**
@@ -4218,7 +4253,7 @@ declare class ListingsClient {
4218
4253
  * const products = await client.amazon.sellers.products("A2L77EE7U53NWQ");
4219
4254
  * ```
4220
4255
  */
4221
- declare class SellersClient {
4256
+ declare class SellersClient$1 {
4222
4257
  private readonly client;
4223
4258
  constructor(client: BaseClient);
4224
4259
  /**
@@ -4229,7 +4264,7 @@ declare class SellersClient {
4229
4264
  * @returns Seller profile response.
4230
4265
  * @throws NotFoundError - If the seller doesn't exist.
4231
4266
  */
4232
- get(sellerId: string, options?: AmazonSellerParams): Promise<SellerProfileResponse>;
4267
+ get(sellerId: string, options?: AmazonSellerParams): Promise<SellerProfileResponse$1>;
4233
4268
  /**
4234
4269
  * Get a seller's storefront listings.
4235
4270
  *
@@ -4245,7 +4280,7 @@ declare class SellersClient {
4245
4280
  * @param options - Optional parameters (domain, page).
4246
4281
  * @returns Seller feedback response with feedback entries and pagination.
4247
4282
  */
4248
- feedback(sellerId: string, options?: AmazonSellerListParams): Promise<SellerFeedbackResponse>;
4283
+ feedback(sellerId: string, options?: AmazonSellerListParams): Promise<SellerFeedbackResponse$1>;
4249
4284
  }
4250
4285
 
4251
4286
  /**
@@ -4269,7 +4304,7 @@ declare class SellersClient {
4269
4304
  * const categories = await client.amazon.reference.categories();
4270
4305
  * ```
4271
4306
  */
4272
- declare class ReferenceClient$2 {
4307
+ declare class ReferenceClient$3 {
4273
4308
  private readonly client;
4274
4309
  constructor(client: BaseClient);
4275
4310
  /**
@@ -4277,13 +4312,13 @@ declare class ReferenceClient$2 {
4277
4312
  *
4278
4313
  * @returns Markets response with all supported marketplaces.
4279
4314
  */
4280
- markets(): Promise<MarketsResponse$1>;
4315
+ markets(): Promise<MarketsResponse$2>;
4281
4316
  /**
4282
4317
  * Get the reference department / category aliases.
4283
4318
  *
4284
4319
  * @returns Categories response with all category aliases.
4285
4320
  */
4286
- categories(): Promise<CategoriesResponse>;
4321
+ categories(): Promise<CategoriesResponse$1>;
4287
4322
  }
4288
4323
 
4289
4324
  /**
@@ -4324,15 +4359,15 @@ declare class ReferenceClient$2 {
4324
4359
  */
4325
4360
  declare class AmazonClient {
4326
4361
  /** Client for keyword search and autocomplete */
4327
- readonly search: SearchClient$2;
4362
+ readonly search: SearchClient$3;
4328
4363
  /** Client for product detail, offers, and reviews */
4329
4364
  readonly products: ProductsClient$1;
4330
4365
  /** Client for bestsellers, new releases, deals, and category browse */
4331
4366
  readonly listings: ListingsClient;
4332
4367
  /** Client for seller profile, products, and feedback */
4333
- readonly sellers: SellersClient;
4368
+ readonly sellers: SellersClient$1;
4334
4369
  /** Client for reference data (markets, categories) */
4335
- readonly reference: ReferenceClient$2;
4370
+ readonly reference: ReferenceClient$3;
4336
4371
  /**
4337
4372
  * Create a new Amazon client.
4338
4373
  *
@@ -4441,7 +4476,7 @@ interface ShopeeProduct {
4441
4476
  /**
4442
4477
  * A page of search/category results.
4443
4478
  */
4444
- interface SearchResult {
4479
+ interface SearchResult$1 {
4445
4480
  market: string;
4446
4481
  keyword: string | null;
4447
4482
  category_id: number | null;
@@ -4549,7 +4584,7 @@ interface ShopeeMarket {
4549
4584
  /**
4550
4585
  * Response from the /v1/shopee/markets endpoint.
4551
4586
  */
4552
- interface MarketsResponse {
4587
+ interface MarketsResponse$1 {
4553
4588
  markets: ShopeeMarket[];
4554
4589
  }
4555
4590
  /** Parameters for searching Shopee products. */
@@ -4624,7 +4659,7 @@ interface ShopeeCategoriesParams {
4624
4659
  * const cat = await client.shopee.search.categoryItems(100001, { market: "sg" });
4625
4660
  * ```
4626
4661
  */
4627
- declare class SearchClient$1 {
4662
+ declare class SearchClient$2 {
4628
4663
  private readonly client;
4629
4664
  constructor(client: BaseClient);
4630
4665
  /**
@@ -4635,7 +4670,7 @@ declare class SearchClient$1 {
4635
4670
  * @throws AuthenticationError - If the API key is invalid.
4636
4671
  * @throws ValidationError - If the parameters are invalid.
4637
4672
  */
4638
- search(params: ShopeeSearchParams): Promise<SearchResult>;
4673
+ search(params: ShopeeSearchParams): Promise<SearchResult$1>;
4639
4674
  /**
4640
4675
  * List products within a specific Shopee category.
4641
4676
  *
@@ -4645,7 +4680,7 @@ declare class SearchClient$1 {
4645
4680
  * @throws AuthenticationError - If the API key is invalid.
4646
4681
  * @throws ValidationError - If the category ID or market is invalid.
4647
4682
  */
4648
- categoryItems(categoryId: number, options?: ShopeeCategoryItemsParams): Promise<SearchResult>;
4683
+ categoryItems(categoryId: number, options?: ShopeeCategoryItemsParams): Promise<SearchResult$1>;
4649
4684
  }
4650
4685
 
4651
4686
  /**
@@ -4747,7 +4782,7 @@ declare class ReviewsClient {
4747
4782
  * }
4748
4783
  * ```
4749
4784
  */
4750
- declare class ReferenceClient$1 {
4785
+ declare class ReferenceClient$2 {
4751
4786
  private readonly client;
4752
4787
  constructor(client: BaseClient);
4753
4788
  /**
@@ -4755,7 +4790,7 @@ declare class ReferenceClient$1 {
4755
4790
  *
4756
4791
  * @returns Markets response with all supported Shopee markets (0 credits).
4757
4792
  */
4758
- markets(): Promise<MarketsResponse>;
4793
+ markets(): Promise<MarketsResponse$1>;
4759
4794
  /**
4760
4795
  * Get the full category tree for a Shopee market.
4761
4796
  *
@@ -4807,13 +4842,13 @@ declare class ReferenceClient$1 {
4807
4842
  */
4808
4843
  declare class ShopeeClient {
4809
4844
  /** Client for keyword search and category-item listing */
4810
- readonly search: SearchClient$1;
4845
+ readonly search: SearchClient$2;
4811
4846
  /** Client for full product detail pages */
4812
4847
  readonly products: ProductsClient;
4813
4848
  /** Client for product reviews and rating summaries */
4814
4849
  readonly reviews: ReviewsClient;
4815
4850
  /** Client for reference data (markets, category tree) */
4816
- readonly reference: ReferenceClient$1;
4851
+ readonly reference: ReferenceClient$2;
4817
4852
  /**
4818
4853
  * Create a new Shopee client.
4819
4854
  *
@@ -5659,7 +5694,7 @@ declare class VideosClient {
5659
5694
  * const users = await client.tiktok.search.users({ query: "skincare" });
5660
5695
  * ```
5661
5696
  */
5662
- declare class SearchClient {
5697
+ declare class SearchClient$1 {
5663
5698
  private readonly client;
5664
5699
  constructor(client: BaseClient);
5665
5700
  /**
@@ -5865,7 +5900,7 @@ declare class AdsClient {
5865
5900
  * }
5866
5901
  * ```
5867
5902
  */
5868
- declare class ReferenceClient {
5903
+ declare class ReferenceClient$1 {
5869
5904
  private readonly client;
5870
5905
  constructor(client: BaseClient);
5871
5906
  /**
@@ -5930,7 +5965,7 @@ declare class TikTokClient {
5930
5965
  /** Client for video detail, comments, replies, related, transcript, oEmbed */
5931
5966
  readonly videos: VideosClient;
5932
5967
  /** Client for keyword search across videos, users, and hashtags */
5933
- readonly search: SearchClient;
5968
+ readonly search: SearchClient$1;
5934
5969
  /** Client for sound/music detail and videos using a sound */
5935
5970
  readonly music: MusicClient;
5936
5971
  /** Client for hashtag detail and tagged videos */
@@ -5940,7 +5975,7 @@ declare class TikTokClient {
5940
5975
  /** Client for the Commercial Content Library (ad transparency) */
5941
5976
  readonly ads: AdsClient;
5942
5977
  /** Client for reference data (regions) and service health */
5943
- readonly reference: ReferenceClient;
5978
+ readonly reference: ReferenceClient$1;
5944
5979
  /**
5945
5980
  * Create a new TikTok client.
5946
5981
  *
@@ -5949,6 +5984,734 @@ declare class TikTokClient {
5949
5984
  constructor(client: BaseClient);
5950
5985
  }
5951
5986
 
5987
+ /**
5988
+ * TypeScript types for eBay API responses.
5989
+ *
5990
+ * These interfaces mirror the backend `ebay_scraper` response schema
5991
+ * field-for-field. Optional / nullable backend fields are typed as
5992
+ * `Type | null`; backend list fields default to `[]` and are typed as arrays.
5993
+ * Every datetime field ships in BOTH `*_utc` (number) and `*_at` (string) form.
5994
+ */
5995
+ /**
5996
+ * A parsed price with both the numeric value and its raw rendering.
5997
+ */
5998
+ interface EbayPrice {
5999
+ /** Numeric price value */
6000
+ value: number | null;
6001
+ /** ISO currency code (e.g. "USD") */
6002
+ currency: string | null;
6003
+ /** Currency symbol (e.g. "$") */
6004
+ symbol: string | null;
6005
+ /** Raw rendered price string (e.g. "$29.99") */
6006
+ raw: string | null;
6007
+ }
6008
+ /**
6009
+ * Page-number pagination (eBay listings use 1-based `_pgn` numbers).
6010
+ */
6011
+ interface Pagination {
6012
+ /** Current page number (1-indexed) */
6013
+ current_page: number;
6014
+ /** Results per page, if known */
6015
+ per_page: number | null;
6016
+ /** Total number of pages, if known */
6017
+ total_pages: number | null;
6018
+ /** Total number of results, if known */
6019
+ total_results: number | null;
6020
+ }
6021
+ /**
6022
+ * A single supported marketplace (for /markets).
6023
+ */
6024
+ interface MarketInfo {
6025
+ /** Market code (e.g. "US", "GB", "DE") */
6026
+ code: string;
6027
+ /** eBay domain suffix (e.g. "com", "co.uk") */
6028
+ domain: string;
6029
+ /** Country name */
6030
+ country: string;
6031
+ /** Currency code (e.g. "USD") */
6032
+ currency: string;
6033
+ /** Locale (e.g. "en-US") */
6034
+ locale: string;
6035
+ /** Market display name */
6036
+ name: string;
6037
+ /** eBay site id */
6038
+ site_id: number;
6039
+ }
6040
+ /**
6041
+ * A reference category alias (for /categories).
6042
+ */
6043
+ interface CategoryInfo {
6044
+ /** Category display name */
6045
+ name: string;
6046
+ /** Category id */
6047
+ category_id: string;
6048
+ /** Parent category name, if any */
6049
+ parent: string | null;
6050
+ }
6051
+ /**
6052
+ * A single image with optional dimensions.
6053
+ */
6054
+ interface Image {
6055
+ url: string;
6056
+ width: number | null;
6057
+ height: number | null;
6058
+ }
6059
+ /**
6060
+ * A single shipping option (per-destination rate from JSON-LD or DOM).
6061
+ */
6062
+ interface ShippingOption {
6063
+ cost: EbayPrice | null;
6064
+ is_free: boolean | null;
6065
+ service: string | null;
6066
+ destination_country: string | null;
6067
+ delivery_estimate: string | null;
6068
+ }
6069
+ /**
6070
+ * One eBay search/listing card (search, seller items, category, sold).
6071
+ */
6072
+ interface SearchResult {
6073
+ position: number;
6074
+ item_id: string | null;
6075
+ product_id: string | null;
6076
+ title: string | null;
6077
+ url: string | null;
6078
+ image: string | null;
6079
+ price: EbayPrice | null;
6080
+ original_price: EbayPrice | null;
6081
+ discount_percent: number | null;
6082
+ currency: string | null;
6083
+ condition: string | null;
6084
+ brand: string | null;
6085
+ /** "Buy It Now" | "Auction" | "Best Offer" */
6086
+ buying_format: string | null;
6087
+ is_auction: boolean;
6088
+ bids: number | null;
6089
+ time_left: string | null;
6090
+ shipping: string | null;
6091
+ shipping_cost: EbayPrice | null;
6092
+ free_shipping: boolean | null;
6093
+ location: string | null;
6094
+ returns: string | null;
6095
+ sold_count: number | null;
6096
+ watchers: number | null;
6097
+ coupon: string | null;
6098
+ rating: number | null;
6099
+ ratings_total: number | null;
6100
+ seller_name: string | null;
6101
+ seller_feedback_percent: number | null;
6102
+ seller_feedback_score: number | null;
6103
+ /** e.g. "eBay Refurbished" */
6104
+ program_badge: string | null;
6105
+ is_sponsored: boolean;
6106
+ }
6107
+ /**
6108
+ * The seller summary attached to an item.
6109
+ */
6110
+ interface ItemSeller {
6111
+ username: string | null;
6112
+ url: string | null;
6113
+ feedback_score: number | null;
6114
+ feedback_percent: number | null;
6115
+ store_name: string | null;
6116
+ store_url: string | null;
6117
+ }
6118
+ /**
6119
+ * The returns policy for an item.
6120
+ */
6121
+ interface ReturnsPolicy {
6122
+ accepted: boolean | null;
6123
+ /** e.g. "30 days" */
6124
+ period: string | null;
6125
+ /** "buyer" | "seller" */
6126
+ cost_paid_by: string | null;
6127
+ raw: string | null;
6128
+ }
6129
+ /**
6130
+ * Full item detail (PDP).
6131
+ */
6132
+ interface Item {
6133
+ item_id: string;
6134
+ product_id: string | null;
6135
+ legacy_item_id: string | null;
6136
+ title: string | null;
6137
+ subtitle: string | null;
6138
+ url: string | null;
6139
+ condition: string | null;
6140
+ condition_id: string | null;
6141
+ condition_description: string | null;
6142
+ price: EbayPrice | null;
6143
+ original_price: EbayPrice | null;
6144
+ discount_percent: number | null;
6145
+ currency: string | null;
6146
+ availability: string | null;
6147
+ quantity_available: number | null;
6148
+ quantity_sold: number | null;
6149
+ watchers: number | null;
6150
+ buying_format: string | null;
6151
+ is_auction: boolean;
6152
+ bids: number | null;
6153
+ time_left: string | null;
6154
+ best_offer_enabled: boolean | null;
6155
+ brand: string | null;
6156
+ mpn: string | null;
6157
+ model: string | null;
6158
+ color: string | null;
6159
+ gtin: string | null;
6160
+ main_image: string | null;
6161
+ images: Image[];
6162
+ images_count: number;
6163
+ description: string | null;
6164
+ seller_notes: string | null;
6165
+ item_specifics: Record<string, string>;
6166
+ categories: string[];
6167
+ category_id: string | null;
6168
+ shipping_options: ShippingOption[];
6169
+ shipping_cost: EbayPrice | null;
6170
+ free_shipping: boolean | null;
6171
+ item_location: string | null;
6172
+ ships_to: string[];
6173
+ returns: ReturnsPolicy | null;
6174
+ seller: ItemSeller | null;
6175
+ rating: number | null;
6176
+ ratings_total: number | null;
6177
+ date_modified_utc: number | null;
6178
+ date_modified_at: string | null;
6179
+ scraped_utc: number | null;
6180
+ scraped_at: string | null;
6181
+ }
6182
+ /**
6183
+ * Positive / neutral / negative feedback counts for a window.
6184
+ */
6185
+ interface FeedbackBreakdown {
6186
+ positive: number | null;
6187
+ neutral: number | null;
6188
+ negative: number | null;
6189
+ }
6190
+ /**
6191
+ * A seller profile.
6192
+ */
6193
+ interface Seller {
6194
+ username: string;
6195
+ url: string | null;
6196
+ store_name: string | null;
6197
+ store_url: string | null;
6198
+ feedback_score: number | null;
6199
+ feedback_percent: number | null;
6200
+ member_since: string | null;
6201
+ location: string | null;
6202
+ items_for_sale: number | null;
6203
+ feedback_12mo: FeedbackBreakdown | null;
6204
+ top_rated: boolean | null;
6205
+ scraped_utc: number | null;
6206
+ scraped_at: string | null;
6207
+ }
6208
+ /**
6209
+ * A single seller feedback entry.
6210
+ */
6211
+ interface FeedbackEntry {
6212
+ /** "positive" | "neutral" | "negative" */
6213
+ rating: string | null;
6214
+ comment: string | null;
6215
+ rater: string | null;
6216
+ item: string | null;
6217
+ date_raw: string | null;
6218
+ date_utc: number | null;
6219
+ date_at: string | null;
6220
+ }
6221
+ /**
6222
+ * Per-star rating distribution.
6223
+ */
6224
+ interface RatingHistogram {
6225
+ five_star: number | null;
6226
+ four_star: number | null;
6227
+ three_star: number | null;
6228
+ two_star: number | null;
6229
+ one_star: number | null;
6230
+ }
6231
+ /**
6232
+ * A single catalog product review.
6233
+ */
6234
+ interface Review {
6235
+ title: string | null;
6236
+ body: string | null;
6237
+ rating: number | null;
6238
+ author: string | null;
6239
+ date_raw: string | null;
6240
+ date_utc: number | null;
6241
+ date_at: string | null;
6242
+ helpful_votes: number | null;
6243
+ verified_purchase: boolean;
6244
+ }
6245
+ /**
6246
+ * A single keyword suggestion.
6247
+ */
6248
+ interface AutocompleteSuggestion {
6249
+ value: string;
6250
+ }
6251
+ /** Response from the /search and /completed endpoints. */
6252
+ interface SearchResponse {
6253
+ query: string | null;
6254
+ domain: string;
6255
+ category_id: string | null;
6256
+ sold: boolean;
6257
+ results: SearchResult[];
6258
+ facets: Record<string, string[]>;
6259
+ pagination: Pagination;
6260
+ scraped_utc: number | null;
6261
+ scraped_at: string | null;
6262
+ }
6263
+ /** Response from the /items/{item_id} endpoint. */
6264
+ interface ItemDetailResponse {
6265
+ domain: string;
6266
+ item: Item;
6267
+ }
6268
+ /** Response from the /sellers/{username} endpoint. */
6269
+ interface SellerProfileResponse {
6270
+ domain: string;
6271
+ seller: Seller;
6272
+ }
6273
+ /** Response from the /sellers/{username}/items endpoint. */
6274
+ interface SellerItemsResponse {
6275
+ domain: string;
6276
+ username: string;
6277
+ results: SearchResult[];
6278
+ pagination: Pagination;
6279
+ scraped_utc: number | null;
6280
+ scraped_at: string | null;
6281
+ }
6282
+ /** Response from the /sellers/{username}/feedback endpoint. */
6283
+ interface SellerFeedbackResponse {
6284
+ domain: string;
6285
+ username: string;
6286
+ feedback: FeedbackEntry[];
6287
+ pagination: Pagination;
6288
+ scraped_utc: number | null;
6289
+ scraped_at: string | null;
6290
+ }
6291
+ /** Response from the /items/{item_id}/reviews endpoint. */
6292
+ interface ReviewsResponse {
6293
+ domain: string;
6294
+ item_id: string | null;
6295
+ product_id: string | null;
6296
+ rating: number | null;
6297
+ ratings_total: number | null;
6298
+ histogram: RatingHistogram | null;
6299
+ reviews: Review[];
6300
+ pagination: Pagination;
6301
+ scraped_utc: number | null;
6302
+ scraped_at: string | null;
6303
+ }
6304
+ /** Response from the /categories/{category_id}/items endpoint. */
6305
+ interface CategoryResponse {
6306
+ domain: string;
6307
+ category_id: string;
6308
+ results: SearchResult[];
6309
+ facets: Record<string, string[]>;
6310
+ pagination: Pagination;
6311
+ scraped_utc: number | null;
6312
+ scraped_at: string | null;
6313
+ }
6314
+ /** Response from the /autocomplete endpoint. */
6315
+ interface AutocompleteResponse {
6316
+ query: string;
6317
+ domain: string;
6318
+ suggestions: AutocompleteSuggestion[];
6319
+ }
6320
+ /** Response from the /markets endpoint. */
6321
+ interface MarketsResponse {
6322
+ markets: MarketInfo[];
6323
+ }
6324
+ /** Response from the /categories endpoint. */
6325
+ interface CategoriesResponse {
6326
+ categories: CategoryInfo[];
6327
+ }
6328
+ /** Sort order for search / listing endpoints. */
6329
+ type EbaySortBy = "best_match" | "ending_soonest" | "newly_listed" | "price_low_to_high" | "price_high_to_low";
6330
+ /** Item condition filter. */
6331
+ type EbayCondition = "new" | "open_box" | "refurbished" | "used" | "for_parts";
6332
+ /** Buying-format filter. */
6333
+ type EbayBuyingFormat = "auction" | "buy_it_now" | "best_offer";
6334
+ /** Parameters for searching active eBay listings. */
6335
+ interface EbaySearchParams {
6336
+ /** Search keywords (required) */
6337
+ query: string;
6338
+ /** Marketplace domain (default: "com") */
6339
+ domain?: string;
6340
+ /** Restrict to a category id */
6341
+ category_id?: string;
6342
+ /** Page number (1-indexed) */
6343
+ page?: number;
6344
+ /** Results per page (60, 120 or 240; clamped) */
6345
+ per_page?: number;
6346
+ /** Sort order */
6347
+ sort_by?: EbaySortBy;
6348
+ /** Item condition filter */
6349
+ condition?: EbayCondition;
6350
+ /** Buying-format filter */
6351
+ buying_format?: EbayBuyingFormat;
6352
+ /** Minimum price filter */
6353
+ min_price?: number;
6354
+ /** Maximum price filter */
6355
+ max_price?: number;
6356
+ /** Restrict to free-shipping listings */
6357
+ free_shipping?: boolean;
6358
+ }
6359
+ /** Parameters for searching completed / sold eBay listings. */
6360
+ interface EbayCompletedParams {
6361
+ /** Search keywords (required) */
6362
+ query: string;
6363
+ /** Marketplace domain (default: "com") */
6364
+ domain?: string;
6365
+ /** Restrict to a category id */
6366
+ category_id?: string;
6367
+ /** Page number (1-indexed) */
6368
+ page?: number;
6369
+ /** Results per page (60, 120 or 240; clamped) */
6370
+ per_page?: number;
6371
+ /** Sort order */
6372
+ sort_by?: EbaySortBy;
6373
+ /** Item condition filter */
6374
+ condition?: EbayCondition;
6375
+ /** Minimum price filter */
6376
+ min_price?: number;
6377
+ /** Maximum price filter */
6378
+ max_price?: number;
6379
+ }
6380
+ /** Options for the item detail endpoint. */
6381
+ interface EbayItemParams {
6382
+ /** Marketplace domain (default: "com") */
6383
+ domain?: string;
6384
+ }
6385
+ /** Options for the item reviews endpoint. */
6386
+ interface EbayReviewsParams {
6387
+ /** Marketplace domain (default: "com") */
6388
+ domain?: string;
6389
+ /** Page number (1-indexed) */
6390
+ page?: number;
6391
+ /** Fetch reviews by catalog product id instead of item id */
6392
+ productId?: string;
6393
+ }
6394
+ /** Options for the seller profile endpoint. */
6395
+ interface EbaySellerParams {
6396
+ /** Marketplace domain (default: "com") */
6397
+ domain?: string;
6398
+ }
6399
+ /** Options for the seller items endpoint. */
6400
+ interface EbaySellerItemsParams {
6401
+ /** Marketplace domain (default: "com") */
6402
+ domain?: string;
6403
+ /** Filter the seller's listings by keyword */
6404
+ query?: string;
6405
+ /** Page number (1-indexed) */
6406
+ page?: number;
6407
+ /** Results per page (60, 120 or 240; clamped) */
6408
+ per_page?: number;
6409
+ }
6410
+ /** Options for the seller feedback endpoint. */
6411
+ interface EbaySellerFeedbackParams {
6412
+ /** Marketplace domain (default: "com") */
6413
+ domain?: string;
6414
+ /** Page number (1-indexed) */
6415
+ page?: number;
6416
+ }
6417
+ /** Options for the category-browse endpoint. */
6418
+ interface EbayCategoryParams {
6419
+ /** Marketplace domain (default: "com") */
6420
+ domain?: string;
6421
+ /** Page number (1-indexed) */
6422
+ page?: number;
6423
+ /** Results per page (60, 120 or 240; clamped) */
6424
+ per_page?: number;
6425
+ /** Sort order */
6426
+ sort_by?: EbaySortBy;
6427
+ /** Minimum price filter */
6428
+ min_price?: number;
6429
+ /** Maximum price filter */
6430
+ max_price?: number;
6431
+ }
6432
+ /** Options for the autocomplete endpoint. */
6433
+ interface EbayAutocompleteParams {
6434
+ /** Marketplace domain (default: "com") */
6435
+ domain?: string;
6436
+ }
6437
+
6438
+ /**
6439
+ * eBay Search API client.
6440
+ *
6441
+ * Provides methods for active search, completed/sold search, and keyword
6442
+ * autocomplete suggestions.
6443
+ */
6444
+
6445
+ /**
6446
+ * Client for eBay search, completed-listings, and autocomplete endpoints.
6447
+ *
6448
+ * @example
6449
+ * ```typescript
6450
+ * const client = new ScrapeBadger({ apiKey: "key" });
6451
+ *
6452
+ * const results = await client.ebay.search.search({ query: "nintendo switch" });
6453
+ * for (const item of results.results) {
6454
+ * console.log(`${item.position}. ${item.title}`);
6455
+ * }
6456
+ *
6457
+ * const sold = await client.ebay.search.completed({ query: "nintendo switch" });
6458
+ *
6459
+ * const suggestions = await client.ebay.search.autocomplete("ipho");
6460
+ * ```
6461
+ */
6462
+ declare class SearchClient {
6463
+ private readonly client;
6464
+ constructor(client: BaseClient);
6465
+ /**
6466
+ * Search an eBay marketplace for active listings.
6467
+ *
6468
+ * @param params - Search parameters including query, filters, and pagination.
6469
+ * @returns Search results with cards, facets, and pagination metadata.
6470
+ * @throws AuthenticationError - If the API key is invalid.
6471
+ * @throws ValidationError - If the parameters are invalid.
6472
+ */
6473
+ search(params: EbaySearchParams): Promise<SearchResponse>;
6474
+ /**
6475
+ * Search completed / sold listings — eBay's sold-price history.
6476
+ *
6477
+ * @param params - Search parameters including query, filters, and pagination.
6478
+ * @returns Search results (with `sold: true`), facets, and pagination.
6479
+ */
6480
+ completed(params: EbayCompletedParams): Promise<SearchResponse>;
6481
+ /**
6482
+ * Get eBay keyword autocomplete suggestions.
6483
+ *
6484
+ * @param query - Partial search query prefix.
6485
+ * @param options - Optional parameters (domain).
6486
+ * @returns Autocomplete suggestions.
6487
+ */
6488
+ autocomplete(query: string, options?: EbayAutocompleteParams): Promise<AutocompleteResponse>;
6489
+ }
6490
+
6491
+ /**
6492
+ * eBay Items API client.
6493
+ *
6494
+ * Provides methods for fetching item detail and catalog product reviews.
6495
+ */
6496
+
6497
+ /**
6498
+ * Client for eBay item endpoints (detail, reviews).
6499
+ *
6500
+ * @example
6501
+ * ```typescript
6502
+ * const client = new ScrapeBadger({ apiKey: "key" });
6503
+ *
6504
+ * const detail = await client.ebay.items.get("123456789012");
6505
+ * console.log(detail.item.title);
6506
+ *
6507
+ * const reviews = await client.ebay.items.reviews("123456789012");
6508
+ * console.log(`${reviews.ratings_total} reviews`);
6509
+ * ```
6510
+ */
6511
+ declare class ItemsClient {
6512
+ private readonly client;
6513
+ constructor(client: BaseClient);
6514
+ /**
6515
+ * Get a single eBay listing's full detail.
6516
+ *
6517
+ * @param itemId - The eBay item id.
6518
+ * @param options - Optional parameters (domain).
6519
+ * @returns Item detail including specifics, shipping, and seller summary.
6520
+ * @throws NotFoundError - If the item doesn't exist.
6521
+ */
6522
+ get(itemId: string, options?: EbayItemParams): Promise<ItemDetailResponse>;
6523
+ /**
6524
+ * Get the catalog product reviews shown on an eBay listing.
6525
+ *
6526
+ * @param itemId - The eBay item id.
6527
+ * @param options - Optional parameters (domain, page, productId).
6528
+ * @returns Reviews response with reviews, aggregate rating, and histogram.
6529
+ */
6530
+ reviews(itemId: string, options?: EbayReviewsParams): Promise<ReviewsResponse>;
6531
+ }
6532
+
6533
+ /**
6534
+ * eBay Sellers API client.
6535
+ *
6536
+ * Provides methods for seller profile, storefront listings, and feedback.
6537
+ */
6538
+
6539
+ /**
6540
+ * Client for eBay seller endpoints (profile, items, feedback).
6541
+ *
6542
+ * @example
6543
+ * ```typescript
6544
+ * const client = new ScrapeBadger({ apiKey: "key" });
6545
+ *
6546
+ * const profile = await client.ebay.sellers.get("musicmagpie");
6547
+ * console.log(profile.seller.feedback_score);
6548
+ *
6549
+ * const items = await client.ebay.sellers.items("musicmagpie");
6550
+ * const feedback = await client.ebay.sellers.feedback("musicmagpie");
6551
+ * ```
6552
+ */
6553
+ declare class SellersClient {
6554
+ private readonly client;
6555
+ constructor(client: BaseClient);
6556
+ /**
6557
+ * Get an eBay seller's public profile.
6558
+ *
6559
+ * @param username - The seller username.
6560
+ * @param options - Optional parameters (domain).
6561
+ * @returns Seller profile response.
6562
+ * @throws NotFoundError - If the seller doesn't exist.
6563
+ */
6564
+ get(username: string, options?: EbaySellerParams): Promise<SellerProfileResponse>;
6565
+ /**
6566
+ * List the active listings of a single eBay seller.
6567
+ *
6568
+ * @param username - The seller username.
6569
+ * @param options - Optional parameters (domain, query, page, per_page).
6570
+ * @returns Seller items response with result cards and pagination.
6571
+ */
6572
+ items(username: string, options?: EbaySellerItemsParams): Promise<SellerItemsResponse>;
6573
+ /**
6574
+ * Get a seller's recent feedback comments.
6575
+ *
6576
+ * @param username - The seller username.
6577
+ * @param options - Optional parameters (domain, page).
6578
+ * @returns Seller feedback response with feedback entries and pagination.
6579
+ */
6580
+ feedback(username: string, options?: EbaySellerFeedbackParams): Promise<SellerFeedbackResponse>;
6581
+ }
6582
+
6583
+ /**
6584
+ * eBay Categories API client.
6585
+ *
6586
+ * Provides methods for browsing a category's listings and listing the
6587
+ * reference category aliases.
6588
+ */
6589
+
6590
+ /**
6591
+ * Client for eBay category endpoints (browse, list).
6592
+ *
6593
+ * @example
6594
+ * ```typescript
6595
+ * const client = new ScrapeBadger({ apiKey: "key" });
6596
+ *
6597
+ * const listings = await client.ebay.categories.browse("9355");
6598
+ * for (const item of listings.results) {
6599
+ * console.log(item.title);
6600
+ * }
6601
+ *
6602
+ * const categories = await client.ebay.categories.list();
6603
+ * ```
6604
+ */
6605
+ declare class CategoriesClient {
6606
+ private readonly client;
6607
+ constructor(client: BaseClient);
6608
+ /**
6609
+ * List active listings within an eBay category.
6610
+ *
6611
+ * @param categoryId - The eBay category id.
6612
+ * @param options - Optional parameters (domain, page, per_page, sort_by, min_price, max_price).
6613
+ * @returns Category response with result cards, facets, and pagination.
6614
+ */
6615
+ browse(categoryId: string, options?: EbayCategoryParams): Promise<CategoryResponse>;
6616
+ /**
6617
+ * List eBay's reference top-level category ids.
6618
+ *
6619
+ * @returns Categories response with all category aliases.
6620
+ */
6621
+ list(): Promise<CategoriesResponse>;
6622
+ }
6623
+
6624
+ /**
6625
+ * eBay Reference Data API client.
6626
+ *
6627
+ * Provides methods for fetching the static marketplace list.
6628
+ */
6629
+
6630
+ /**
6631
+ * Client for eBay reference data endpoints (markets).
6632
+ *
6633
+ * @example
6634
+ * ```typescript
6635
+ * const client = new ScrapeBadger({ apiKey: "key" });
6636
+ *
6637
+ * const markets = await client.ebay.reference.markets();
6638
+ * for (const m of markets.markets) {
6639
+ * console.log(`${m.code}: ${m.domain} (${m.currency})`);
6640
+ * }
6641
+ * ```
6642
+ */
6643
+ declare class ReferenceClient {
6644
+ private readonly client;
6645
+ constructor(client: BaseClient);
6646
+ /**
6647
+ * Get all supported eBay marketplaces.
6648
+ *
6649
+ * @returns Markets response with all supported marketplaces.
6650
+ */
6651
+ markets(): Promise<MarketsResponse>;
6652
+ }
6653
+
6654
+ /**
6655
+ * eBay API client.
6656
+ *
6657
+ * Provides access to all eBay API endpoints through specialized sub-clients.
6658
+ */
6659
+
6660
+ /**
6661
+ * eBay API client with access to all eBay endpoints.
6662
+ *
6663
+ * Provides sub-clients for different resource types:
6664
+ * - `search` - Active search, completed/sold search, and autocomplete
6665
+ * - `items` - Item detail and catalog product reviews
6666
+ * - `sellers` - Seller profile, storefront items, and feedback
6667
+ * - `categories` - Category browse and reference category list
6668
+ * - `reference` - Reference data (markets)
6669
+ *
6670
+ * @example
6671
+ * ```typescript
6672
+ * const client = new ScrapeBadger({ apiKey: "key" });
6673
+ *
6674
+ * // Search active listings
6675
+ * const results = await client.ebay.search.search({ query: "nintendo switch" });
6676
+ *
6677
+ * // Sold-price history
6678
+ * const sold = await client.ebay.search.completed({ query: "nintendo switch" });
6679
+ *
6680
+ * // Get item detail
6681
+ * const item = await client.ebay.items.get("123456789012");
6682
+ *
6683
+ * // Get item reviews
6684
+ * const reviews = await client.ebay.items.reviews("123456789012");
6685
+ *
6686
+ * // Get a seller profile
6687
+ * const seller = await client.ebay.sellers.get("musicmagpie");
6688
+ *
6689
+ * // Browse a category
6690
+ * const listings = await client.ebay.categories.browse("9355");
6691
+ *
6692
+ * // Reference data
6693
+ * const markets = await client.ebay.reference.markets();
6694
+ * ```
6695
+ */
6696
+ declare class EbayClient {
6697
+ /** Client for active search, completed/sold search, and autocomplete */
6698
+ readonly search: SearchClient;
6699
+ /** Client for item detail and catalog product reviews */
6700
+ readonly items: ItemsClient;
6701
+ /** Client for seller profile, items, and feedback */
6702
+ readonly sellers: SellersClient;
6703
+ /** Client for category browse and the reference category list */
6704
+ readonly categories: CategoriesClient;
6705
+ /** Client for reference data (markets) */
6706
+ readonly reference: ReferenceClient;
6707
+ /**
6708
+ * Create a new eBay client.
6709
+ *
6710
+ * @param client - The base HTTP client for making requests.
6711
+ */
6712
+ constructor(client: BaseClient);
6713
+ }
6714
+
5952
6715
  /**
5953
6716
  * Main ScrapeBadger client.
5954
6717
  *
@@ -6005,6 +6768,8 @@ declare class ScrapeBadger {
6005
6768
  readonly shopee: ShopeeClient;
6006
6769
  /** TikTok scraper API client — 26 endpoints */
6007
6770
  readonly tiktok: TikTokClient;
6771
+ /** eBay scraper API client — 12 endpoints across 18 markets */
6772
+ readonly ebay: EbayClient;
6008
6773
  /**
6009
6774
  * Create a new ScrapeBadger client.
6010
6775
  *
@@ -6033,4 +6798,4 @@ declare class ScrapeBadger {
6033
6798
  constructor(config?: Partial<ScrapeBadgerConfig>);
6034
6799
  }
6035
6800
 
6036
- export { type AiListItem, type AiModeResponse, type AiModeSearchParams, type AiReference, type AiTableRow, type AiTextBlock, type AmazonAutocompleteParams, type AutocompleteResponse as AmazonAutocompleteResponse, type AutocompleteSuggestion as AmazonAutocompleteSuggestion, type Bestseller as AmazonBestseller, type BestsellersRankEntry as AmazonBestsellersRankEntry, type BestsellersResponse as AmazonBestsellersResponse, type Buybox as AmazonBuybox, type CategoriesResponse as AmazonCategoriesResponse, type CategoryInfo as AmazonCategoryInfo, type AmazonCategoryParams, type CategoryResponse as AmazonCategoryResponse, AmazonClient, type Coupon as AmazonCoupon, type Deal as AmazonDeal, type AmazonDealsParams, type DealsResponse as AmazonDealsResponse, type Delivery as AmazonDelivery, type FeedbackWindow as AmazonFeedbackWindow, ListingsClient as AmazonListingsClient, type AmazonListingsParams, type MarketInfo as AmazonMarketInfo, type MarketsResponse$1 as AmazonMarketsResponse, type NewReleasesResponse as AmazonNewReleasesResponse, type Offer as AmazonOffer, type OfferCondition as AmazonOfferCondition, type OfferDelivery as AmazonOfferDelivery, type OfferSeller as AmazonOfferSeller, type AmazonOffersParams, type OffersResponse as AmazonOffersResponse, type Pagination as AmazonPagination, type AmazonPrice, type Product as AmazonProduct, type ProductBadges as AmazonProductBadges, type ProductDeal as AmazonProductDeal, type ProductDetailResponse as AmazonProductDetailResponse, type AmazonProductParams, type ProductVariant as AmazonProductVariant, ProductsClient$1 as AmazonProductsClient, type RatingBreakdown$1 as AmazonRatingBreakdown, ReferenceClient$2 as AmazonReferenceClient, type RelatedProduct as AmazonRelatedProduct, type Review as AmazonReview, type ReviewProfile as AmazonReviewProfile, type AmazonReviewsParams, type ReviewsResponse as AmazonReviewsResponse, SearchClient$2 as AmazonSearchClient, type AmazonSearchParams, type SearchResponse as AmazonSearchResponse, type SearchResult$1 as AmazonSearchResult, type Seller as AmazonSeller, type SellerFeedbackEntry as AmazonSellerFeedbackEntry, type SellerFeedbackResponse as AmazonSellerFeedbackResponse, type SellerFeedbackSummary as AmazonSellerFeedbackSummary, type AmazonSellerListParams, type AmazonSellerParams, type SellerProductsResponse as AmazonSellerProductsResponse, type SellerProfileResponse as AmazonSellerProfileResponse, SellersClient as AmazonSellersClient, type AutocompleteParams, type DetectOptions, type DetectResult, type DomainPostsResponse, type FinanceQuoteParams, type FlightsSearchParams, type FlightsStopsFilter, type FlightsTravelClass, type FlightsTripType, AiModeClient as GoogleAiModeClient, AutocompleteClient as GoogleAutocompleteClient, GoogleClient, FinanceClient as GoogleFinanceClient, FlightsClient as GoogleFlightsClient, HotelsClient as GoogleHotelsClient, ImagesClient as GoogleImagesClient, JobsClient as GoogleJobsClient, LensClient as GoogleLensClient, MapsClient as GoogleMapsClient, NewsClient as GoogleNewsClient, PatentsClient as GooglePatentsClient, ProductsClient$2 as GoogleProductsClient, type GoogleResponse, ScholarClient as GoogleScholarClient, SearchClient$4 as GoogleSearchClient, type GoogleSearchParams, ShoppingClient as GoogleShoppingClient, ShortsClient as GoogleShortsClient, TrendsClient as GoogleTrendsClient, VideosClient$1 as GoogleVideosClient, type HotelsDetailsParams, type HotelsSearchParams, type ImagesSearchParams, type JobsSearchParams, type LensSearchParams, type MapsPhotosParams, type MapsPlaceParams, type MapsPostsParams, type MapsReviewsParams, type MapsSearchParams, type NewsSearchParams, type NewsTopicsParams, type NewsTrendingParams, type PatentsDetailParams, type PatentsSearchParams, type PopularSubredditsResponse, type PostCommentsResponse, type PostDetailResponse, type PostDuplicatesResponse, type ProductsDetailParams, type RedditAward, RedditClient, type RedditComment, type RedditModeratedSubreddit, type RedditPagination, type RedditPost, PostsClient as RedditPostsClient, type RedditRule, SearchClient$3 as RedditSearchClient, type RedditSubreddit, SubredditsClient as RedditSubredditsClient, type RedditTrophy, type RedditUser, type UserProfileResponse as RedditUserProfileResponse, type RedditUserSubreddit, UsersClient$1 as RedditUsersClient, type RedditWikiPage, type ScholarAuthorCitationParams, type ScholarAuthorParams, type ScholarCiteParams, type ScholarProfilesParams, type ScholarSearchParams, ScrapeBadger, ScrapeBadgerConfig, type ScrapeOptions, type ScrapeResult, type SearchPostsResponse, type SearchSubredditsResponse, type SearchUsersResponse, type ShopeeCategoriesParams, type ShopeeCategoryItemsParams, type CategoryNode as ShopeeCategoryNode, type CategoryTree as ShopeeCategoryTree, ShopeeClient, type ShopeeMarket, type MarketsResponse as ShopeeMarketsResponse, type ShopeeProduct, type ProductAttribute as ShopeeProductAttribute, type ProductImage as ShopeeProductImage, type ProductModel as ShopeeProductModel, type ShopeeProductParams, ProductsClient as ShopeeProductsClient, type RatingBreakdown as ShopeeRatingBreakdown, ReferenceClient$1 as ShopeeReferenceClient, type ShopeeReview, type ReviewReply as ShopeeReviewReply, type ReviewSummary as ShopeeReviewSummary, ReviewsClient as ShopeeReviewsClient, type ShopeeReviewsParams, type ReviewsResult as ShopeeReviewsResult, SearchClient$1 as ShopeeSearchClient, type ShopeeSearchParams, type SearchResult as ShopeeSearchResult, type ShoppingClickParams, type ShoppingProductParams, type ShoppingSearchParams, type ShortsSearchParams, type SubredditDetailResponse, type SubredditPostsResponse, type SubredditRulesResponse, type SubredditWikiPagesResponse, type TikTokAd, type AdLibraryPage as TikTokAdLibraryPage, type AdLibrarySearchResponse as TikTokAdLibrarySearchResponse, type TikTokAdSearchParams, type TikTokAdVideo, AdsClient as TikTokAdsClient, type TikTokAnchor, type TikTokAuthor, type TikTokChallenge, TikTokClient, type TikTokComment, type CommentListResponse as TikTokCommentListResponse, type TikTokCommentRepliesParams, type TikTokCommentsParams, type TikTokCursorPage, type TikTokEffectSticker, type TikTokHashtag, type TikTokHashtagParams, type HashtagResponse as TikTokHashtagResponse, type HashtagSearchResponse as TikTokHashtagSearchResponse, HashtagsClient as TikTokHashtagsClient, type TikTokListVideosParams, type TikTokMusic, MusicClient as TikTokMusicClient, type TikTokMusicParams, type MusicResponse as TikTokMusicResponse, type TikTokOEmbed, type TikTokOEmbedParams, type ProfileResponse as TikTokProfileResponse, ReferenceClient as TikTokReferenceClient, type RegionInfo as TikTokRegionInfo, type RegionsResponse as TikTokRegionsResponse, type TikTokRelatedParams, SearchClient as TikTokSearchClient, type TikTokSearchParams, type TikTokStats, type TikTokSubtitle, type TikTokTextExtra, type TikTokTranscriptParams, type TranscriptResponse as TikTokTranscriptResponse, TrendingClient as TikTokTrendingClient, type TikTokTrendingHashtag, type TrendingHashtagsResponse as TikTokTrendingHashtagsResponse, type TikTokTrendingParams, type TikTokTrendingSong, type TrendingSongsResponse as TikTokTrendingSongsResponse, type TikTokTrendingVideosParams, type TikTokUser, type TikTokUserListParams, type UserListResponse as TikTokUserListResponse, type TikTokUserParams, type UserSearchResponse as TikTokUserSearchResponse, type TikTokUserStats, UsersClient as TikTokUsersClient, type TikTokVideo, type TikTokVideoControl, type VideoListResponse as TikTokVideoListResponse, type TikTokVideoMeta, type TikTokVideoParams, type VideoResponse as TikTokVideoResponse, type TikTokVideoStatus, VideosClient as TikTokVideosClient, type TrendingPostsResponse, type TrendsAutocompleteParams, type TrendsInterestParams, type TrendsRegionsParams, type TrendsRelatedParams, type TrendsTrendingParams, TwitterClient, type UserCommentsResponse, type UserModeratedResponse, type UserPostsResponse, type UserTrophiesResponse, type VideosSearchParams, type VintedBrand, type BrandsResponse as VintedBrandsResponse, VintedClient, type VintedColor, type ColorsResponse as VintedColorsResponse, type VintedItemDetail, type ItemDetailResponse as VintedItemDetailResponse, type VintedItemSummary, ItemsClient as VintedItemsClient, type VintedMarket, type MarketsResponse$2 as VintedMarketsResponse, type VintedPagination, type VintedPhoto, type VintedPrice, ReferenceClient$3 as VintedReferenceClient, SearchClient$5 as VintedSearchClient, type VintedSearchParams, type SearchResponse$1 as VintedSearchResponse, type VintedSellerSummary, type VintedStatus, type StatusesResponse as VintedStatusesResponse, type UserItemsResponse as VintedUserItemsResponse, type VintedUserProfile, type UserProfileResponse$1 as VintedUserProfileResponse, type VintedUserSummary, UsersClient$2 as VintedUsersClient, WebClient, type WikiPageResponse };
6801
+ 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 };