{ "data": { "id": "m4pbC1XYTxetki7oF", "actId": "s1MOuPRNCpig0Bsnr", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-10-29T19:13:36.702Z", "finishedAt": "2026-10-29T19:13:40.026Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 3156, "runTimeSecs": 3.156, "computeUnits": 0.0035066666666666666, "imageSizeBytes": 318732288 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"MercadoLibre Marketplace Scraper Input\",\n \"description\": \"Search products, fetch full product details, reviews, questions, seller catalogs, categories, best sellers or deals across 18 MercadoLibre country sites.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"What to scrape\",\n \"type\": \"string\",\n \"description\": \"Choose the kind of MercadoLibre data you need.\",\n \"editor\": \"select\",\n \"enum\": [\n \"search\",\n \"product\",\n \"reviews\",\n \"questions\",\n \"seller\",\n \"categories\",\n \"bestSellers\",\n \"deals\",\n \"searchProducts\",\n \"searchByCategory\",\n \"getProductDetails\",\n \"getCategories\"\n ],\n \"enumTitles\": [\n \"Search products\",\n \"Product details\",\n \"Product reviews\",\n \"Buyer questions and answers\",\n \"Seller catalog\",\n \"Categories and attributes\",\n \"Best sellers\",\n \"Live deals\",\n \"Search products (legacy task)\",\n \"Search by category (legacy task)\",\n \"Product details (legacy task)\",\n \"Categories (legacy task)\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\"\n },\n \"siteId\": {\n \"title\": \"Country site\",\n \"type\": \"string\",\n \"description\": \"MercadoLibre country marketplace to query.\",\n \"editor\": \"select\",\n \"enum\": [\n \"MLA\",\n \"MLB\",\n \"MLM\",\n \"MLC\",\n \"MCO\",\n \"MPE\",\n \"MLU\",\n \"MEC\",\n \"MLV\",\n \"MBO\",\n \"MPY\",\n \"MGT\",\n \"MHN\",\n \"MNI\",\n \"MSV\",\n \"MCR\",\n \"MPA\",\n \"MRD\",\n \"MLO\"\n ],\n \"enumTitles\": [\n \"Argentina (MLA)\",\n \"Brazil (MLB)\",\n \"Mexico (MLM)\",\n \"Chile (MLC)\",\n \"Colombia (MCO)\",\n \"Peru (MPE)\",\n \"Uruguay (MLU)\",\n \"Ecuador (MEC)\",\n \"Venezuela (MLV)\",\n \"Bolivia (MBO)\",\n \"Paraguay (MPY)\",\n \"Guatemala (MGT)\",\n \"Honduras (MHN)\",\n \"Nicaragua (MNI)\",\n \"El Salvador (MSV)\",\n \"Costa Rica (MCR)\",\n \"Panama (MPA)\",\n \"Dominican Republic (MRD)\",\n \"Dominican Republic (legacy MLO)\"\n ],\n \"default\": \"MLA\",\n \"prefill\": \"MLA\"\n },\n \"searchQuery\": {\n \"title\": \"Search keywords\",\n \"type\": \"string\",\n \"description\": \"Keyword to search for (mode=search). Example: laptop.\",\n \"editor\": \"textfield\",\n \"default\": \"laptop\",\n \"prefill\": \"laptop\"\n },\n \"searchUrls\": {\n \"title\": \"Listing URLs\",\n \"type\": \"array\",\n \"description\": \"Paste MercadoLibre search, category or seller listing URLs (mode=search/seller). One per line.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n },\n \"default\": [],\n \"prefill\": []\n },\n \"categoryId\": {\n \"title\": \"Category ID or URL\",\n \"type\": \"string\",\n \"description\": \"Category to browse or use as a filter (mode=search/categories/bestSellers/deals). Example: MLM1652.\",\n \"editor\": \"textfield\"\n },\n \"categoryQuery\": {\n \"title\": \"Category discovery keyword\",\n \"type\": \"string\",\n \"description\": \"Find matching categories from a keyword (mode=categories). Example: laptop.\",\n \"editor\": \"textfield\"\n },\n \"sellerId\": {\n \"title\": \"Seller ID or URL\",\n \"type\": \"string\",\n \"description\": \"Seller to catalog (mode=seller/search). Numeric ID, _CustId_ URL or seller_id URL.\",\n \"editor\": \"textfield\"\n },\n \"productUrls\": {\n \"title\": \"Product URLs or IDs\",\n \"type\": \"array\",\n \"description\": \"Product, catalog or item URLs or IDs (mode=product/reviews/questions). One per line.\",\n \"editor\": \"stringList\",\n \"items\": {\n \"type\": \"string\"\n },\n \"default\": [],\n \"prefill\": []\n },\n \"sort\": {\n \"title\": \"Sort order\",\n \"type\": \"string\",\n \"description\": \"How to order search and seller results.\",\n \"editor\": \"select\",\n \"enum\": [\n \"relevance\",\n \"price_asc\",\n \"price_desc\"\n ],\n \"enumTitles\": [\n \"Relevance\",\n \"Price: low to high\",\n \"Price: high to low\"\n ],\n \"default\": \"relevance\",\n \"prefill\": \"relevance\"\n },\n \"condition\": {\n \"title\": \"Item condition\",\n \"type\": \"string\",\n \"description\": \"Filter products by condition (mode=search/seller).\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"any\",\n \"new\",\n \"used\",\n \"refurbished\",\n \"open_box\"\n ],\n \"enumTitles\": [\n \"All conditions (legacy)\",\n \"Any condition\",\n \"New\",\n \"Used\",\n \"Refurbished\",\n \"Open box\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\"\n },\n \"priceMin\": {\n \"title\": \"Minimum price\",\n \"type\": \"number\",\n \"description\": \"Lowest price in the country currency (mode=search/seller). 0 means no minimum.\",\n \"minimum\": 0,\n \"default\": 0,\n \"prefill\": 0\n },\n \"priceMax\": {\n \"title\": \"Maximum price\",\n \"type\": \"number\",\n \"description\": \"Highest price in the country currency (mode=search/seller). 0 means no maximum.\",\n \"minimum\": 0,\n \"default\": 0,\n \"prefill\": 0\n },\n \"freeShippingOnly\": {\n \"title\": \"Free shipping only\",\n \"type\": \"boolean\",\n \"description\": \"Keep products with free shipping (mode=search/seller).\",\n \"default\": false,\n \"prefill\": false\n },\n \"fullShippingOnly\": {\n \"title\": \"MercadoLibre FULL only\",\n \"type\": \"boolean\",\n \"description\": \"Keep products fulfilled by MercadoLibre FULL (mode=search/seller).\",\n \"default\": false,\n \"prefill\": false\n },\n \"officialStoresOnly\": {\n \"title\": \"Official stores only\",\n \"type\": \"boolean\",\n \"description\": \"Keep products sold by official stores (mode=search/seller).\",\n \"default\": false,\n \"prefill\": false\n },\n \"minDiscount\": {\n \"title\": \"Minimum discount %\",\n \"type\": \"integer\",\n \"description\": \"Keep products discounted by at least this percentage (mode=search/seller/deals). 0 disables it.\",\n \"minimum\": 0,\n \"maximum\": 100,\n \"default\": 0,\n \"prefill\": 0\n },\n \"includeSponsored\": {\n \"title\": \"Include sponsored products\",\n \"type\": \"boolean\",\n \"description\": \"Include paid placements in search and seller results.\",\n \"default\": true,\n \"prefill\": true\n },\n \"includeDetails\": {\n \"title\": \"Enrich with product details\",\n \"type\": \"boolean\",\n \"description\": \"Fetch the full detail page for every search or seller result (mode=search/seller). Slower, more fields.\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeReviews\": {\n \"title\": \"Include reviews\",\n \"type\": \"boolean\",\n \"description\": \"Attach review summary and review rows to product records (mode=product).\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeQuestions\": {\n \"title\": \"Include questions\",\n \"type\": \"boolean\",\n \"description\": \"Attach buyer questions and answers to product records (mode=product).\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeSellerProfile\": {\n \"title\": \"Include seller profile\",\n \"type\": \"boolean\",\n \"description\": \"Emit a seller profile row before the catalog (mode=seller).\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeAttributes\": {\n \"title\": \"Include category attributes\",\n \"type\": \"boolean\",\n \"description\": \"Attach the attribute schema to a category record (mode=categories with categoryId).\",\n \"default\": false,\n \"prefill\": false\n },\n \"maxItems\": {\n \"title\": \"Maximum items\",\n \"type\": \"integer\",\n \"description\": \"Maximum records to return. Product queries stop at the source's 2,000-row window.\",\n \"minimum\": 1,\n \"maximum\": 10000,\n \"default\": 50,\n \"prefill\": 1\n },\n \"maxReviews\": {\n \"title\": \"Maximum reviews\",\n \"type\": \"integer\",\n \"description\": \"Maximum review rows per product (mode=reviews). Values above 330 sweep every rating bucket.\",\n \"minimum\": 1,\n \"maximum\": 1650,\n \"default\": 30,\n \"prefill\": 30\n },\n \"reviewRating\": {\n \"title\": \"Review rating filter\",\n \"type\": \"string\",\n \"description\": \"Only collect reviews with this star rating (mode=reviews).\",\n \"editor\": \"select\",\n \"enum\": [\n \"all\",\n \"1\",\n \"2\",\n \"3\",\n \"4\",\n \"5\"\n ],\n \"enumTitles\": [\n \"All ratings\",\n \"1 star\",\n \"2 stars\",\n \"3 stars\",\n \"4 stars\",\n \"5 stars\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n },\n \"maxQuestions\": {\n \"title\": \"Maximum questions\",\n \"type\": \"integer\",\n \"description\": \"Maximum buyer questions per product (mode=questions/product).\",\n \"minimum\": 1,\n \"maximum\": 500,\n \"default\": 20,\n \"prefill\": 20\n }\n },\n \"required\": [\n \"mode\",\n \"siteId\"\n ]\n}", "readme": "# MercadoLibre Marketplace Scraper\n\nCollect real marketplace data from MercadoLibre in Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, Venezuela, Bolivia, Paraguay, Guatemala, Honduras, Nicaragua, El Salvador, Costa Rica, Panama and the Dominican Republic. Search products, open full product pages, read reviews and buyer questions, walk seller catalogs, browse categories, and track best sellers and deals.\n\nNo account, cookies, login or API key is required.\n\n## What it does\n\n- **Search** by keyword, category, seller or a pasted listing URL, with condition, sort, price range, free shipping, MercadoLibre FULL, official-store and discount filters.\n- **Product** pages by catalog URL, item URL, user-product URL or bare ID, with gallery, specs, variations, seller, shipping, payment methods, warranty and returns.\n- **Reviews** with rating filters and an optional deep sweep across rating buckets.\n- **Questions** with buyer questions and seller answers.\n- **Seller** catalogs and an optional seller profile row.\n- **Categories** as the 24 root departments, a category tree with attributes, or keyword-to-category discovery.\n- **Best sellers** ranked per category and **live deals**, both as product rows.\n\n## Services\n\nEvery run covers one country site at a time and one mode at a time. The actor returns JSON records in the default dataset, ready for spreadsheets, BI tools, price monitoring, catalog enrichment and competitor research. The output is omit-empty: fields the source does not expose for a record are left out rather than filled with empty values.\n\n## How it works\n\nThe actor reads the public mobile web pages that MercadoLibre serves to its own app and extracts the embedded page state. That cookieless route exposes the same products, prices, reviews and questions a shopper sees, without an OAuth application or an API token. Product searches are paginated in pages of 50 up to the source window, and duplicate item IDs are removed before records are pushed.\n\n## Input\n\n| Field | Used by | Default | Notes |\n|---|---|---|---|\n| `mode` | all | `search` | `search`, `product`, `reviews`, `questions`, `seller`, `categories`, `bestSellers`, `deals` |\n| `siteId` | all | `MLA` | 18 country sites |\n| `searchQuery` | search | `laptop` | Keyword to search for |\n| `searchUrls` | search, seller | – | Pasted search/category/seller listing URLs |\n| `categoryId` | search, categories, bestSellers, deals | – | Category ID or URL |\n| `categoryQuery` | categories | – | Keyword for category discovery |\n| `sellerId` | seller, search | – | Numeric seller ID or seller URL |\n| `productUrls` | product, reviews, questions | – | Product/catalog/item URLs or IDs, one per line |\n| `sort` | search, seller | `relevance` | Relevance, price ascending or price descending |\n| `condition` | search, seller | `any` | Any, new, used, refurbished or open box |\n| `priceMin`, `priceMax` | search, seller | `0` | Price range in the country currency; 0 = open |\n| `freeShippingOnly` | search, seller | `false` | Keep free-shipping products |\n| `fullShippingOnly` | search, seller | `false` | Keep MercadoLibre FULL products |\n| `officialStoresOnly` | search, seller | `false` | Keep official-store products |\n| `minDiscount` | search, seller, deals | `0` | Minimum discount percentage |\n| `includeSponsored` | search, seller | `true` | Include or remove paid placements |\n| `includeDetails` | search, seller | `false` | Enrich every result with the full product page |\n| `includeReviews`, `includeQuestions` | product | `false` | Attach review or Q&A data to product records |\n| `includeSellerProfile` | seller | `false` | Emit a seller profile before the catalog |\n| `includeAttributes` | categories | `false` | Attach the category attribute schema |\n| `maxItems` | most modes | `50` | Maximum records; product queries stop at 2,000 |\n| `maxReviews`, `reviewRating` | reviews | `30`, `all` | Review ceiling and optional star filter |\n| `maxQuestions` | questions, product | `20` | Question ceiling |\n\nExample: search used laptops in Mexico with free shipping, sorted by price.\n\n```json\n{\n \"mode\": \"search\",\n \"siteId\": \"MLM\",\n \"searchQuery\": \"laptop\",\n \"condition\": \"used\",\n \"freeShippingOnly\": true,\n \"sort\": \"price_asc\",\n \"maxItems\": 50\n}\n```\n\nExample: fetch one product by URL and include its reviews and questions.\n\n```json\n{\n \"mode\": \"product\",\n \"siteId\": \"MLM\",\n \"productUrls\": [\"https://www.mercadolibre.com.mx/p/MLM1081091201\"],\n \"includeReviews\": true,\n \"includeQuestions\": true,\n \"maxReviews\": 30,\n \"maxQuestions\": 20\n}\n```\n\n## Output\n\nEvery row has `recordType`, `siteId` and `scrapedAt`. Product-like rows keep the legacy fields `itemId`, `title`, `price`, `currency`, `condition`, `availableQuantity`, `soldQuantity`, `sellerId`, `sellerName`, `sellerReputation`, `imageUrl`, `categoryId`, `categoryPath`, `freeShipping`, `officialStoreId`, `itemUrl`, `warranty`, `listingTypeId`, plus the new detail fields:\n\n- **Price and stock:** `originalPrice`, `discountPercent`, `installments`, `hasStock`, `availableQuantity`, `soldText`.\n- **Seller and shipping:** `sellerPowerStatus`, `sellerStoreType`, `sellerSales`, `sellerFollowers`, `sellerProducts`, `fullShipping`, `logisticType`, `shippingMode`, `shippingText`, `localPickup`, `storePickup`, `isOfficialStore`.\n- **Content:** `specs`, `specGroups`, `description`, `images`, `variations`, `warranty`, `returns`, `benefits`, `paymentMethods`, `rating`, `promotions`.\n- **Search:** `position`, `searchQuery`, `totalResults`, `sponsored`, `catalogProductId`, `userProductId`, `domainId`.\n\nReview rows carry `reviewId`, `rating`, `text`, `date`, `relativeDate`, `country`, `variant`, `likes` and `media`. Question rows carry `questionId`, `question`, `answer` and `answerDate`. Category rows carry `categoryId`, `categoryName`, `categoryPath`, `totalItems`, `children`, `attributes` and `permalink`. Best-seller and deal rows add `rank` and `dealType`.\n\n## Usage cost\n\nThe actor runs in a 1 GB container. Search and product pages are large (roughly 1.5–2.7 MB each), so cost scales with the number of pages opened and details requested. Start with `maxItems` 50 and `includeDetails` off, then raise it only when needed. Deep review sweeps make extra requests; `maxReviews` 330 is the normal ceiling and values above that intentionally sweep rating buckets.\n\n## FAQ\n\n**Do I need a MercadoLibre account or API key?** No. The actor reads public pages without credentials.\n\n**Can I paste a product link instead of an ID?** Yes. Product, catalog and user-product URLs are accepted, as are bare IDs.\n\n**Can I get more than 50 products?** Yes. Results are paginated up to the source's 2,000-row window per query. For more, split the search by category, price range or condition.\n\n**Why do some products have no condition or shipping field?** Search cards omit those labels for some listings. Turn on `includeDetails` to read the product page and fill them whenever the source exposes them.\n\n**How many reviews can I collect?** A single review query returns up to 330 rows. Setting `maxReviews` above 330 sweeps every star rating and can return over 1,000 unique reviews on popular products. Ratings without text are not review rows.\n\n**Does it support official store URLs?** Seller catalogs work with seller IDs. A store-slug landing page does not expose its catalog server-side, so use the seller ID or `_CustId_`/`seller_id` URL.\n\n**Can I use it for cars or real estate?** This actor covers marketplace products. Vehicles and real estate are separate MercadoLibre verticals with different listing pages.\n\n**Which countries are supported?** All 18 current MercadoLibre country sites listed in the input schema.\n\n**Are prices converted?** No. Prices stay in the local currency shown on the site.\n\n## Notes\n\n- Category browse uses the official category metadata service, which is public; product, review and question data comes from the same pages shoppers use.\n- Search cards are the fastest source. Detail enrichment fills specs, gallery, seller reputation and stock but costs one page per product.\n- Costa Rica uses the `mercadolibre.co.cr` domain. The old `MLO` site code maps to `MRD` for backward compatibility.\n- The `mode`, `siteId` and `condition` dropdowns keep the legacy values `searchProducts`, `searchByCategory`, `getProductDetails`, `getCategories`, `MLO` and `all` so existing saved tasks and API payloads stay valid. The actor maps them in code; new runs should use the current values.\n\n## Limitations\n\n- Search and seller catalogs stop at the source's 2,000-row window per query.\n- Review queries cap at 330 rows per star bucket; deep sweeps deduplicate across buckets.\n- Buyer questions are served 20 per page and some products stop earlier than their displayed count.\n- Store-slug catalogs are not exposed; use a seller ID or seller URL instead.\n- Seller catalog rows keep the catalog owner in `sellerId`/`sellerName`; an item card can show a brand sub-store label instead.\n- Category API totals can differ from the number of active listings, so category totals are shown as metadata.\n- Sponsored placements are visible on some surfaces but not all; the `includeSponsored` toggle can only remove placements the source marks.\n- The deals page is a cross-category feed. A `categoryId` filter keeps matching deals from that feed and may return no rows when the category has no active deal. The feed follows the source's 20-page window.\n- Autosuggest and verified-purchase flags are not exposed on this route.\n", "actorDefinition": { "actorSpecification": 1, "name": "mercadolibre-multi-country-marketplace-scraper", "title": "MercadoLibre Marketplace and Reviews Scraper", "description": "Scrape MercadoLibre in 18 Latin American countries. Search products with filters, get full product details, reviews, buyer questions, seller catalogs, categories, best sellers and deals. No login, cookies or API key required.", "version": "2.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# MercadoLibre Marketplace Scraper\n\nCollect real marketplace data from MercadoLibre in Argentina, Brazil, Mexico, Chile, Colombia, Peru, Uruguay, Ecuador, Venezuela, Bolivia, Paraguay, Guatemala, Honduras, Nicaragua, El Salvador, Costa Rica, Panama and the Dominican Republic. Search products, open full product pages, read reviews and buyer questions, walk seller catalogs, browse categories, and track best sellers and deals.\n\nNo account, cookies, login or API key is required.\n\n## What it does\n\n- **Search** by keyword, category, seller or a pasted listing URL, with condition, sort, price range, free shipping, MercadoLibre FULL, official-store and discount filters.\n- **Product** pages by catalog URL, item URL, user-product URL or bare ID, with gallery, specs, variations, seller, shipping, payment methods, warranty and returns.\n- **Reviews** with rating filters and an optional deep sweep across rating buckets.\n- **Questions** with buyer questions and seller answers.\n- **Seller** catalogs and an optional seller profile row.\n- **Categories** as the 24 root departments, a category tree with attributes, or keyword-to-category discovery.\n- **Best sellers** ranked per category and **live deals**, both as product rows.\n\n## Services\n\nEvery run covers one country site at a time and one mode at a time. The actor returns JSON records in the default dataset, ready for spreadsheets, BI tools, price monitoring, catalog enrichment and competitor research. The output is omit-empty: fields the source does not expose for a record are left out rather than filled with empty values.\n\n## How it works\n\nThe actor reads the public mobile web pages that MercadoLibre serves to its own app and extracts the embedded page state. That cookieless route exposes the same products, prices, reviews and questions a shopper sees, without an OAuth application or an API token. Product searches are paginated in pages of 50 up to the source window, and duplicate item IDs are removed before records are pushed.\n\n## Input\n\n| Field | Used by | Default | Notes |\n|---|---|---|---|\n| `mode` | all | `search` | `search`, `product`, `reviews`, `questions`, `seller`, `categories`, `bestSellers`, `deals` |\n| `siteId` | all | `MLA` | 18 country sites |\n| `searchQuery` | search | `laptop` | Keyword to search for |\n| `searchUrls` | search, seller | – | Pasted search/category/seller listing URLs |\n| `categoryId` | search, categories, bestSellers, deals | – | Category ID or URL |\n| `categoryQuery` | categories | – | Keyword for category discovery |\n| `sellerId` | seller, search | – | Numeric seller ID or seller URL |\n| `productUrls` | product, reviews, questions | – | Product/catalog/item URLs or IDs, one per line |\n| `sort` | search, seller | `relevance` | Relevance, price ascending or price descending |\n| `condition` | search, seller | `any` | Any, new, used, refurbished or open box |\n| `priceMin`, `priceMax` | search, seller | `0` | Price range in the country currency; 0 = open |\n| `freeShippingOnly` | search, seller | `false` | Keep free-shipping products |\n| `fullShippingOnly` | search, seller | `false` | Keep MercadoLibre FULL products |\n| `officialStoresOnly` | search, seller | `false` | Keep official-store products |\n| `minDiscount` | search, seller, deals | `0` | Minimum discount percentage |\n| `includeSponsored` | search, seller | `true` | Include or remove paid placements |\n| `includeDetails` | search, seller | `false` | Enrich every result with the full product page |\n| `includeReviews`, `includeQuestions` | product | `false` | Attach review or Q&A data to product records |\n| `includeSellerProfile` | seller | `false` | Emit a seller profile before the catalog |\n| `includeAttributes` | categories | `false` | Attach the category attribute schema |\n| `maxItems` | most modes | `50` | Maximum records; product queries stop at 2,000 |\n| `maxReviews`, `reviewRating` | reviews | `30`, `all` | Review ceiling and optional star filter |\n| `maxQuestions` | questions, product | `20` | Question ceiling |\n\nExample: search used laptops in Mexico with free shipping, sorted by price.\n\n```json\n{\n \"mode\": \"search\",\n \"siteId\": \"MLM\",\n \"searchQuery\": \"laptop\",\n \"condition\": \"used\",\n \"freeShippingOnly\": true,\n \"sort\": \"price_asc\",\n \"maxItems\": 50\n}\n```\n\nExample: fetch one product by URL and include its reviews and questions.\n\n```json\n{\n \"mode\": \"product\",\n \"siteId\": \"MLM\",\n \"productUrls\": [\"https://www.mercadolibre.com.mx/p/MLM1081091201\"],\n \"includeReviews\": true,\n \"includeQuestions\": true,\n \"maxReviews\": 30,\n \"maxQuestions\": 20\n}\n```\n\n## Output\n\nEvery row has `recordType`, `siteId` and `scrapedAt`. Product-like rows keep the legacy fields `itemId`, `title`, `price`, `currency`, `condition`, `availableQuantity`, `soldQuantity`, `sellerId`, `sellerName`, `sellerReputation`, `imageUrl`, `categoryId`, `categoryPath`, `freeShipping`, `officialStoreId`, `itemUrl`, `warranty`, `listingTypeId`, plus the new detail fields:\n\n- **Price and stock:** `originalPrice`, `discountPercent`, `installments`, `hasStock`, `availableQuantity`, `soldText`.\n- **Seller and shipping:** `sellerPowerStatus`, `sellerStoreType`, `sellerSales`, `sellerFollowers`, `sellerProducts`, `fullShipping`, `logisticType`, `shippingMode`, `shippingText`, `localPickup`, `storePickup`, `isOfficialStore`.\n- **Content:** `specs`, `specGroups`, `description`, `images`, `variations`, `warranty`, `returns`, `benefits`, `paymentMethods`, `rating`, `promotions`.\n- **Search:** `position`, `searchQuery`, `totalResults`, `sponsored`, `catalogProductId`, `userProductId`, `domainId`.\n\nReview rows carry `reviewId`, `rating`, `text`, `date`, `relativeDate`, `country`, `variant`, `likes` and `media`. Question rows carry `questionId`, `question`, `answer` and `answerDate`. Category rows carry `categoryId`, `categoryName`, `categoryPath`, `totalItems`, `children`, `attributes` and `permalink`. Best-seller and deal rows add `rank` and `dealType`.\n\n## Usage cost\n\nThe actor runs in a 1 GB container. Search and product pages are large (roughly 1.5–2.7 MB each), so cost scales with the number of pages opened and details requested. Start with `maxItems` 50 and `includeDetails` off, then raise it only when needed. Deep review sweeps make extra requests; `maxReviews` 330 is the normal ceiling and values above that intentionally sweep rating buckets.\n\n## FAQ\n\n**Do I need a MercadoLibre account or API key?** No. The actor reads public pages without credentials.\n\n**Can I paste a product link instead of an ID?** Yes. Product, catalog and user-product URLs are accepted, as are bare IDs.\n\n**Can I get more than 50 products?** Yes. Results are paginated up to the source's 2,000-row window per query. For more, split the search by category, price range or condition.\n\n**Why do some products have no condition or shipping field?** Search cards omit those labels for some listings. Turn on `includeDetails` to read the product page and fill them whenever the source exposes them.\n\n**How many reviews can I collect?** A single review query returns up to 330 rows. Setting `maxReviews` above 330 sweeps every star rating and can return over 1,000 unique reviews on popular products. Ratings without text are not review rows.\n\n**Does it support official store URLs?** Seller catalogs work with seller IDs. A store-slug landing page does not expose its catalog server-side, so use the seller ID or `_CustId_`/`seller_id` URL.\n\n**Can I use it for cars or real estate?** This actor covers marketplace products. Vehicles and real estate are separate MercadoLibre verticals with different listing pages.\n\n**Which countries are supported?** All 18 current MercadoLibre country sites listed in the input schema.\n\n**Are prices converted?** No. Prices stay in the local currency shown on the site.\n\n## Notes\n\n- Category browse uses the official category metadata service, which is public; product, review and question data comes from the same pages shoppers use.\n- Search cards are the fastest source. Detail enrichment fills specs, gallery, seller reputation and stock but costs one page per product.\n- Costa Rica uses the `mercadolibre.co.cr` domain. The old `MLO` site code maps to `MRD` for backward compatibility.\n- The `mode`, `siteId` and `condition` dropdowns keep the legacy values `searchProducts`, `searchByCategory`, `getProductDetails`, `getCategories`, `MLO` and `all` so existing saved tasks and API payloads stay valid. The actor maps them in code; new runs should use the current values.\n\n## Limitations\n\n- Search and seller catalogs stop at the source's 2,000-row window per query.\n- Review queries cap at 330 rows per star bucket; deep sweeps deduplicate across buckets.\n- Buyer questions are served 20 per page and some products stop earlier than their displayed count.\n- Store-slug catalogs are not exposed; use a seller ID or seller URL instead.\n- Seller catalog rows keep the catalog owner in `sellerId`/`sellerName`; an item card can show a brand sub-store label instead.\n- Category API totals can differ from the number of active listings, so category totals are shown as metadata.\n- Sponsored placements are visible on some surfaces but not all; the `includeSponsored` toggle can only remove placements the source marks.\n- The deals page is a cross-category feed. A `categoryId` filter keeps matching deals from that feed and may return no rows when the category has no active deal. The feed follows the source's 20-page window.\n- Autosuggest and verified-purchase flags are not exposed on this route.\n", "input": { "title": "MercadoLibre Marketplace Scraper Input", "description": "Search products, fetch full product details, reviews, questions, seller catalogs, categories, best sellers or deals across 18 MercadoLibre country sites.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "What to scrape", "type": "string", "description": "Choose the kind of MercadoLibre data you need.", "editor": "select", "enum": [ "search", "product", "reviews", "questions", "seller", "categories", "bestSellers", "deals", "searchProducts", "searchByCategory", "getProductDetails", "getCategories" ], "enumTitles": [ "Search products", "Product details", "Product reviews", "Buyer questions and answers", "Seller catalog", "Categories and attributes", "Best sellers", "Live deals", "Search products (legacy task)", "Search by category (legacy task)", "Product details (legacy task)", "Categories (legacy task)" ], "default": "search", "prefill": "search" }, "siteId": { "title": "Country site", "type": "string", "description": "MercadoLibre country marketplace to query.", "editor": "select", "enum": [ "MLA", "MLB", "MLM", "MLC", "MCO", "MPE", "MLU", "MEC", "MLV", "MBO", "MPY", "MGT", "MHN", "MNI", "MSV", "MCR", "MPA", "MRD", "MLO" ], "enumTitles": [ "Argentina (MLA)", "Brazil (MLB)", "Mexico (MLM)", "Chile (MLC)", "Colombia (MCO)", "Peru (MPE)", "Uruguay (MLU)", "Ecuador (MEC)", "Venezuela (MLV)", "Bolivia (MBO)", "Paraguay (MPY)", "Guatemala (MGT)", "Honduras (MHN)", "Nicaragua (MNI)", "El Salvador (MSV)", "Costa Rica (MCR)", "Panama (MPA)", "Dominican Republic (MRD)", "Dominican Republic (legacy MLO)" ], "default": "MLA", "prefill": "MLA" }, "searchQuery": { "title": "Search keywords", "type": "string", "description": "Keyword to search for (mode=search). Example: laptop.", "editor": "textfield", "default": "laptop", "prefill": "laptop" }, "searchUrls": { "title": "Listing URLs", "type": "array", "description": "Paste MercadoLibre search, category or seller listing URLs (mode=search/seller). One per line.", "editor": "stringList", "items": { "type": "string" }, "default": [], "prefill": [] }, "categoryId": { "title": "Category ID or URL", "type": "string", "description": "Category to browse or use as a filter (mode=search/categories/bestSellers/deals). Example: MLM1652.", "editor": "textfield" }, "categoryQuery": { "title": "Category discovery keyword", "type": "string", "description": "Find matching categories from a keyword (mode=categories). Example: laptop.", "editor": "textfield" }, "sellerId": { "title": "Seller ID or URL", "type": "string", "description": "Seller to catalog (mode=seller/search). Numeric ID, _CustId_ URL or seller_id URL.", "editor": "textfield" }, "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "Product, catalog or item URLs or IDs (mode=product/reviews/questions). One per line.", "editor": "stringList", "items": { "type": "string" }, "default": [], "prefill": [] }, "sort": { "title": "Sort order", "type": "string", "description": "How to order search and seller results.", "editor": "select", "enum": [ "relevance", "price_asc", "price_desc" ], "enumTitles": [ "Relevance", "Price: low to high", "Price: high to low" ], "default": "relevance", "prefill": "relevance" }, "condition": { "title": "Item condition", "type": "string", "description": "Filter products by condition (mode=search/seller).", "editor": "select", "enum": [ "all", "any", "new", "used", "refurbished", "open_box" ], "enumTitles": [ "All conditions (legacy)", "Any condition", "New", "Used", "Refurbished", "Open box" ], "default": "any", "prefill": "any" }, "priceMin": { "title": "Minimum price", "type": "number", "description": "Lowest price in the country currency (mode=search/seller). 0 means no minimum.", "minimum": 0, "default": 0, "prefill": 0 }, "priceMax": { "title": "Maximum price", "type": "number", "description": "Highest price in the country currency (mode=search/seller). 0 means no maximum.", "minimum": 0, "default": 0, "prefill": 0 }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Keep products with free shipping (mode=search/seller).", "default": false, "prefill": false }, "fullShippingOnly": { "title": "MercadoLibre FULL only", "type": "boolean", "description": "Keep products fulfilled by MercadoLibre FULL (mode=search/seller).", "default": false, "prefill": false }, "officialStoresOnly": { "title": "Official stores only", "type": "boolean", "description": "Keep products sold by official stores (mode=search/seller).", "default": false, "prefill": false }, "minDiscount": { "title": "Minimum discount %", "type": "integer", "description": "Keep products discounted by at least this percentage (mode=search/seller/deals). 0 disables it.", "minimum": 0, "maximum": 100, "default": 0, "prefill": 0 }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Include paid placements in search and seller results.", "default": true, "prefill": true }, "includeDetails": { "title": "Enrich with product details", "type": "boolean", "description": "Fetch the full detail page for every search or seller result (mode=search/seller). Slower, more fields.", "default": false, "prefill": false }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Attach review summary and review rows to product records (mode=product).", "default": false, "prefill": false }, "includeQuestions": { "title": "Include questions", "type": "boolean", "description": "Attach buyer questions and answers to product records (mode=product).", "default": false, "prefill": false }, "includeSellerProfile": { "title": "Include seller profile", "type": "boolean", "description": "Emit a seller profile row before the catalog (mode=seller).", "default": false, "prefill": false }, "includeAttributes": { "title": "Include category attributes", "type": "boolean", "description": "Attach the attribute schema to a category record (mode=categories with categoryId).", "default": false, "prefill": false }, "maxItems": { "title": "Maximum items", "type": "integer", "description": "Maximum records to return. Product queries stop at the source's 2,000-row window.", "minimum": 1, "maximum": 10000, "default": 50, "prefill": 1 }, "maxReviews": { "title": "Maximum reviews", "type": "integer", "description": "Maximum review rows per product (mode=reviews). Values above 330 sweep every rating bucket.", "minimum": 1, "maximum": 1650, "default": 30, "prefill": 30 }, "reviewRating": { "title": "Review rating filter", "type": "string", "description": "Only collect reviews with this star rating (mode=reviews).", "editor": "select", "enum": [ "all", "1", "2", "3", "4", "5" ], "enumTitles": [ "All ratings", "1 star", "2 stars", "3 stars", "4 stars", "5 stars" ], "default": "all", "prefill": "all" }, "maxQuestions": { "title": "Maximum questions", "type": "integer", "description": "Maximum buyer questions per product (mode=questions/product).", "minimum": 1, "maximum": 500, "default": 20, "prefill": 20 } }, "required": [ "mode", "siteId" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "MercadoLibre Multi-Country Marketplace Scraper Output", "description": "MercadoLibre products, reviews, questions, categories, seller profiles, best sellers and deals across 18 country sites.", "properties": { "products": { "type": "string", "title": "MercadoLibre records", "description": "Dataset containing product, review, question, category, seller and best-seller records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Products and marketplace records", "transformation": { "fields": [ "recordType", "itemId", "title", "price", "currency", "condition", "sellerName", "freeShipping", "rank", "itemUrl" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "2.0.1", "imageDigest": "5b5ae6e1083c692ca29f3987fab3e4bcdaeb2fd024a962c93214213719fab7ec", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "2.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.0035066666666666666 } } }