scavio 0.10.0 → 0.12.0

package/dist/index.d.cts

@@ -1,49 +1,45 @@
+/**
+ * Amazon moved to a new upstream in 2026-07 and the API now returns a
+ * normalized shape instead of the old raw provider payload. Nine options went
+ * with the old provider: language, currency, device, sort_by, pages,
+ * category_id, merchant_id, zip_code and autoselect_variant. They are removed
+ * rather than kept as no-ops - notably `sort_by`, which the marketplace was
+ * verified to ignore entirely (every sort value returned the same unordered
+ * set). Sending a retired option anyway still returns 200, with a top-level
+ * `warnings` array naming what was ignored.
+ *
+ * `country` is the canonical marketplace selector; `domain` and `start_page`
+ * remain as deprecated aliases because published SDK versions send them.
+ */
 interface AmazonSearchOptions {
     /** Product search query (1-500 characters). */
     query: string;
-    /** Amazon domain suffix (default 'com', e.g. 'co.uk'). */
-    domain?: string;
-    /** Country code for localization. */
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
     country?: string;
-    /** Language code. */
-    language?: string;
-    /** Currency code (ISO 4217, e.g. 'USD'). */
-    currency?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** Result sort order. */
-    sort_by?: "most_recent" | "price_low_to_high" | "price_high_to_low" | "featured" | "average_review" | "bestsellers";
-    /** Starting page (1-indexed). */
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
+    domain?: string;
+    /** Results page, 1-based. One page per call, 1 credit each. */
+    page?: number;
+    /** @deprecated Alias for `page`. */
     start_page?: number;
-    /** Number of pages to fetch. */
-    pages?: number;
-    /** Amazon category id. */
-    category_id?: string;
-    /** Filter to a specific merchant. */
-    merchant_id?: string;
-    /** ZIP/postal code for localized pricing. */
-    zip_code?: string;
-    /** Auto-select the default variant. */
-    autoselect_variant?: boolean;
     [key: string]: unknown;
 }
 interface AmazonProductOptions {
     /** Amazon ASIN (e.g. 'B09XS7JWHH'). Sent to the API as 'query'. */
     asin: string;
-    /** Amazon domain suffix (default 'com'). */
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
+    country?: string;
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
     domain?: string;
-    /** Country code for localization. */
+    [key: string]: unknown;
+}
+interface AmazonOffersOptions {
+    /** Amazon ASIN (e.g. 'B09XS7JWHH'). Sent to the API as 'query'. */
+    asin: string;
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
     country?: string;
-    /** Language code. */
-    language?: string;
-    /** Currency code (ISO 4217, e.g. 'USD'). */
-    currency?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** ZIP/postal code for localized pricing. */
-    zip_code?: string;
-    /** Auto-select the default variant. */
-    autoselect_variant?: boolean;
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
+    domain?: string;
     [key: string]: unknown;
 }
 declare class AmazonNamespace {
@@ -51,7 +47,12 @@ declare class AmazonNamespace {
     constructor(client: Scavio);
     search(options: AmazonSearchOptions): Promise<Record<string, unknown>>;
     product(options: AmazonProductOptions): Promise<Record<string, unknown>>;
-    /** Supported Amazon domains, languages, currencies, and countries. */
+    /** Every seller offer for one ASIN: price, seller, condition, shipping, and
+     *  which offer holds the buy box. Page 1 only. */
+    offers(options: AmazonOffersOptions): Promise<Record<string, unknown>>;
+    /** Supported Amazon marketplaces, as `domains` and `countries`. `languages`
+     *  and `currencies` remain in the payload but are always empty: neither is a
+     *  request parameter any more. */
     options(): Promise<Record<string, unknown>>;
 }
 
@@ -1158,6 +1159,12 @@ interface LinkedInPersonOptions {
     url?: string;
     [key: string]: unknown;
 }
+interface LinkedInPersonPostsRequest extends LinkedInPersonOptions {
+    /** Which feed: the member's own posts (default), posts they commented on, or posts they reacted to. */
+    type?: "posts" | "comments" | "reactions";
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
 /** A company reference: a universal name (slug), or a full company URL. */
 interface LinkedInCompanyOptions {
     /** Company universal name (slug), e.g. "microsoft". */
@@ -1166,17 +1173,23 @@ interface LinkedInCompanyOptions {
     url?: string;
     [key: string]: unknown;
 }
+interface LinkedInCompanyPostsRequest extends LinkedInCompanyOptions {
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
 /** @deprecated Use {@link LinkedInPersonOptions}. */
 type LinkedInPersonRefOptions = LinkedInPersonOptions;
-/** @deprecated Use {@link LinkedInPersonOptions}. */
-type LinkedInPersonPostsOptions = LinkedInPersonOptions;
-/** @deprecated Use {@link LinkedInCompanyOptions}. */
-type LinkedInCompanyPostsOptions = LinkedInCompanyOptions;
+/** @deprecated Use {@link LinkedInPersonPostsRequest}. */
+type LinkedInPersonPostsOptions = LinkedInPersonPostsRequest;
+/** @deprecated Use {@link LinkedInCompanyPostsRequest}. */
+type LinkedInCompanyPostsOptions = LinkedInCompanyPostsRequest;
 interface LinkedInSearchJobsOptions {
     /** Search keyword. */
     search: string;
     /** Geographic filter; omit to search everywhere. */
     location?: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
     [key: string]: unknown;
 }
 interface LinkedInJobOptions {
@@ -1194,7 +1207,7 @@ interface LinkedInPostOptions {
     [key: string]: unknown;
 }
 interface LinkedInPostCommentsOptions extends LinkedInPostOptions {
-    /** 1-based page number, 10 comments per page. */
+    /** 1-based page number. Page size varies, so page until a page comes back empty. */
     page?: number;
 }
 /** @deprecated Retired upstream; always returns HTTP 410. */
@@ -1229,19 +1242,25 @@ declare class LinkedInNamespace {
     person(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
     /** The about-only slice of the profile payload. */
     personAbout(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
-    /** Recent posts, up to 50. Upstream exposes no further pages. */
-    personPosts(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
+    /**
+     * A member's posts, or the posts they commented on or reacted to via `type`.
+     * 50 per page; pass the previous response's `next_cursor` to advance.
+     */
+    personPosts(options: LinkedInPersonPostsRequest): Promise<Record<string, unknown>>;
     /** Company profile, including locations and featured employees. */
     company(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
-    /** Recent company posts, up to 50. Upstream exposes no further pages. */
-    companyPosts(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
-    /** Job search. Upstream rotates its result set, so repeat calls differ. */
+    /** Recent company posts, 50 per page; advance with `next_cursor`. */
+    companyPosts(options: LinkedInCompanyPostsRequest): Promise<Record<string, unknown>>;
+    /**
+     * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
+     * result set, so pages overlap slightly - dedupe by job id.
+     */
     searchJobs(options: LinkedInSearchJobsOptions): Promise<Record<string, unknown>>;
     /** Full detail for one job listing, including the hiring company. */
     job(options: LinkedInJobOptions): Promise<Record<string, unknown>>;
     /** Full detail for one post, including its top visible comments. */
     post(options: LinkedInPostOptions): Promise<Record<string, unknown>>;
-    /** Comments with their replies, 10 per page. */
+    /** Comments with their replies. Page size varies - keep paging until empty. */
     postComments(options: LinkedInPostCommentsOptions): Promise<Record<string, unknown>>;
     /**
      * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
@@ -1353,4 +1372,4 @@ declare class ScavioAPIError extends ScavioError {
     constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
 }
 
-export { type AmazonProductOptions, type AmazonSearchOptions, BadRequestError, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, type GoogleNewsOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyRefOptions, type LinkedInJobOptions, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RedditCommentRepliesOptions, type RedditFeedSort, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPostsOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type WalmartProductOptions, type WalmartSearchOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions };
+export { type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, BadRequestError, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, type GoogleNewsOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyRefOptions, type LinkedInJobOptions, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RedditCommentRepliesOptions, type RedditFeedSort, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPostsOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type WalmartProductOptions, type WalmartSearchOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions };

package/dist/index.d.ts

@@ -1,49 +1,45 @@
+/**
+ * Amazon moved to a new upstream in 2026-07 and the API now returns a
+ * normalized shape instead of the old raw provider payload. Nine options went
+ * with the old provider: language, currency, device, sort_by, pages,
+ * category_id, merchant_id, zip_code and autoselect_variant. They are removed
+ * rather than kept as no-ops - notably `sort_by`, which the marketplace was
+ * verified to ignore entirely (every sort value returned the same unordered
+ * set). Sending a retired option anyway still returns 200, with a top-level
+ * `warnings` array naming what was ignored.
+ *
+ * `country` is the canonical marketplace selector; `domain` and `start_page`
+ * remain as deprecated aliases because published SDK versions send them.
+ */
 interface AmazonSearchOptions {
     /** Product search query (1-500 characters). */
     query: string;
-    /** Amazon domain suffix (default 'com', e.g. 'co.uk'). */
-    domain?: string;
-    /** Country code for localization. */
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
     country?: string;
-    /** Language code. */
-    language?: string;
-    /** Currency code (ISO 4217, e.g. 'USD'). */
-    currency?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** Result sort order. */
-    sort_by?: "most_recent" | "price_low_to_high" | "price_high_to_low" | "featured" | "average_review" | "bestsellers";
-    /** Starting page (1-indexed). */
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
+    domain?: string;
+    /** Results page, 1-based. One page per call, 1 credit each. */
+    page?: number;
+    /** @deprecated Alias for `page`. */
     start_page?: number;
-    /** Number of pages to fetch. */
-    pages?: number;
-    /** Amazon category id. */
-    category_id?: string;
-    /** Filter to a specific merchant. */
-    merchant_id?: string;
-    /** ZIP/postal code for localized pricing. */
-    zip_code?: string;
-    /** Auto-select the default variant. */
-    autoselect_variant?: boolean;
     [key: string]: unknown;
 }
 interface AmazonProductOptions {
     /** Amazon ASIN (e.g. 'B09XS7JWHH'). Sent to the API as 'query'. */
     asin: string;
-    /** Amazon domain suffix (default 'com'). */
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
+    country?: string;
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
     domain?: string;
-    /** Country code for localization. */
+    [key: string]: unknown;
+}
+interface AmazonOffersOptions {
+    /** Amazon ASIN (e.g. 'B09XS7JWHH'). Sent to the API as 'query'. */
+    asin: string;
+    /** Marketplace country code (ISO 3166-1 alpha-2, e.g. 'us', 'gb', 'de'). Defaults to 'us'. */
     country?: string;
-    /** Language code. */
-    language?: string;
-    /** Currency code (ISO 4217, e.g. 'USD'). */
-    currency?: string;
-    /** Device to emulate. */
-    device?: "desktop" | "mobile" | "tablet";
-    /** ZIP/postal code for localized pricing. */
-    zip_code?: string;
-    /** Auto-select the default variant. */
-    autoselect_variant?: boolean;
+    /** @deprecated Amazon domain suffix ('com', 'co.uk'). Use `country` instead. */
+    domain?: string;
     [key: string]: unknown;
 }
 declare class AmazonNamespace {
@@ -51,7 +47,12 @@ declare class AmazonNamespace {
     constructor(client: Scavio);
     search(options: AmazonSearchOptions): Promise<Record<string, unknown>>;
     product(options: AmazonProductOptions): Promise<Record<string, unknown>>;
-    /** Supported Amazon domains, languages, currencies, and countries. */
+    /** Every seller offer for one ASIN: price, seller, condition, shipping, and
+     *  which offer holds the buy box. Page 1 only. */
+    offers(options: AmazonOffersOptions): Promise<Record<string, unknown>>;
+    /** Supported Amazon marketplaces, as `domains` and `countries`. `languages`
+     *  and `currencies` remain in the payload but are always empty: neither is a
+     *  request parameter any more. */
     options(): Promise<Record<string, unknown>>;
 }
 
@@ -1158,6 +1159,12 @@ interface LinkedInPersonOptions {
     url?: string;
     [key: string]: unknown;
 }
+interface LinkedInPersonPostsRequest extends LinkedInPersonOptions {
+    /** Which feed: the member's own posts (default), posts they commented on, or posts they reacted to. */
+    type?: "posts" | "comments" | "reactions";
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
 /** A company reference: a universal name (slug), or a full company URL. */
 interface LinkedInCompanyOptions {
     /** Company universal name (slug), e.g. "microsoft". */
@@ -1166,17 +1173,23 @@ interface LinkedInCompanyOptions {
     url?: string;
     [key: string]: unknown;
 }
+interface LinkedInCompanyPostsRequest extends LinkedInCompanyOptions {
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
+}
 /** @deprecated Use {@link LinkedInPersonOptions}. */
 type LinkedInPersonRefOptions = LinkedInPersonOptions;
-/** @deprecated Use {@link LinkedInPersonOptions}. */
-type LinkedInPersonPostsOptions = LinkedInPersonOptions;
-/** @deprecated Use {@link LinkedInCompanyOptions}. */
-type LinkedInCompanyPostsOptions = LinkedInCompanyOptions;
+/** @deprecated Use {@link LinkedInPersonPostsRequest}. */
+type LinkedInPersonPostsOptions = LinkedInPersonPostsRequest;
+/** @deprecated Use {@link LinkedInCompanyPostsRequest}. */
+type LinkedInCompanyPostsOptions = LinkedInCompanyPostsRequest;
 interface LinkedInSearchJobsOptions {
     /** Search keyword. */
     search: string;
     /** Geographic filter; omit to search everywhere. */
     location?: string;
+    /** Opaque cursor from a previous response's next_cursor. */
+    cursor?: string;
     [key: string]: unknown;
 }
 interface LinkedInJobOptions {
@@ -1194,7 +1207,7 @@ interface LinkedInPostOptions {
     [key: string]: unknown;
 }
 interface LinkedInPostCommentsOptions extends LinkedInPostOptions {
-    /** 1-based page number, 10 comments per page. */
+    /** 1-based page number. Page size varies, so page until a page comes back empty. */
     page?: number;
 }
 /** @deprecated Retired upstream; always returns HTTP 410. */
@@ -1229,19 +1242,25 @@ declare class LinkedInNamespace {
     person(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
     /** The about-only slice of the profile payload. */
     personAbout(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
-    /** Recent posts, up to 50. Upstream exposes no further pages. */
-    personPosts(options: LinkedInPersonOptions): Promise<Record<string, unknown>>;
+    /**
+     * A member's posts, or the posts they commented on or reacted to via `type`.
+     * 50 per page; pass the previous response's `next_cursor` to advance.
+     */
+    personPosts(options: LinkedInPersonPostsRequest): Promise<Record<string, unknown>>;
     /** Company profile, including locations and featured employees. */
     company(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
-    /** Recent company posts, up to 50. Upstream exposes no further pages. */
-    companyPosts(options: LinkedInCompanyOptions): Promise<Record<string, unknown>>;
-    /** Job search. Upstream rotates its result set, so repeat calls differ. */
+    /** Recent company posts, 50 per page; advance with `next_cursor`. */
+    companyPosts(options: LinkedInCompanyPostsRequest): Promise<Record<string, unknown>>;
+    /**
+     * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
+     * result set, so pages overlap slightly - dedupe by job id.
+     */
     searchJobs(options: LinkedInSearchJobsOptions): Promise<Record<string, unknown>>;
     /** Full detail for one job listing, including the hiring company. */
     job(options: LinkedInJobOptions): Promise<Record<string, unknown>>;
     /** Full detail for one post, including its top visible comments. */
     post(options: LinkedInPostOptions): Promise<Record<string, unknown>>;
-    /** Comments with their replies, 10 per page. */
+    /** Comments with their replies. Page size varies - keep paging until empty. */
     postComments(options: LinkedInPostCommentsOptions): Promise<Record<string, unknown>>;
     /**
      * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
@@ -1353,4 +1372,4 @@ declare class ScavioAPIError extends ScavioError {
     constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
 }
 
-export { type AmazonProductOptions, type AmazonSearchOptions, BadRequestError, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, type GoogleNewsOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyRefOptions, type LinkedInJobOptions, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RedditCommentRepliesOptions, type RedditFeedSort, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPostsOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type WalmartProductOptions, type WalmartSearchOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions };
+export { type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, BadRequestError, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, type GoogleNewsOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyRefOptions, type LinkedInJobOptions, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RedditCommentRepliesOptions, type RedditFeedSort, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, type TikTokShopProductOptions, type TikTokShopProductReviewsOptions, type TikTokShopRegion, type TikTokShopResolveOptions, type TikTokShopReviewSort, type TikTokShopSearchOptions, type TikTokShopShopProductsOptions, type TikTokShopSuggestionsOptions, type TikTokUserFollowersOptions, type TikTokUserFollowingsOptions, type TikTokUserPostsOptions, type TikTokVideoCommentsOptions, type TikTokVideoOptions, type WalmartProductOptions, type WalmartSearchOptions, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions };

package/dist/index.js

@@ -275,7 +275,18 @@ var AmazonNamespace = class {
       ...rest
     });
   }
-  /** Supported Amazon domains, languages, currencies, and countries. */
+  /** Every seller offer for one ASIN: price, seller, condition, shipping, and
+   *  which offer holds the buy box. Page 1 only. */
+  async offers(options) {
+    const { asin, ...rest } = options;
+    return this.client._post("/api/v1/amazon/offers", {
+      query: asin,
+      ...rest
+    });
+  }
+  /** Supported Amazon marketplaces, as `domains` and `countries`. `languages`
+   *  and `currencies` remain in the payload but are always empty: neither is a
+   *  request parameter any more. */
   async options() {
     return this.client._get("/api/v1/amazon/options");
   }
@@ -728,7 +739,10 @@ var LinkedInNamespace = class {
   async personAbout(options) {
     return this.client._post("/api/v1/linkedin/person/about", options);
   }
-  /** Recent posts, up to 50. Upstream exposes no further pages. */
+  /**
+   * A member's posts, or the posts they commented on or reacted to via `type`.
+   * 50 per page; pass the previous response's `next_cursor` to advance.
+   */
   async personPosts(options) {
     return this.client._post("/api/v1/linkedin/person/posts", options);
   }
@@ -736,11 +750,14 @@ var LinkedInNamespace = class {
   async company(options) {
     return this.client._post("/api/v1/linkedin/company", options);
   }
-  /** Recent company posts, up to 50. Upstream exposes no further pages. */
+  /** Recent company posts, 50 per page; advance with `next_cursor`. */
   async companyPosts(options) {
     return this.client._post("/api/v1/linkedin/company/posts", options);
   }
-  /** Job search. Upstream rotates its result set, so repeat calls differ. */
+  /**
+   * Job search, 25 per page; advance with `next_cursor`. Upstream rotates its
+   * result set, so pages overlap slightly - dedupe by job id.
+   */
   async searchJobs(options) {
     return this.client._post("/api/v1/linkedin/search/jobs", options);
   }
@@ -752,7 +769,7 @@ var LinkedInNamespace = class {
   async post(options) {
     return this.client._post("/api/v1/linkedin/post", options);
   }
-  /** Comments with their replies, 10 per page. */
+  /** Comments with their replies. Page size varies - keep paging until empty. */
   async postComments(options) {
     return this.client._post("/api/v1/linkedin/post/comments", options);
   }