MercadoLibre Scraper: Search, Products, Reviews, Q&A, Sellers

MercadoLibre search, products, reviews, Q&A & sellers across Latin America

Scrape MercadoLibre and Mercado Livre at scale. Get search results, full product listings, customer reviews, buyer questions, seller answers, and entire seller catalogs from one actor.

Today: $5 per 1,000 results at the free tier, down to $2 per 1,000 at the top discount tier. From October 8, 2026, plain search results drop to $1 per 1,000 on every paid plan.

Search and product mode work in 18 Latin American countries. Reviews come from the nine countries where MercadoLibre shows them, seller catalogs from 17. Paste a URL or keyword and run, no login, no proxy setup.

What makes this the best MercadoLibre scraper

• Up to 2,000 results per search, not just the first page of about 48. Set maxItems and the actor walks the pages for you.
• 18 countries in search mode, including Central America, Bolivia, Paraguay and Venezuela.
• Organic results only. Sponsored listings are left out, and every row carries its real position in the results.
• Four modes in one actor, replaces running Search, Product Detail, Reviews, and Seller as separate scrapers.
• Product details on search rows that match the listing you see: the seller, stock and warranty of that exact listing, not of another seller offering the same product.
• Warranty, returns, shipping type (Full or seller-shipped), feature list and star breakdown on search rows with product details turned on, whenever the product page shows them.
• Only scraper with buyer Q&A: every product includes the full questions and seller answers, up to 20 per product.
• Only scraper with product variations: every color, storage, and size variant returned.
• Top 5 reviews inline for free on every product PDP.
• Every product spec on the page: RAM, battery, model, brand, dimensions, color, often 60 or more.
• Seller details on every product: name, reputation level, power seller status, official store flag and store name.
• Installments / "meses sin intereses": quantity, per payment amount, total.
• Free shipping detection plus return policy: days, method, fees.
• Seller catalogs by URL, seller ID or nickname in 17 countries, with rating and units sold on every listing, plus a profile row with followers, logo and banner for brand stores and shops.

Supported marketplaces

Country	Domain	Currency	Modes
🇲🇽 Mexico	mercadolibre.com.mx	MXN	all four
🇦🇷 Argentina	mercadolibre.com.ar	ARS	all four
🇧🇷 Brazil	mercadolivre.com.br	BRL	all four
🇨🇱 Chile	mercadolibre.cl	CLP	all four
🇨🇴 Colombia	mercadolibre.com.co	COP	all four
🇵🇪 Peru	mercadolibre.com.pe	PEN	all four
🇺🇾 Uruguay	mercadolibre.com.uy	UYU	all four
🇪🇨 Ecuador	mercadolibre.com.ec	USD	all four
🇩🇴 Dominican Republic	mercadolibre.com.do	DOP	all four
🇧🇴 Bolivia	mercadolibre.com.bo	BOB	search, product, seller
🇨🇷 Costa Rica	mercadolibre.co.cr	CRC	search, product
🇬🇹 Guatemala	mercadolibre.com.gt	GTQ / USD	search, product, seller
🇭🇳 Honduras	mercadolibre.com.hn	HNL	search, product, seller
🇳🇮 Nicaragua	mercadolibre.com.ni	NIO	search, product, seller
🇵🇦 Panama	mercadolibre.com.pa	PAB / USD	search, product, seller
🇵🇾 Paraguay	mercadolibre.com.py	PYG / USD	search, product, seller
🇸🇻 El Salvador	mercadolibre.com.sv	USD	search, product, seller
🇻🇪 Venezuela	mercadolibre.com.ve	VES / USD	search, product, seller

Several of the newer countries list local and US dollar prices side by side. Every row carries the currency of its own price, so nothing is converted or guessed.

Four scraping modes

🔍 Search mode

Type a keyword (for example, iphone 15) or paste a search or category URL. Get one row per product card with title, brand, thumbnail, price, currency, rating, condition, item ID, category, units sold, seller or official store name, and position in the results. Every row also carries the shipping line, whether shipping is free and arrives next day, the monthly payment plan, the price before discount, the discount percentage, and labels like MÁS VENDIDO.

