Affiliate Marketplace List
AI-generatedSummary
Fetch products from Mercado Livre affiliate or catalog pages by crawling paginated URLs, normalizing and returning product data including title, URL, price, seller, and ratings.
Inputs
- marketplace — Select the marketplace, currently supports only 'Mercado Livre' (Amazon is reserved for future release).
- pageSource — For Mercado Livre, choose type of page to crawl: 'affiliate' for social affiliate lists or 'catalog' for catalog/offers pages. This affects metadata in the output.
- listUrl (required) — URL of the Mercado Livre page to crawl. Supports affiliate or catalog URLs, including social lists or hubs. For hub URLs, specify the social nickname either in 'socialNickname' or as '?nickname=NICK' in the URL.
- socialNickname — Optional social nickname for accessing private favorite hubs by converting the URL to a public social list URL.
- maxPages — Maximum number of paginated pages to fetch from the list URL (default 250, max 500).
Output shape
a single JSON object containing metadata and a product list
Returns an object with properties including 'products' (an array of normalized product cards with details such as title, URL, price, seller, shipping info, ratings, and coupons), 'totalDeclared' total items if known, 'pagesFetched', 'maxPagesLimit', and other metadata about the crawling process.
Examples
Example 1: Crawl a Mercado Livre affiliate list URL
Set Marketplace=Mercado Livre, Page Source=Lista de afiliados, enter a valid listUrl, optionally specify socialNickname and maxPages.