scavio 0.20.0 → 0.21.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/README.md +61 -12
- package/dist/index.cjs +75 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +165 -3
- package/dist/index.d.ts +165 -3
- package/dist/index.js +74 -1
- package/dist/index.js.map +1 -1
- package/package.json +4 -2
package/dist/index.d.cts
CHANGED
|
@@ -4615,7 +4615,10 @@ interface RealtorSearchOptions {
|
|
|
4615
4615
|
sold_within_days?: number;
|
|
4616
4616
|
/** Only listings with a price cut in the last N days (1-3650). */
|
|
4617
4617
|
price_reduced_within_days?: number;
|
|
4618
|
-
/**
|
|
4618
|
+
/**
|
|
4619
|
+
* Only listings whose listing text contains ALL of these keywords, up to 10
|
|
4620
|
+
* (e.g. ["workshop"]); each extra keyword narrows the results.
|
|
4621
|
+
*/
|
|
4619
4622
|
keywords?: string[];
|
|
4620
4623
|
/** Only new construction. */
|
|
4621
4624
|
new_construction?: boolean;
|
|
@@ -4795,7 +4798,7 @@ interface RightmoveSearchOptions {
|
|
|
4795
4798
|
let_type?: RightmoveLetType;
|
|
4796
4799
|
/** Result order (default "newest"). */
|
|
4797
4800
|
sort?: RightmoveSort;
|
|
4798
|
-
/** Results page, 1-42 (24 per page). */
|
|
4801
|
+
/** Results page, 1-42 (24-25 per page). */
|
|
4799
4802
|
page?: number;
|
|
4800
4803
|
[key: string]: unknown;
|
|
4801
4804
|
}
|
|
@@ -4923,6 +4926,164 @@ declare class RightmoveNamespace {
|
|
|
4923
4926
|
agent(options: RightmoveAgentOptions): Promise<Record<string, unknown>>;
|
|
4924
4927
|
}
|
|
4925
4928
|
|
|
4929
|
+
type MercadoLibreCountry = "mx" | "br" | "ar" | "co";
|
|
4930
|
+
type MercadoLibreBestSellersCountry = "mx" | "ar" | "co";
|
|
4931
|
+
type MercadoLibreCondition = "new" | "used" | "refurbished" | "open_box";
|
|
4932
|
+
type MercadoLibreSort = "relevance" | "price_asc" | "price_desc";
|
|
4933
|
+
type MercadoLibreDiscount = 5 | 10 | 15 | 20 | 25 | 30 | 40;
|
|
4934
|
+
/** Pass country and one of query, seller_id or seller_nickname. */
|
|
4935
|
+
interface MercadoLibreSearchOptions {
|
|
4936
|
+
/** Mexico (mx), Brazil (br, Mercado Livre), Argentina (ar) or Colombia (co). Chile is not supported. */
|
|
4937
|
+
country: MercadoLibreCountry;
|
|
4938
|
+
/**
|
|
4939
|
+
* Keywords (1-200 characters). Mercado Libre may narrow a query to a
|
|
4940
|
+
* category, brand or line on its own; the response lists those in
|
|
4941
|
+
* auto_applied_filters.
|
|
4942
|
+
*/
|
|
4943
|
+
query?: string;
|
|
4944
|
+
/**
|
|
4945
|
+
* Only this seller's listings (numeric id, as returned in product's
|
|
4946
|
+
* seller.seller_id). Combines with query, filters, sort and page.
|
|
4947
|
+
*/
|
|
4948
|
+
seller_id?: string;
|
|
4949
|
+
/**
|
|
4950
|
+
* A seller's public nickname. Returns the seller's first page of listings
|
|
4951
|
+
* without filters, plus their seller_id; use seller_id for filters, sort and
|
|
4952
|
+
* further pages.
|
|
4953
|
+
*/
|
|
4954
|
+
seller_nickname?: string;
|
|
4955
|
+
/**
|
|
4956
|
+
* Item condition. Without it, Mercado Libre may show new items only for some
|
|
4957
|
+
* queries (listed in auto_applied_filters).
|
|
4958
|
+
*/
|
|
4959
|
+
condition?: MercadoLibreCondition;
|
|
4960
|
+
/** Minimum price in the country's currency (MXN, BRL, ARS or COP). */
|
|
4961
|
+
min_price?: number;
|
|
4962
|
+
/** Maximum price in the country's currency. */
|
|
4963
|
+
max_price?: number;
|
|
4964
|
+
/** Only listings at least this many percent off: 5, 10, 15, 20, 25, 30 or 40. */
|
|
4965
|
+
min_discount?: MercadoLibreDiscount;
|
|
4966
|
+
/** Only listings with free shipping. */
|
|
4967
|
+
free_shipping?: boolean;
|
|
4968
|
+
/** Only listings shipped by Mercado Libre Full fulfillment. */
|
|
4969
|
+
full_fulfillment?: boolean;
|
|
4970
|
+
/** Only listings from official brand stores. */
|
|
4971
|
+
official_stores_only?: boolean;
|
|
4972
|
+
/** Only listings payable in interest-free installments. */
|
|
4973
|
+
interest_free_installments?: boolean;
|
|
4974
|
+
/** relevance (default), price_asc or price_desc. Mercado Libre offers no newest or best-selling sort. */
|
|
4975
|
+
sort?: MercadoLibreSort;
|
|
4976
|
+
/**
|
|
4977
|
+
* Results page, 1-42 (about 48 per page, so about 2,000 results per query).
|
|
4978
|
+
* Narrow by price range, condition or seller to reach more.
|
|
4979
|
+
*/
|
|
4980
|
+
page?: number;
|
|
4981
|
+
[key: string]: unknown;
|
|
4982
|
+
}
|
|
4983
|
+
/** Pass exactly one of url, product_id or item_id. */
|
|
4984
|
+
interface MercadoLibreProductOptions {
|
|
4985
|
+
/** Catalog product id, as returned in product_id by search() (e.g. "MLM1027172667"). */
|
|
4986
|
+
product_id?: string;
|
|
4987
|
+
/** Item (listing) id, as returned in item_id by search() (e.g. "MLM2746152281"; "MLM-2746152281" works too). */
|
|
4988
|
+
item_id?: string;
|
|
4989
|
+
/** A Mercado Libre or Mercado Livre product (/p/), user product (/up/) or listing page URL. */
|
|
4990
|
+
url?: string;
|
|
4991
|
+
[key: string]: unknown;
|
|
4992
|
+
}
|
|
4993
|
+
/** Pass exactly one of url, product_id or item_id. */
|
|
4994
|
+
interface MercadoLibreReviewsOptions {
|
|
4995
|
+
/** Catalog product id, as returned in product_id by search(). */
|
|
4996
|
+
product_id?: string;
|
|
4997
|
+
/** Item (listing) id, as returned in item_id by search(). */
|
|
4998
|
+
item_id?: string;
|
|
4999
|
+
/** A Mercado Libre or Mercado Livre product (/p/), user product (/up/) or listing page URL. */
|
|
5000
|
+
url?: string;
|
|
5001
|
+
/** Only reviews with this star rating (1-5). */
|
|
5002
|
+
rating?: 1 | 2 | 3 | 4 | 5;
|
|
5003
|
+
/** Reviews page, 1-based (up to 15 per page; a page past the last one comes back empty). */
|
|
5004
|
+
page?: number;
|
|
5005
|
+
[key: string]: unknown;
|
|
5006
|
+
}
|
|
5007
|
+
/** Pass exactly one of item_id or url. */
|
|
5008
|
+
interface MercadoLibreQuestionsOptions {
|
|
5009
|
+
/** Item (listing) id, as returned in item_id by search() (e.g. "MLM3571336480"). */
|
|
5010
|
+
item_id?: string;
|
|
5011
|
+
/**
|
|
5012
|
+
* A listing page URL, or a product (/p/, /up/) URL: a product's questions
|
|
5013
|
+
* are those of the listing in its buy box. Alternative to item_id.
|
|
5014
|
+
*/
|
|
5015
|
+
url?: string;
|
|
5016
|
+
/** Where to start, from next_offset of the previous page. Defaults to 0. */
|
|
5017
|
+
offset?: number;
|
|
5018
|
+
[key: string]: unknown;
|
|
5019
|
+
}
|
|
5020
|
+
interface MercadoLibreBestSellersOptions {
|
|
5021
|
+
/**
|
|
5022
|
+
* Category id, as returned in category_id or category_path by search(), or
|
|
5023
|
+
* category_id by product() (e.g. "MLM1055"). Its prefix must match the country.
|
|
5024
|
+
*/
|
|
5025
|
+
category_id: string;
|
|
5026
|
+
/** mx, ar or co. Not available for Brazil. */
|
|
5027
|
+
country: MercadoLibreBestSellersCountry;
|
|
5028
|
+
[key: string]: unknown;
|
|
5029
|
+
}
|
|
5030
|
+
declare class MercadoLibreNamespace {
|
|
5031
|
+
private client;
|
|
5032
|
+
constructor(client: Scavio);
|
|
5033
|
+
/**
|
|
5034
|
+
* Search Mercado Libre listings in Mexico, Brazil (Mercado Livre), Argentina
|
|
5035
|
+
* or Colombia by keyword or seller, with condition, price range, discount,
|
|
5036
|
+
* free shipping, Full fulfillment, official stores and interest-free
|
|
5037
|
+
* installment filters, sorted by relevance or price. Each row has price,
|
|
5038
|
+
* list price, discount, installments, seller and official-store flag where
|
|
5039
|
+
* shown, rating, units sold as a lower bound ("at least 500"), shipping
|
|
5040
|
+
* flags, a sponsored flag and catalog ids. About 48 rows per page and 42
|
|
5041
|
+
* pages (about 2,000 results) per query.
|
|
5042
|
+
*
|
|
5043
|
+
* Costs 2 credits.
|
|
5044
|
+
*/
|
|
5045
|
+
search(options: MercadoLibreSearchOptions): Promise<Record<string, unknown>>;
|
|
5046
|
+
/**
|
|
5047
|
+
* One Mercado Libre catalog product or listing: title, price, list price,
|
|
5048
|
+
* installments, promotions, the buy-box seller with reputation level and
|
|
5049
|
+
* seller tier, stock, shipping, rating with its star distribution,
|
|
5050
|
+
* variations with sibling product ids, specs, description, pictures and
|
|
5051
|
+
* categories. Only the buy-box seller is returned; units sold is a lower
|
|
5052
|
+
* bound. Some fields are null where the page omits them. Pass exactly one of
|
|
5053
|
+
* url, product_id or item_id; the id prefix (MLM, MLB, MLA, MCO) sets the
|
|
5054
|
+
* country.
|
|
5055
|
+
*
|
|
5056
|
+
* Costs 2 credits.
|
|
5057
|
+
*/
|
|
5058
|
+
product(options: MercadoLibreProductOptions): Promise<Record<string, unknown>>;
|
|
5059
|
+
/**
|
|
5060
|
+
* One page of up to 15 Mercado Libre product reviews (page until a page
|
|
5061
|
+
* comes back empty), optionally filtered by star rating: rating, text, the
|
|
5062
|
+
* original text when Mercado Libre translated it, exact date, likes, the
|
|
5063
|
+
* review's country and photos. Catalog products pool reviews from several
|
|
5064
|
+
* countries. Totals and the star distribution come from product().
|
|
5065
|
+
*
|
|
5066
|
+
* Costs 1 credit.
|
|
5067
|
+
*/
|
|
5068
|
+
reviews(options: MercadoLibreReviewsOptions): Promise<Record<string, unknown>>;
|
|
5069
|
+
/**
|
|
5070
|
+
* A page of buyer questions on a Mercado Libre listing with the seller's
|
|
5071
|
+
* answers and answer dates (Mercado Libre shows no question dates). Page
|
|
5072
|
+
* through with next_offset. A listing with no public questions returns 404.
|
|
5073
|
+
*
|
|
5074
|
+
* Costs 2 credits.
|
|
5075
|
+
*/
|
|
5076
|
+
questions(options: MercadoLibreQuestionsOptions): Promise<Record<string, unknown>>;
|
|
5077
|
+
/**
|
|
5078
|
+
* The ranked top 20 best sellers in a Mercado Libre category in Mexico,
|
|
5079
|
+
* Argentina or Colombia, with price, discount, installments, rating, units
|
|
5080
|
+
* sold as a lower bound and seller where shown. Not available for Brazil.
|
|
5081
|
+
*
|
|
5082
|
+
* Costs 2 credits.
|
|
5083
|
+
*/
|
|
5084
|
+
bestSellers(options: MercadoLibreBestSellersOptions): Promise<Record<string, unknown>>;
|
|
5085
|
+
}
|
|
5086
|
+
|
|
4926
5087
|
/**
|
|
4927
5088
|
* Default client-side rate limit, safe on every plan including free.
|
|
4928
5089
|
*/
|
|
@@ -5010,6 +5171,7 @@ declare class Scavio {
|
|
|
5010
5171
|
readonly trustpilot: TrustpilotNamespace;
|
|
5011
5172
|
readonly realtor: RealtorNamespace;
|
|
5012
5173
|
readonly rightmove: RightmoveNamespace;
|
|
5174
|
+
readonly mercadolibre: MercadoLibreNamespace;
|
|
5013
5175
|
private readonly apiKey;
|
|
5014
5176
|
private readonly baseUrl;
|
|
5015
5177
|
private readonly timeout;
|
|
@@ -5096,4 +5258,4 @@ declare class ScavioAPIError extends ScavioError {
|
|
|
5096
5258
|
constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
|
|
5097
5259
|
}
|
|
5098
5260
|
|
|
5099
|
-
export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type ExtractOptions, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, TikTokNamespace, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, 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 TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, XNamespace, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions };
|
|
5261
|
+
export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type ExtractOptions, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, TikTokNamespace, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, 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 TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, XNamespace, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions };
|
package/dist/index.d.ts
CHANGED
|
@@ -4615,7 +4615,10 @@ interface RealtorSearchOptions {
|
|
|
4615
4615
|
sold_within_days?: number;
|
|
4616
4616
|
/** Only listings with a price cut in the last N days (1-3650). */
|
|
4617
4617
|
price_reduced_within_days?: number;
|
|
4618
|
-
/**
|
|
4618
|
+
/**
|
|
4619
|
+
* Only listings whose listing text contains ALL of these keywords, up to 10
|
|
4620
|
+
* (e.g. ["workshop"]); each extra keyword narrows the results.
|
|
4621
|
+
*/
|
|
4619
4622
|
keywords?: string[];
|
|
4620
4623
|
/** Only new construction. */
|
|
4621
4624
|
new_construction?: boolean;
|
|
@@ -4795,7 +4798,7 @@ interface RightmoveSearchOptions {
|
|
|
4795
4798
|
let_type?: RightmoveLetType;
|
|
4796
4799
|
/** Result order (default "newest"). */
|
|
4797
4800
|
sort?: RightmoveSort;
|
|
4798
|
-
/** Results page, 1-42 (24 per page). */
|
|
4801
|
+
/** Results page, 1-42 (24-25 per page). */
|
|
4799
4802
|
page?: number;
|
|
4800
4803
|
[key: string]: unknown;
|
|
4801
4804
|
}
|
|
@@ -4923,6 +4926,164 @@ declare class RightmoveNamespace {
|
|
|
4923
4926
|
agent(options: RightmoveAgentOptions): Promise<Record<string, unknown>>;
|
|
4924
4927
|
}
|
|
4925
4928
|
|
|
4929
|
+
type MercadoLibreCountry = "mx" | "br" | "ar" | "co";
|
|
4930
|
+
type MercadoLibreBestSellersCountry = "mx" | "ar" | "co";
|
|
4931
|
+
type MercadoLibreCondition = "new" | "used" | "refurbished" | "open_box";
|
|
4932
|
+
type MercadoLibreSort = "relevance" | "price_asc" | "price_desc";
|
|
4933
|
+
type MercadoLibreDiscount = 5 | 10 | 15 | 20 | 25 | 30 | 40;
|
|
4934
|
+
/** Pass country and one of query, seller_id or seller_nickname. */
|
|
4935
|
+
interface MercadoLibreSearchOptions {
|
|
4936
|
+
/** Mexico (mx), Brazil (br, Mercado Livre), Argentina (ar) or Colombia (co). Chile is not supported. */
|
|
4937
|
+
country: MercadoLibreCountry;
|
|
4938
|
+
/**
|
|
4939
|
+
* Keywords (1-200 characters). Mercado Libre may narrow a query to a
|
|
4940
|
+
* category, brand or line on its own; the response lists those in
|
|
4941
|
+
* auto_applied_filters.
|
|
4942
|
+
*/
|
|
4943
|
+
query?: string;
|
|
4944
|
+
/**
|
|
4945
|
+
* Only this seller's listings (numeric id, as returned in product's
|
|
4946
|
+
* seller.seller_id). Combines with query, filters, sort and page.
|
|
4947
|
+
*/
|
|
4948
|
+
seller_id?: string;
|
|
4949
|
+
/**
|
|
4950
|
+
* A seller's public nickname. Returns the seller's first page of listings
|
|
4951
|
+
* without filters, plus their seller_id; use seller_id for filters, sort and
|
|
4952
|
+
* further pages.
|
|
4953
|
+
*/
|
|
4954
|
+
seller_nickname?: string;
|
|
4955
|
+
/**
|
|
4956
|
+
* Item condition. Without it, Mercado Libre may show new items only for some
|
|
4957
|
+
* queries (listed in auto_applied_filters).
|
|
4958
|
+
*/
|
|
4959
|
+
condition?: MercadoLibreCondition;
|
|
4960
|
+
/** Minimum price in the country's currency (MXN, BRL, ARS or COP). */
|
|
4961
|
+
min_price?: number;
|
|
4962
|
+
/** Maximum price in the country's currency. */
|
|
4963
|
+
max_price?: number;
|
|
4964
|
+
/** Only listings at least this many percent off: 5, 10, 15, 20, 25, 30 or 40. */
|
|
4965
|
+
min_discount?: MercadoLibreDiscount;
|
|
4966
|
+
/** Only listings with free shipping. */
|
|
4967
|
+
free_shipping?: boolean;
|
|
4968
|
+
/** Only listings shipped by Mercado Libre Full fulfillment. */
|
|
4969
|
+
full_fulfillment?: boolean;
|
|
4970
|
+
/** Only listings from official brand stores. */
|
|
4971
|
+
official_stores_only?: boolean;
|
|
4972
|
+
/** Only listings payable in interest-free installments. */
|
|
4973
|
+
interest_free_installments?: boolean;
|
|
4974
|
+
/** relevance (default), price_asc or price_desc. Mercado Libre offers no newest or best-selling sort. */
|
|
4975
|
+
sort?: MercadoLibreSort;
|
|
4976
|
+
/**
|
|
4977
|
+
* Results page, 1-42 (about 48 per page, so about 2,000 results per query).
|
|
4978
|
+
* Narrow by price range, condition or seller to reach more.
|
|
4979
|
+
*/
|
|
4980
|
+
page?: number;
|
|
4981
|
+
[key: string]: unknown;
|
|
4982
|
+
}
|
|
4983
|
+
/** Pass exactly one of url, product_id or item_id. */
|
|
4984
|
+
interface MercadoLibreProductOptions {
|
|
4985
|
+
/** Catalog product id, as returned in product_id by search() (e.g. "MLM1027172667"). */
|
|
4986
|
+
product_id?: string;
|
|
4987
|
+
/** Item (listing) id, as returned in item_id by search() (e.g. "MLM2746152281"; "MLM-2746152281" works too). */
|
|
4988
|
+
item_id?: string;
|
|
4989
|
+
/** A Mercado Libre or Mercado Livre product (/p/), user product (/up/) or listing page URL. */
|
|
4990
|
+
url?: string;
|
|
4991
|
+
[key: string]: unknown;
|
|
4992
|
+
}
|
|
4993
|
+
/** Pass exactly one of url, product_id or item_id. */
|
|
4994
|
+
interface MercadoLibreReviewsOptions {
|
|
4995
|
+
/** Catalog product id, as returned in product_id by search(). */
|
|
4996
|
+
product_id?: string;
|
|
4997
|
+
/** Item (listing) id, as returned in item_id by search(). */
|
|
4998
|
+
item_id?: string;
|
|
4999
|
+
/** A Mercado Libre or Mercado Livre product (/p/), user product (/up/) or listing page URL. */
|
|
5000
|
+
url?: string;
|
|
5001
|
+
/** Only reviews with this star rating (1-5). */
|
|
5002
|
+
rating?: 1 | 2 | 3 | 4 | 5;
|
|
5003
|
+
/** Reviews page, 1-based (up to 15 per page; a page past the last one comes back empty). */
|
|
5004
|
+
page?: number;
|
|
5005
|
+
[key: string]: unknown;
|
|
5006
|
+
}
|
|
5007
|
+
/** Pass exactly one of item_id or url. */
|
|
5008
|
+
interface MercadoLibreQuestionsOptions {
|
|
5009
|
+
/** Item (listing) id, as returned in item_id by search() (e.g. "MLM3571336480"). */
|
|
5010
|
+
item_id?: string;
|
|
5011
|
+
/**
|
|
5012
|
+
* A listing page URL, or a product (/p/, /up/) URL: a product's questions
|
|
5013
|
+
* are those of the listing in its buy box. Alternative to item_id.
|
|
5014
|
+
*/
|
|
5015
|
+
url?: string;
|
|
5016
|
+
/** Where to start, from next_offset of the previous page. Defaults to 0. */
|
|
5017
|
+
offset?: number;
|
|
5018
|
+
[key: string]: unknown;
|
|
5019
|
+
}
|
|
5020
|
+
interface MercadoLibreBestSellersOptions {
|
|
5021
|
+
/**
|
|
5022
|
+
* Category id, as returned in category_id or category_path by search(), or
|
|
5023
|
+
* category_id by product() (e.g. "MLM1055"). Its prefix must match the country.
|
|
5024
|
+
*/
|
|
5025
|
+
category_id: string;
|
|
5026
|
+
/** mx, ar or co. Not available for Brazil. */
|
|
5027
|
+
country: MercadoLibreBestSellersCountry;
|
|
5028
|
+
[key: string]: unknown;
|
|
5029
|
+
}
|
|
5030
|
+
declare class MercadoLibreNamespace {
|
|
5031
|
+
private client;
|
|
5032
|
+
constructor(client: Scavio);
|
|
5033
|
+
/**
|
|
5034
|
+
* Search Mercado Libre listings in Mexico, Brazil (Mercado Livre), Argentina
|
|
5035
|
+
* or Colombia by keyword or seller, with condition, price range, discount,
|
|
5036
|
+
* free shipping, Full fulfillment, official stores and interest-free
|
|
5037
|
+
* installment filters, sorted by relevance or price. Each row has price,
|
|
5038
|
+
* list price, discount, installments, seller and official-store flag where
|
|
5039
|
+
* shown, rating, units sold as a lower bound ("at least 500"), shipping
|
|
5040
|
+
* flags, a sponsored flag and catalog ids. About 48 rows per page and 42
|
|
5041
|
+
* pages (about 2,000 results) per query.
|
|
5042
|
+
*
|
|
5043
|
+
* Costs 2 credits.
|
|
5044
|
+
*/
|
|
5045
|
+
search(options: MercadoLibreSearchOptions): Promise<Record<string, unknown>>;
|
|
5046
|
+
/**
|
|
5047
|
+
* One Mercado Libre catalog product or listing: title, price, list price,
|
|
5048
|
+
* installments, promotions, the buy-box seller with reputation level and
|
|
5049
|
+
* seller tier, stock, shipping, rating with its star distribution,
|
|
5050
|
+
* variations with sibling product ids, specs, description, pictures and
|
|
5051
|
+
* categories. Only the buy-box seller is returned; units sold is a lower
|
|
5052
|
+
* bound. Some fields are null where the page omits them. Pass exactly one of
|
|
5053
|
+
* url, product_id or item_id; the id prefix (MLM, MLB, MLA, MCO) sets the
|
|
5054
|
+
* country.
|
|
5055
|
+
*
|
|
5056
|
+
* Costs 2 credits.
|
|
5057
|
+
*/
|
|
5058
|
+
product(options: MercadoLibreProductOptions): Promise<Record<string, unknown>>;
|
|
5059
|
+
/**
|
|
5060
|
+
* One page of up to 15 Mercado Libre product reviews (page until a page
|
|
5061
|
+
* comes back empty), optionally filtered by star rating: rating, text, the
|
|
5062
|
+
* original text when Mercado Libre translated it, exact date, likes, the
|
|
5063
|
+
* review's country and photos. Catalog products pool reviews from several
|
|
5064
|
+
* countries. Totals and the star distribution come from product().
|
|
5065
|
+
*
|
|
5066
|
+
* Costs 1 credit.
|
|
5067
|
+
*/
|
|
5068
|
+
reviews(options: MercadoLibreReviewsOptions): Promise<Record<string, unknown>>;
|
|
5069
|
+
/**
|
|
5070
|
+
* A page of buyer questions on a Mercado Libre listing with the seller's
|
|
5071
|
+
* answers and answer dates (Mercado Libre shows no question dates). Page
|
|
5072
|
+
* through with next_offset. A listing with no public questions returns 404.
|
|
5073
|
+
*
|
|
5074
|
+
* Costs 2 credits.
|
|
5075
|
+
*/
|
|
5076
|
+
questions(options: MercadoLibreQuestionsOptions): Promise<Record<string, unknown>>;
|
|
5077
|
+
/**
|
|
5078
|
+
* The ranked top 20 best sellers in a Mercado Libre category in Mexico,
|
|
5079
|
+
* Argentina or Colombia, with price, discount, installments, rating, units
|
|
5080
|
+
* sold as a lower bound and seller where shown. Not available for Brazil.
|
|
5081
|
+
*
|
|
5082
|
+
* Costs 2 credits.
|
|
5083
|
+
*/
|
|
5084
|
+
bestSellers(options: MercadoLibreBestSellersOptions): Promise<Record<string, unknown>>;
|
|
5085
|
+
}
|
|
5086
|
+
|
|
4926
5087
|
/**
|
|
4927
5088
|
* Default client-side rate limit, safe on every plan including free.
|
|
4928
5089
|
*/
|
|
@@ -5010,6 +5171,7 @@ declare class Scavio {
|
|
|
5010
5171
|
readonly trustpilot: TrustpilotNamespace;
|
|
5011
5172
|
readonly realtor: RealtorNamespace;
|
|
5012
5173
|
readonly rightmove: RightmoveNamespace;
|
|
5174
|
+
readonly mercadolibre: MercadoLibreNamespace;
|
|
5013
5175
|
private readonly apiKey;
|
|
5014
5176
|
private readonly baseUrl;
|
|
5015
5177
|
private readonly timeout;
|
|
@@ -5096,4 +5258,4 @@ declare class ScavioAPIError extends ScavioError {
|
|
|
5096
5258
|
constructor(statusCode: number, message: string, responseBody?: Record<string, unknown>);
|
|
5097
5259
|
}
|
|
5098
5260
|
|
|
5099
|
-
export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type ExtractOptions, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, TikTokNamespace, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, 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 TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, XNamespace, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions };
|
|
5261
|
+
export { type AirbnbListingOptions, AirbnbNamespace, type AirbnbReviewsOptions, type AirbnbSearchOptions, AmazonNamespace, type AmazonOffersOptions, type AmazonProductOptions, type AmazonSearchOptions, type AppStoreAppOptions, AppStoreNamespace, type AppStoreReviewsOptions, type AppStoreSearchOptions, BadRequestError, type BookingHotelOptions, BookingNamespace, type BookingReviewsOptions, type BookingSearchOptions, CapterraNamespace, type CapterraProductOptions, type CapterraReviewsOptions, type CapterraSearchOptions, type CompaniesHouseCompanyOptions, type CompaniesHouseFilingHistoryOptions, CompaniesHouseNamespace, type CompaniesHouseOfficersOptions, type CompaniesHouseSearchOptions, type CostcoAutocompleteOptions, type CostcoAvailabilityOptions, type CostcoCategoriesOptions, type CostcoCategoryOptions, type CostcoClearanceOptions, type CostcoCountry, type CostcoCouponsOptions, type CostcoDealType, type CostcoDealsOptions, type CostcoGasOptions, type CostcoListingFilters, type CostcoNaCountry, CostcoNamespace, type CostcoPriceCode, type CostcoPricesOptions, type CostcoProductOptions, type CostcoReviewsOptions, type CostcoSearchOptions, type CostcoSortBy, type CostcoWarehousesOptions, DEFAULT_MAX_REQUESTS_PER_SECOND, EbayNamespace, type EbayProductOptions, type EbaySearchOptions, type EbaySellerOptions, type ExtractOptions, G2Namespace, type G2ProductOptions, type G2ReviewsOptions, type G2SearchOptions, type GlassdoorCompaniesOptions, type GlassdoorCompanyOptions, GlassdoorNamespace, type GlassdoorReviewsOptions, type GlassdoorSalariesOptions, type GoogleAdsAdvertisersOptions, type GoogleAdsCreativeOptions, GoogleAdsNamespace, type GoogleAdsSearchOptions, type GoogleAiModeOptions, type GoogleFlightsOptions, type GoogleHotelsDetailOptions, type GoogleHotelsOptions, type GoogleMapsPlaceOptions, type GoogleMapsReviewsOptions, type GoogleMapsSearchOptions, GoogleNamespace, type GoogleNewsOptions, type GooglePlayAppOptions, GooglePlayNamespace, type GooglePlayReviewsOptions, type GooglePlaySearchOptions, type GoogleSearchOptions, type GoogleShoppingOptions, type GoogleShoppingProductOptions, type GoogleShoppingStoresOptions, type GoogleTrendingOptions, type GoogleTrendsOptions, HomeDepotNamespace, type HomeDepotProductOptions, type HomeDepotReviewsOptions, type HomeDepotSearchOptions, type IndeedCompanyOptions, type IndeedCompanyReviewsOptions, type IndeedJobOptions, IndeedNamespace, type IndeedSearchOptions, type InstagramCommentRepliesOptions, type InstagramFollowOptions, InstagramNamespace, type InstagramPostCommentsOptions, type InstagramPostOptions, type InstagramProfileOptions, type InstagramSearchOptions, type InstagramStoriesOptions, type InstagramUserFeedOptions, InsufficientCreditsError, InvalidAPIKeyError, type KuaishouCommentRepliesOptions, KuaishouNamespace, type KuaishouProfileOptions, type KuaishouSearchLiveOptions, type KuaishouSearchOptions, type KuaishouSearchUsersOptions, type KuaishouSearchVideosOptions, type KuaishouTagFeedOptions, type KuaishouTrendingOptions, type KuaishouUserLiveOptions, type KuaishouUserPostsOptions, type KuaishouUserResolveOptions, type KuaishouVideoCommentsOptions, type KuaishouVideoOptions, type KuaishouVideosBatchOptions, type LinkedInCompanyOptions, type LinkedInCompanyPostsOptions, type LinkedInCompanyPostsRequest, type LinkedInCompanyRefOptions, type LinkedInJobOptions, LinkedInNamespace, type LinkedInPersonContactOptions, type LinkedInPersonOptions, type LinkedInPersonPostsOptions, type LinkedInPersonPostsRequest, type LinkedInPersonRefOptions, type LinkedInPostCommentsOptions, type LinkedInPostOptions, type LinkedInSearchJobsOptions, type LinkedInSearchPeopleOptions, type LinkedInSearchPostsOptions, MAX_REQUESTS_PER_SECOND, type MercadoLibreBestSellersCountry, type MercadoLibreBestSellersOptions, type MercadoLibreCondition, type MercadoLibreCountry, type MercadoLibreDiscount, MercadoLibreNamespace, type MercadoLibreProductOptions, type MercadoLibreQuestionsOptions, type MercadoLibreReviewsOptions, type MercadoLibreSearchOptions, type MercadoLibreSort, type MetaAdsAdOptions, type MetaAdsAdvertiserOptions, MetaAdsNamespace, type MetaAdsSearchOptions, MissingAPIKeyError, NotFoundError, RateLimitError, type RealtorAgentOptions, type RealtorAgentsOptions, type RealtorListingStatus, type RealtorLocationsOptions, type RealtorMarketOptions, RealtorNamespace, type RealtorPropertyOptions, type RealtorPropertyType, type RealtorSearchOptions, type RealtorSort, type RedditCommentRepliesOptions, type RedditFeedSort, RedditNamespace, type RedditPopularOptions, type RedditPostCommentsOptions, type RedditPostOptions, type RedditSearchOptions, type RedditSearchSuggestionsOptions, type RedditSort, type RedditSubredditOptions, type RedditSubredditPostsOptions, type RedditUserFeedOptions, type RedditUserOptions, type RedfinMarketOptions, RedfinNamespace, type RedfinPropertyOptions, type RedfinSearchOptions, type RightmoveAgentOptions, type RightmoveAgentsOptions, type RightmoveExclude, type RightmoveFurnishing, type RightmoveLetType, type RightmoveListingStatus, type RightmoveLocationsOptions, type RightmoveMustHave, RightmoveNamespace, type RightmovePropertyOptions, type RightmovePropertyType, type RightmoveRadius, type RightmoveSearchOptions, type RightmoveSoldOptions, type RightmoveSoldPropertyOptions, type RightmoveSoldPropertyType, type RightmoveSoldSort, type RightmoveSort, type RightmoveTenure, type SECCompanyOptions, type SECConceptOptions, type SECFactsOptions, type SECFilingsOptions, type SECLookupOptions, SECNamespace, type SECSearchOptions, Scavio, ScavioAPIError, type ScavioConfig, ScavioConnectionError, ScavioError, ScavioTimeoutError, type TargetCategoryOptions, TargetNamespace, type TargetProductOptions, type TargetReviewsOptions, type TargetSearchOptions, ThreadsNamespace, type ThreadsPostCommentsOptions, type ThreadsPostOptions, type ThreadsProfileOptions, type ThreadsSearchUsersOptions, type ThreadsUserPostsOptions, type ThreadsUserRepliesOptions, type TikTokCommentRepliesOptions, type TikTokHashtagOptions, type TikTokHashtagVideosOptions, TikTokNamespace, type TikTokProfileOptions, type TikTokSearchUsersOptions, type TikTokSearchVideosOptions, type TikTokShopCategoryProductsOptions, type TikTokShopListingRegion, TikTokShopNamespace, 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 TripadvisorLocationOptions, type TripadvisorLocationsOptions, TripadvisorNamespace, type TripadvisorReviewsOptions, type TripadvisorSearchOptions, type TrustpilotBusinessAddress, type TrustpilotBusinessOptions, type TrustpilotCategoriesOptions, type TrustpilotCategoryOptions, type TrustpilotCategorySort, TrustpilotNamespace, type TrustpilotReviewOptions, type TrustpilotReviewsDateRange, type TrustpilotReviewsOptions, type TrustpilotReviewsSort, type TrustpilotSearchOptions, type TrustpilotStars, type WalmartCategoryOptions, WalmartNamespace, type WalmartOffersOptions, type WalmartProductOptions, type WalmartReviewsOptions, type WalmartSearchOptions, type WalmartSellerOptions, type WalmartSellerProductsOptions, type WalmartStore, type WalmartStoresData, type WalmartStoresOptions, type WalmartStoresResponse, XNamespace, type XSearchOptions, type XTrendingOptions, type XTweetCommentsOptions, type XTweetOptions, type XTweetRetweetersOptions, type XUserFeedOptions, type XUserOptions, type YelpBusinessOptions, YelpNamespace, type YelpReviewsOptions, type YelpSearchOptions, type YouTubeChannelCommunityOptions, type YouTubeChannelOptions, type YouTubeChannelResolveOptions, type YouTubeChannelSearchOptions, type YouTubeChannelShortsOptions, type YouTubeChannelVideosOptions, type YouTubeCommentRepliesOptions, type YouTubeCommentsOptions, type YouTubeMetadataOptions, YouTubeNamespace, type YouTubeRelatedOptions, type YouTubeSearchOptions, type YouTubeShortsOptions, type YouTubeStreamsOptions, type YouTubeSuggestionsOptions, type YouTubeTranscriptOptions, type YouTubeVideoOptions, type ZillowAgentReviewsOptions, ZillowNamespace, type ZillowPropertyOptions, type ZillowSearchOptions };
|
package/dist/index.js
CHANGED
|
@@ -129,7 +129,7 @@ function parseRetryAfter(header) {
|
|
|
129
129
|
var BASE_URL = "https://api.scavio.dev";
|
|
130
130
|
var DEFAULT_TIMEOUT = 3e4;
|
|
131
131
|
var DEFAULT_MAX_RETRIES = 2;
|
|
132
|
-
var SDK_VERSION = true ? "0.
|
|
132
|
+
var SDK_VERSION = true ? "0.21.0" : "0.0.0";
|
|
133
133
|
var USER_AGENT = `scavio-js/${SDK_VERSION}`;
|
|
134
134
|
function isServerRuntime() {
|
|
135
135
|
const g = globalThis;
|
|
@@ -2648,6 +2648,76 @@ var RightmoveNamespace = class {
|
|
|
2648
2648
|
}
|
|
2649
2649
|
};
|
|
2650
2650
|
|
|
2651
|
+
// src/namespaces/mercadolibre.ts
|
|
2652
|
+
var MercadoLibreNamespace = class {
|
|
2653
|
+
constructor(client) {
|
|
2654
|
+
this.client = client;
|
|
2655
|
+
}
|
|
2656
|
+
client;
|
|
2657
|
+
/**
|
|
2658
|
+
* Search Mercado Libre listings in Mexico, Brazil (Mercado Livre), Argentina
|
|
2659
|
+
* or Colombia by keyword or seller, with condition, price range, discount,
|
|
2660
|
+
* free shipping, Full fulfillment, official stores and interest-free
|
|
2661
|
+
* installment filters, sorted by relevance or price. Each row has price,
|
|
2662
|
+
* list price, discount, installments, seller and official-store flag where
|
|
2663
|
+
* shown, rating, units sold as a lower bound ("at least 500"), shipping
|
|
2664
|
+
* flags, a sponsored flag and catalog ids. About 48 rows per page and 42
|
|
2665
|
+
* pages (about 2,000 results) per query.
|
|
2666
|
+
*
|
|
2667
|
+
* Costs 2 credits.
|
|
2668
|
+
*/
|
|
2669
|
+
async search(options) {
|
|
2670
|
+
return this.client._post("/api/v1/mercadolibre/search", options);
|
|
2671
|
+
}
|
|
2672
|
+
/**
|
|
2673
|
+
* One Mercado Libre catalog product or listing: title, price, list price,
|
|
2674
|
+
* installments, promotions, the buy-box seller with reputation level and
|
|
2675
|
+
* seller tier, stock, shipping, rating with its star distribution,
|
|
2676
|
+
* variations with sibling product ids, specs, description, pictures and
|
|
2677
|
+
* categories. Only the buy-box seller is returned; units sold is a lower
|
|
2678
|
+
* bound. Some fields are null where the page omits them. Pass exactly one of
|
|
2679
|
+
* url, product_id or item_id; the id prefix (MLM, MLB, MLA, MCO) sets the
|
|
2680
|
+
* country.
|
|
2681
|
+
*
|
|
2682
|
+
* Costs 2 credits.
|
|
2683
|
+
*/
|
|
2684
|
+
async product(options) {
|
|
2685
|
+
return this.client._post("/api/v1/mercadolibre/product", options);
|
|
2686
|
+
}
|
|
2687
|
+
/**
|
|
2688
|
+
* One page of up to 15 Mercado Libre product reviews (page until a page
|
|
2689
|
+
* comes back empty), optionally filtered by star rating: rating, text, the
|
|
2690
|
+
* original text when Mercado Libre translated it, exact date, likes, the
|
|
2691
|
+
* review's country and photos. Catalog products pool reviews from several
|
|
2692
|
+
* countries. Totals and the star distribution come from product().
|
|
2693
|
+
*
|
|
2694
|
+
* Costs 1 credit.
|
|
2695
|
+
*/
|
|
2696
|
+
async reviews(options) {
|
|
2697
|
+
return this.client._post("/api/v1/mercadolibre/reviews", options);
|
|
2698
|
+
}
|
|
2699
|
+
/**
|
|
2700
|
+
* A page of buyer questions on a Mercado Libre listing with the seller's
|
|
2701
|
+
* answers and answer dates (Mercado Libre shows no question dates). Page
|
|
2702
|
+
* through with next_offset. A listing with no public questions returns 404.
|
|
2703
|
+
*
|
|
2704
|
+
* Costs 2 credits.
|
|
2705
|
+
*/
|
|
2706
|
+
async questions(options) {
|
|
2707
|
+
return this.client._post("/api/v1/mercadolibre/questions", options);
|
|
2708
|
+
}
|
|
2709
|
+
/**
|
|
2710
|
+
* The ranked top 20 best sellers in a Mercado Libre category in Mexico,
|
|
2711
|
+
* Argentina or Colombia, with price, discount, installments, rating, units
|
|
2712
|
+
* sold as a lower bound and seller where shown. Not available for Brazil.
|
|
2713
|
+
*
|
|
2714
|
+
* Costs 2 credits.
|
|
2715
|
+
*/
|
|
2716
|
+
async bestSellers(options) {
|
|
2717
|
+
return this.client._post("/api/v1/mercadolibre/best-sellers", options);
|
|
2718
|
+
}
|
|
2719
|
+
};
|
|
2720
|
+
|
|
2651
2721
|
// src/client.ts
|
|
2652
2722
|
var DEFAULT_MAX_REQUESTS_PER_SECOND = 1;
|
|
2653
2723
|
var MAX_REQUESTS_PER_SECOND = 50;
|
|
@@ -2687,6 +2757,7 @@ var Scavio = class {
|
|
|
2687
2757
|
trustpilot;
|
|
2688
2758
|
realtor;
|
|
2689
2759
|
rightmove;
|
|
2760
|
+
mercadolibre;
|
|
2690
2761
|
apiKey;
|
|
2691
2762
|
baseUrl;
|
|
2692
2763
|
timeout;
|
|
@@ -2742,6 +2813,7 @@ var Scavio = class {
|
|
|
2742
2813
|
this.trustpilot = new TrustpilotNamespace(this);
|
|
2743
2814
|
this.realtor = new RealtorNamespace(this);
|
|
2744
2815
|
this.rightmove = new RightmoveNamespace(this);
|
|
2816
|
+
this.mercadolibre = new MercadoLibreNamespace(this);
|
|
2745
2817
|
}
|
|
2746
2818
|
/** @internal */
|
|
2747
2819
|
async _post(path, body) {
|
|
@@ -2822,6 +2894,7 @@ export {
|
|
|
2822
2894
|
KuaishouNamespace,
|
|
2823
2895
|
LinkedInNamespace,
|
|
2824
2896
|
MAX_REQUESTS_PER_SECOND,
|
|
2897
|
+
MercadoLibreNamespace,
|
|
2825
2898
|
MetaAdsNamespace,
|
|
2826
2899
|
MissingAPIKeyError,
|
|
2827
2900
|
NotFoundError,
|