Results go past the first page. Set maxItems to how many you want (up to 2,000 per search, or 0 for all of them) and the actor pages through for you.

Need more than the listing shows? Turn on Scrape product details for each result and every row also carries the full description, complete image gallery, seller ID and reputation, stock line, attributes, category breadcrumbs, warranty, return policy, shipping type, feature list and star breakdown when the product page shows them, plus the rating and number of ratings shown on the product page. Runs take longer because each result is opened individually. See the pricing section for how this is charged before and after October 8, 2026.

📦 Product mode

Paste a product URL (catalog /p/, listing /up/, item page, or a plain ID like MLM27172669). Get a full product detail record per URL:

• Title, the description shown on the product page, brand, condition, SKU, the full high resolution image gallery
• Current price, original price, discount percentage as MercadoLibre shows it, currency, stock line
• Rating, number of ratings, star breakdown, total review count, top 5 reviews inline
• Seller name, reputation level, power seller status, official store flag and store name
• The listing ID of the offer the page shows, and units sold on item pages
• Installments as the page shows them: quantity, per payment amount, total
• Shipping: free flag, shipping type (Full or seller-shipped), origin, destination, handling and transit days
• Warranty, return policy and the feature list, whenever the product page shows them
• Every color / storage / size variant
• Up to 20 buyer questions with the seller's answers and timestamps
• Breadcrumbs and every technical spec on the page
• Car and motorcycle ads work too

Turn off reviews, questions or variations in the Product mode options when you do not need them. Rows appear in the order of your URLs.

⭐ Reviews mode

Paste a product URL. Get one row per review with star rating, full review text, date, reviewer country, likes count, and attached photos or videos.

Set Max Items to 0 for the full sweep: every star rating, both sort orders and each country's own review list for the product, with no review returned twice. Products with up to a few hundred reviews come back complete. The most reviewed products (thousands of reviews) can return a couple of thousand unique reviews, because MercadoLibre stops every review list after a few hundred entries.

Catalog URLs (/p/), listing URLs (/up/), item URLs (articulo.) and plain IDs all work. An item URL returns the listing's own reviews, or, when the listing belongs to a catalog product, the same reviews its catalog URL returns. A product with no reviews returns no rows and costs nothing, and when none of the products in a run have reviews, the run ends with a message saying so.

🏪 Seller mode

Paste a seller's listings URL, a brand store or shop URL, a numeric seller ID, or a seller nickname. Get the seller's catalog, one row per listing, plus a profile row for brand stores and shops.

What each input returns:

• Brand store (/tienda/<name>, /loja/<name> on Brazil): that store's own listings only, even when the same company runs other stores, plus the store's profile row where MercadoLibre has a store page.
• Seller listings URL, seller ID or nickname: every listing the seller has. When the seller runs a shop page, its profile row comes too.
• Nicknames work in Mexico, Brazil, Uruguay and Colombia, including names with spaces such as DIMM OK. Where a nickname only opens a reputation page (for example the Dominican Republic), the run says so and asks for the seller ID or listings URL.

Catalog rows (up to 2,000 per seller) with title, price with cents, currency, rating, units sold, the shipping line, free shipping flag, monthly payment plan, price before discount, discount percentage, condition, item and catalog IDs, the listing's position in the seller's catalog, and the seller's name and ID, plus the nickname and the seller's total number of listings when the listings page shows them. Store rows also carry the official store name and ID.

Profile row (one per brand store or shop) with 30+ fields:

• Seller ID and name, shop name, shop type, slug, official store ID
• Followers count, date created, status, brand registry
• Logo, banner image, mobile banner, header style, subdomain
• Tags such as priority_brand or has_followers
• Compliance flags: has_moderations, has_debts, restrictions
• Free trial start, end, and period
• Section menu with each section's name, URL, and category ID

MercadoLibre does not publish sellers' addresses, phone numbers or email addresses, so sellerAddress, sellerPhone and sellerEmail are always null.

The profile row counts toward maxItems: maxItems: 30 on a brand store returns the profile plus 29 listings. A seller or store that does not exist returns no rows and a message saying so, and costs nothing.

Top use cases

Search mode

• Full category and keyword sweeps: up to 2,000 results per search, organic only, with sold counts and positions.
• Auto parts and spare parts catalogs: warranty, returns, shipping type and seller for every listing, with product details on.
• Market research: which brands dominate which categories in each country.
• SEO and keyword research: which products surface for high volume keywords and how they rate.

Product mode

• Catalog enrichment: pull images, specs, descriptions, return policy, and installments for Shopify or WooCommerce imports.
• Competitive pricing: monitor a list of competitor products daily, track price and discount drift.

Reviews mode

• Review sentiment analytics: scrape thousands of star rated reviews with media for ML or QA research.
• Voice of customer: monitor reviews on a new launch SKU across MX, AR, BR.

Seller mode

• Lead generation: find official stores with high followers, priority brand tags, and brand registry.
• Brand and MAP monitoring: track every catalog item a brand store lists, spot unauthorized resellers.
• Dropshipping sourcing: find high reputation sellers with broad catalogs in BR and MX.
• Competitive seller analysis: compare catalog size, ratings, units sold, follower growth and pricing across rival sellers.

How much does MercadoLibre Scraper cost?

You pay per result, and the rate drops as your Apify Store discount tier goes up. No subscription lock-in and no minimum spend.

Today, until October 8, 2026 (all modes)

Apify Store discount tier	Price per 1,000 results
Free	$5
Bronze (Starter)	$4
Silver (Scale)	$3
Gold (Business), Platinum, Diamond	$2

Product details on search rows are included in that price, and there is no per-run fee. The Apify Free plan's $5 in monthly credits covers about 1,000 results.

From October 8, 2026, search mode gets its own, lower price

Charge	Free	Bronze (Starter)	Silver (Scale)	Gold (Business), Platinum, Diamond
Search result, per 1,000 rows	$2	$1	$1	$1
Add-on: search product details, per 1,000 rows	$2	$1.50	$1	$1
Search run start, per run	$0.005	$0.005	$0.005	$0.005

The product details add-on is charged on top of the search result, only for rows whose product page was read successfully. So a search row with details costs $2 per 1,000 on Scale and Business ($1 + $1), and a plain search row costs $1. Product, reviews and seller mode keep today's prices.

Examples on the Business plan

• 1,000 search results: $2.00 today, $1.005 from October 8.
• 1,000 search results with product details: $2.00 today, $2.005 from October 8.
• 50 full product detail records with Q&A: $0.10.
• 300 reviews for one product: $0.60.

Input examples

Search mode

{
  "mode": "search",
  "country": "MX",
  "searchQuery": "iphone 15",
  "maxItems": 3
}

Product mode

{
  "mode": "product",
  "country": "MX",
  "productUrls": [
    "https://www.mercadolibre.com.mx/apple-iphone-15-256-gb-negro/p/MLM27172669"
  ],
  "maxItems": 1,
  "includeReviews": true,
  "includeQuestions": true,
  "includeVariations": true
}

Reviews mode

{
  "mode": "reviews",
  "country": "MX",
  "productUrls": [
    "https://www.mercadolibre.com.mx/apple-iphone-15-256-gb-negro/p/MLM27172669"
  ],
  "maxItems": 100
}

Seller mode

{
  "mode": "seller",
  "country": "MX",
  "sellerUrls": [
    "https://www.mercadolibre.com.mx/tienda/phone-depot"
  ],
  "maxItems": 50,
  "includeSellerProfile": true
}

Output examples

Every row carries mode, country, and scrapedAt. Real rows captured from live runs.

Search mode, one row per product card (this one is result 51, from the second page):

{
  "mode": "search",
  "country": "MX",
  "siteId": "MLM",
  "productId": "MLM1471908851",
  "catalogProductId": null,
  "userProductId": "MLMU469831566",
  "title": "Filtro Aceite Ac Delco Chevy, Aveo, Corsa Tornado 1.8 Pf47",
  "url": "https://www.mercadolibre.com.mx/filtro-aceite-ac-delco-chevy-aveo-corsa-tornado-18-pf47/up/MLMU469831566",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_808365-MLA106452528337_022026-F.jpg",
  "brand": "ACDelco",
  "price": 118,
  "currency": "MXN",
  "availability": "InStock",
  "rating": 4.9,
  "ratingCount": null,
  "reviewCount": null,
  "position": 51,
  "scrapedAt": "2026-09-24T11:21:47.071Z",
  "isInternational": false,
  "condition": "NewCondition",
  "freeShipping": true,
  "shippingText": "Llega gratis hoy",
  "installments": null,
  "originalPrice": 193.53,
  "discountPercentage": 39,
  "itemId": "MLM1471908851",
  "soldQuantity": 500,
  "nextDayDelivery": false,
  "categoryId": "MLM164742",
  "domainId": "MLM-VEHICLE_OIL_FILTERS",
  "sellerName": "Reluvsa",
  "isOfficialStore": true,
  "officialStoreName": "Reluvsa",
  "highlight": null,
  "variations": null,
  "variationCount": null,
  "promotions": null,
  "conditionalPrice": null,
  "conditionalPriceNote": null
}

Search mode with product details turned on, same row shape plus the detail fields:

{
  "mode": "search",
  "country": "MX",
  "siteId": "MLM",
  "productId": "MLM4458245188",
  "catalogProductId": "MLM62784937",
  "userProductId": "MLMU3195731812",
  "title": "W555 W-555 Dual Sim 64 Gb Negro 4 Gb Ram",
  "url": "https://www.mercadolibre.com.mx/w555-w-555-dual-sim-64-gb-negro-4-gb-ram/p/MLM62784937",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_964074-MLA108112370391_032026-F.jpg",
  "brand": "W555",
  "price": 1195.83,
  "currency": "MXN",
  "availability": "InStock",
  "rating": 4.5,
  "ratingCount": 699,
  "reviewCount": null,
  "position": 1,
  "scrapedAt": "2026-09-24T11:21:57.340Z",
  "isInternational": false,
  "condition": "NewCondition",
  "freeShipping": true,
  "shippingText": "Envío gratis",
  "installments": {
    "quantity": 6,
    "amount": 199.3,
    "rate": 0,
    "total": 1195.83
  },
  "originalPrice": 4525,
  "discountPercentage": 73,
  "itemId": "MLM4458245188",
  "soldQuantity": 5000,
  "nextDayDelivery": false,
  "categoryId": "MLM1055",
  "domainId": "MLM-CELLPHONES",
  "sellerName": "W555",
  "highlight": "MÁS VENDIDO",
  "isOfficialStore": true,
  "officialStoreName": "W555",
  "description": "-------------------------------------------\nACERCA DE ESTE PRODUCTO:\n-------------------------------------------\n\nTeléfono Inteligente Indus (...)",
  "images": [
    "https://http2.mlstatic.com/D_NQ_NP_964074-MLA108112370391_032026-O.jpg",
    "https://http2.mlstatic.com/D_NQ_NP_858947-MLA108112280189_032026-O.jpg",
    "https://http2.mlstatic.com/D_NQ_NP_646059-MLA115148094176_082026-O.jpg",
    "(...6 more)"
  ],
  "sellerId": "451019138",
  "sellerReputation": "5_green",
  "sellerPowerStatus": "platinum",
  "attributes": [
    {
      "name": "Marca",
      "value": "W555"
    },
    {
      "name": "Modelo",
      "value": "W-555"
    },
    {
      "name": "Color",
      "value": "Negro"
    },
    "(...11 more)"
  ],
  "breadcrumbs": [
    "Celulares y Telefonía",
    "Celulares y Smartphones",
    "Moto G82"
  ],
  "stockText": "+50 disponibles",
  "ratingDistribution": {
    "1": 6.44,
    "2": 2.29,
    "3": 5.01,
    "4": 11.16,
    "5": 75.11
  },
  "logisticType": "fulfillment",
  "productBrandId": "67547945",
  "returnPolicy": {
    "country": "MX",
    "category": "MerchantReturnFiniteReturnWindow",
    "days": 30,
    "method": "ReturnByMail",
    "fees": "FreeReturn"
  },
  "warranty": {
    "type": null,
    "duration": 12,
    "unit": "months",
    "text": "12 meses de garantía de fábrica."
  },
  "features": [
    "Memoria RAM: 4 GB.",
    "Dispositivo desbloqueado para que elijas la compañía telefónica que prefieras.",
    "Pantalla de 5.71\".",
    "(...1 more)"
  ],
  "detailScraped": true,
  "variations": null,
  "variationCount": null,
  "promotions": null,
  "conditionalPrice": null,
  "conditionalPriceNote": null
}

Product mode, one row per product:

{
  "mode": "product",
  "country": "MX",
  "siteId": "MLM",
  "productId": "MLM27172669",
  "catalogProductId": "MLM27172669",
  "title": "Apple iPhone 15 (256 GB) - Negro",
  "url": "https://www.mercadolibre.com.mx/apple-iphone-15-256-gb-negro/p/MLM27172669",
  "thumbnail": "https://http2.mlstatic.com/D_NQ_NP_898880-MLA95937583859_102025-O.webp",
  "images": [
    "https://http2.mlstatic.com/D_NQ_NP_898880-MLA95937583859_102025-O.jpg",
    "https://http2.mlstatic.com/D_NQ_NP_992482-MLA95497883070_102025-O.jpg",
    "(...8 more)"
  ],
  "brand": "Apple",
  "description": "Este IPhone es compatible con eSIM. Contacta a tu operador móvil para conocer cómo activarla. El iPhone 15 viene con la Dynamic Island, cáma (...)",
  "price": 14408.23,
  "originalPrice": null,
  "discountPercentage": null,
  "currency": "MXN",
  "availability": "InStock",
  "condition": "NewCondition",
  "stockText": "+10 disponibles",
  "sku": "MLM27172669",
  "rating": 4.8,
  "ratingCount": 11786,
  "reviewCount": 4502,
  "installments": {
    "quantity": 15,
    "amount": 960.55,
    "total": 14408.25
  },
  "freeShipping": true,
  "shippingText": null,
  "shipping": {
    "free": true,
    "text": null,
    "cost": 0,
    "currency": null,
    "originCountry": null,
    "originRegion": null,
    "destinationCountry": null,
    "destinationRegion": null,
    "handlingMinDays": null,
    "handlingMaxDays": null,
    "transitMinDays": null,
    "transitMaxDays": null
  },
  "returnPolicy": {
    "country": "MX",
    "category": "MerchantReturnFiniteReturnWindow",
    "days": 30,
    "method": "ReturnByMail",
    "fees": "FreeReturn"
  },
  "sellerId": "2290879817",
  "sellerName": "Wireless Experts Store",
  "sellerReputation": "5_green",
  "sellerPowerStatus": "platinum",
  "isOfficialStore": null,
  "officialStoreName": null,
  "breadcrumbs": [
    "Celulares y Telefonía",
    "Celulares y Smartphones",
    "Apple Iphone 14 Pro Max 512 Gb Negro"
  ],
  "categoryId": "MLM1055",
  "domainId": "MLM-CELLPHONES",
  "attributes": [
    {
      "name": "Marca",
      "value": "Apple"
    },
    {
      "name": "Línea",
      "value": "iPhone 15"
    },
    {
      "name": "Modelo",
      "value": "iPhone 15"
    },
    "(...68 more)"
  ],
  "variations": [
    {
      "id": "MLM27172679",
      "attributes": {
        "color": "Amarillo"
      }
    },
    {
      "id": "MLM27172673",
      "attributes": {
        "color": "Azul"
      }
    },
    "(...6 more)"
  ],
  "reviews": [
    {
      "text": "Producto chino pero 100% original, tomando en cuenta que todos los iphone se producen en china, solo (...)",
      "rating": 5
    },
    "(...4 more)"
  ],
  "questions": [
    {
      "id": 13659055141,
      "text": "Cuantos miliaperios tiene de batería",
      "answer": "El iPhone 15 estándar tiene una capacidad de batería de 3.349 miliamperios-hora (mAh).",
      "answerDate": "21/09/2026"
    },
    "(...5 more)"
  ],
  "promotions": null,
  "scrapedAt": "2026-09-24T19:11:01.126Z",
  "isInternational": false,
  "itemId": "MLM6052658612",
  "userProductId": null,
  "soldQuantity": null,
  "logisticType": "fulfillment",
  "warranty": null,
  "features": [
    "Memoria RAM: 6 GB.",
    "La Dynamic Island te muestra alertas y actividades en vivo.",
    "Diseño innovador con pantalla Super Retina XDR.",
    "(...6 more)"
  ],
  "ratingDistribution": {
    "1": 2.6,
    "2": 0.3,
    "3": 0.92,
    "4": 5.59,
    "5": 90.58
  },
  "productBrandId": "9344"
}

Reviews mode, one row per review:

{
  "mode": "reviews",
  "country": "MX",
  "siteId": "MLM",
  "productId": "MLM27172669",
  "catalogProductId": "MLM27172678",
  "reviewId": 803375213,
  "reviewRating": 5,
  "reviewText": "Producto chino pero 100% original, tomando en cuenta que todos los iphone se producen en china, solo cambia el empaquetado para el país que va a ser d (...)",
  "reviewDate": "2023-11-21T16:00:16Z",
  "reviewDateText": "Hace más de 1 año",
  "reviewCountry": "México",
  "reviewLikes": 2547,
  "reviewMedia": [
    "https://http2.mlstatic.com/D_NQ_NP_2X_698307-MLA72919050762_112023-O.webp"
  ],
  "title": null,
  "scrapedAt": "2026-09-15T15:21:51.989Z"
}

Two date fields, because they answer different questions:

• reviewDate is the exact publish time in ISO 8601 (2023-11-21T16:00:16Z). Use this one to sort, filter by period, or compare reviews.
• reviewDateText is the wording MercadoLibre shows on the page, in the language of that marketplace (Hace más de 1 año on MX and AR, Há 2 meses on BR). Useful if you are mirroring what a shopper sees, but it is relative to the moment you scraped and it does not age well in storage.

catalogProductId is the catalog entry the review belongs to. It is often a different ID than the one you submitted, because MercadoLibre groups several listings of the same product under one catalog family and shares their reviews.

Seller mode, profile row (selected fields):

{
  "mode": "seller",
  "kind": "profile",
  "country": "MX",
  "sellerId": "95428411",
  "sellerName": "PHONE DEPOT",
  "sellerSlug": "phone-depot",
  "sellerProfileUrl": "https://www.mercadolibre.com.mx/tienda/phone-depot",
  "shopName": "PHONE DEPOT",
  "shopType": "brand",
  "officialStoreId": 281110,
  "isOfficialStore": true,
  "officialStoreName": "PHONE DEPOT",
  "totalFollowers": 1235,
  "dateCreated": "2025-12-06T12:50:40.916207848Z",
  "status": "active",
  "hasModerations": false,
  "hasDebts": false,
  "tags": ["normal_store", "has_followers"],
  "brandName": "PHONE DEPOT",
  "brandRegistryId": "77489",
  "logoUrl": "https://http2.mlstatic.com/D_NQ_NP_779110-MLA100764709370_122025-F.jpg",
  "bannerUrl": "https://http2.mlstatic.com/D_NQ_NP_871870-MLA106237878880_022026-F.jpg",
  "sellerAddress": null,
  "sellerPhone": null,
  "sellerEmail": null,
  "scrapedAt": "2026-09-26T16:19:53.265Z"
}

Seller mode, catalog row:

{
  "mode": "seller",
  "country": "MX",
  "siteId": "MLM",
  "productId": null,
  "catalogProductId": "MLM40375539",
  "userProductId": null,
  "title": "Drone Dji Neo 2 Fly More Combo Br - Dji051 Color Gris",
  "url": "https://www.mercadolibre.com.mx/drone-dji-neo-2-fly-more-combo-br-dji051-color-gris/p/MLM40375539?pdp_filters=seller_id%3A2706404087",
  "thumbnail": "https://http2.mlstatic.com/D_Q_NP_2X_803681-MLU79035889035_092024-E.webp",
  "brand": null,
  "price": 5479,
  "currency": "MXN",
  "availability": "InStock",
  "rating": 4.9,
  "ratingCount": null,
  "reviewCount": null,
  "freeShipping": true,
  "shippingText": "Llega gratis hoy",
  "installments": { "quantity": 15, "amount": 365.27, "rate": 0, "total": 5479.05 },
  "originalPrice": null,
  "discountPercentage": null,
  "position": 1,
  "scrapedAt": "2026-09-26T16:19:55.035Z",
  "condition": "NewCondition",
  "itemId": "MLM6041080590",
  "kind": "item",
  "sellerId": "2706404087",
  "sellerName": "vicer",
  "sellerSlug": "vicer",
  "sellerProfileUrl": "https://www.mercadolibre.com.mx/pagina/vicer",
  "isInternational": false,
  "soldQuantity": 10000,
  "sellerNickname": null,
  "totalListings": 60
}

In seller rows, position is the listing's place in the seller's catalog, soldQuantity is the units-sold bucket shown on the listing, sellerNickname is filled when MercadoLibre names the seller by nickname on the listings page, and totalListings is how many listings the seller (or, for a brand store, the store) has in total.

itemId is the ID of that specific listing, one seller's offer. It is filled on nearly every search row. On catalog listings, catalogProductId is the shared catalog entry several sellers can list under.

position is the rank in the results across all pages, counting organic listings only. Numbers can skip where MercadoLibre shows the same listing twice.

soldQuantity is the units sold as MercadoLibre shows it, in buckets like 50, 500 or 5000, so treat it as a magnitude. highlight is the label on the card, such as MÁS VENDIDO.

ratingCount on a plain search row is null, because the count on the search page does not match the one on the product page. Turn on product details and rating and ratingCount come together from the product page, so they always describe the same thing.

With product details on:

• logisticType is how MercadoLibre ships the listing: fulfillment means stored and shipped by Mercado Libre Full, self_service is Flex, cross_docking, xd_drop_off or drop_off mean the seller ships it, and not_specified or custom mean the seller arranges it. It can vary with the delivery location.
• warranty is the warranty as the listing states it: type (seller, factory or none, and null when the page does not clearly say whose warranty it is), duration, unit, and the text shown.
• returnPolicy is included only when the product page shows the same policy.
• features is the product's list of key points. ratingDistribution is the percent of ratings per star.
• detailScraped is true when the product page was read and merged, and false when it could not be read. Those rows keep their search fields.

isInternational is true when MercadoLibre marks the listing as international or cross-border shipping, and false for a regular domestic listing. It appears on search, product and seller rows, and comes from the listing page itself, so no detail fetch is needed. Reviews rows do not carry it.

condition is NewCondition, UsedCondition, RefurbishedCondition or OpenBoxCondition. It comes from the listing page itself, so it arrives on search and seller rows with no detail fetch. It is null when MercadoLibre does not state a condition, which is the case for vehicle, property and service listings, where the site shows attributes like year or floor area instead.

stockText is the remaining stock exactly as MercadoLibre prints it above the buy buttons: 4 disponibles, +10 disponibles, or Ultima en Stock! when one is left. A plus sign means at least that many, not exactly that many, because MercadoLibre caps the figure it shows. It comes from the product page, so it appears on product rows and on search rows when detail scraping is on. It is null when the page states no figure, for example on pre-order listings.

Limitations

• Search and seller catalogs stop at 2,000 items per query or per seller. To go deeper, split the work: narrower keywords, category filters, or one run per storefront section.
• Sponsored listings are not included in search results. You get the organic results, ranked as MercadoLibre ranks them.
• Seller mode works in 17 countries. In Costa Rica MercadoLibre currently shows no seller listings, so a Costa Rica seller run ends with a message saying so and costs nothing. Profile rows come from brand stores and shops. Argentina and the nine newer countries have no store profile pages, so a store URL there returns the store's listings without the profile row and without sellerId; use the seller's ID or listings URL when you need it.
• Product pages in the Dominican Republic, Bolivia, Costa Rica, Guatemala, Honduras, Nicaragua, Panama, Paraguay and El Salvador have no reviews on MercadoLibre today. A reviews run on them ends with a "No reviews" message and no charge, and picks up reviews as soon as they appear.
• The most reviewed products cannot be read in full. MercadoLibre stops every review list after a few hundred entries; the actor combines many lists, but products with thousands of reviews return part of them.
• Buyer Q&A caps at 20 questions per product, which is what the product page itself surfaces, not the full history.
• Product mode returns the top 5 reviews inline. For the deep review set, use reviews mode.
• A catalog URL (/p/) shows the offer MercadoLibre puts first right now, so its seller, price and itemId can change between runs. Use an item URL to follow one seller's listing.
• Public pages only. No buyer names beyond what MercadoLibre publishes, no order history. MercadoLibre does not publish sellers' addresses, phone numbers or emails, so seller rows never include them.

Frequently asked questions

Does this scraper work for Mercado Livre Brasil?

Yes. Pick BR as the country and the actor returns BRL prices and Portuguese content. Brazil is fully supported in all four modes.

Do I need to log in or provide cookies?

No. Paste a URL or a keyword and run. There is nothing to configure, no account on MercadoLibre, and no proxy setup.

Will I get blocked?

No. The actor handles bot protection automatically and retries on its own when a request is refused.

How do I find a seller's ID?

Open the seller's store or listings page on MercadoLibre and copy the URL. Brand stores, shop pages, a seller's listings URL, seller profile URLs, numeric seller IDs and plain nicknames all work as input. A listing URL that contains seller_id= works too.

How many results can one search return?

Up to 2,000 per keyword or search URL. Set maxItems to the number you want, or 0 for everything up to that limit. You pay for the rows delivered, plus from October 8, 2026 a $0.005 fee per search run.

Can I scrape products by keyword instead of URL?

Yes. Pick search mode and type the keyword in searchQuery. Example: { "mode": "search", "country": "MX", "searchQuery": "iphone 15", "maxItems": 100 }.

What happens when a product or seller URL is not found?

Nothing is charged for it. The run finishes successfully and the page is skipped, so a typo or a dead listing in a large batch never costs you money and never fails the run.

In search mode, if none of your Start URLs can be read, the run stops with a message and charges nothing. The search keyword is only used when no Start URLs are given.

How much does MercadoLibre Scraper cost?

Today you pay $5 per 1,000 results at the free tier, down to $2 per 1,000 at the top Apify Store discount tier, in every mode. From October 8, 2026, search mode costs $1 per 1,000 rows on every paid plan, with product details as a $1 to $1.50 add-on and $0.005 per search run. Full breakdown in the pricing section above.

Is it legal to scrape MercadoLibre?

Scraping public data is generally allowed in the US and most of the EU, as long as you don't collect personal data covered by GDPR or CCPA without a lawful basis. This actor only touches publicly accessible pages, but how you use the output is on you.

Apify's full breakdown: Is web scraping legal?.

Does it support scheduled runs and integrations?

Yes. Schedule it daily, weekly, or hourly in Apify Console to monitor prices, inventory, or new listings. Results push into Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google Drive, and anything else that consumes webhooks.

Full list: Apify integrations.

Can I use it with the Apify API?

Yes. Every run is available via the Apify REST API:

curl -X POST "https://api.apify.com/v2/acts/sourabhbgp~mercadolibre-scraper/runs?token=APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "search", "country": "MX", "searchQuery": "iphone 15", "maxItems": 100}'

Docs: Apify API reference.

Can I use it through an MCP Server?

Yes. Apify ships an MCP server that exposes every actor as a tool, so Claude Desktop, Cursor, and any other MCP capable client can call this scraper. Setup: Apify MCP docs.

Your feedback

Bug, missing field, or odd behavior? Drop a note in the Issues tab. Reports go to a human and fixes usually ship the same week.

Legal

This actor is not affiliated with, endorsed by, or sponsored by MercadoLibre S.R.L. or its subsidiaries. Only data from publicly accessible pages is extracted. Respect MercadoLibre's Terms of Service and use the data responsibly.