MercadoLibre Product and Seller Data Scraper

Extract structured MercadoLibre and Mercado Livre listings across supported Latin American marketplaces. Search by keyword or process product, review, question, seller, and category URLs to receive prices, product attributes, seller signals, shipping details, reviews, and buyer Q&A.

Use the Actor for regional ecommerce research, assortment analysis, price monitoring, seller intelligence, catalog enrichment, and AI workflows that need consistent marketplace records.

Best fit

• Ecommerce teams comparing listings across Latin American marketplaces.
• Brands monitoring prices, verified store signals, sellers, and product attributes.
• Analysts organizing customer reviews and buyer questions around selected products.
• Catalog teams enriching product IDs and URLs with marketplace details.
• AI research agents that need explicit country and record provenance.

A practical market-research scenario

A regional analyst searches for smartphones in Mexico and collects listing cards with prices, condition, seller, shipping, and product URLs. Selected item IDs then move through product mode for pictures, attributes, variations, and seller details. Review and question modes add customer language and purchase considerations. The analyst can repeat the same workflow for Brazil or Argentina while preserving country, siteId, itemId, and source as stable join and provenance fields.

This creates one regional dataset while keeping each marketplace context visible.

Supported workflows

Mode	Input	Result
auto	Mixed URLs or item IDs	Detects the matching workflow for each target.
search	searchQuery or search URL	Listing cards with prices, sellers, shipping, and product links.
product	Product URL or item ID	Product attributes, variations, pictures, availability, and seller details.
reviews	Product URL or item ID	Individual customer review records.
questions	Product URL or item ID	Buyer questions and seller answers.
seller	Seller profile URL	Seller reputation and associated listing data.
category	Category URL	Listings from the selected marketplace category.

Quick start

Search in Mexico

{
  "searchQuery": "wireless headphones",
  "country": "MX",
  "mode": "search",
  "maxResults": 25,
  "sortBy": "relevance"
}

Enrich a product

{
  "startUrls": [
    {
      "url": "https://articulo.mercadolibre.com.mx/MLM-1234567890-product"
    }
  ],
  "mode": "product",
  "extendedDetails": true
}

Use automatic routing for several markets

{
  "startUrls": [
    { "url": "MLA1234567890" },
    { "url": "MLB987654321" },
    { "url": "https://articulo.mercadolibre.com.mx/MLM-555444333-product" }
  ],
  "mode": "auto",
  "maxResults": 30
}

Input reference

Field	Purpose
searchQuery	Keyword used for marketplace search.
startUrls	Product, search, category, seller, or raw item-ID targets.
mode	Selects automatic routing or a focused extraction workflow.
country	Marketplace context for keyword searches.
maxResults	Upper bound for dataset records.
sortBy	Orders search and category listings.
condition	Focuses results on any, new, or used products.
minPrice, maxPrice	Applies a local-currency price range.
freeShipping	Focuses discovery on free-shipping listings.
officialStoreOnly	Focuses discovery on marketplace-verified stores.
extendedDetails	Enriches discovered listings with full product data.
includeReviews	Adds review records when the selected flow supports them.
proxyConfiguration	Controls marketplace browsing sessions.

The country field supports Mexico, Brazil, Argentina, Chile, Colombia, Peru, Uruguay, Ecuador, and the Dominican Republic. URLs and item IDs can carry their own marketplace identity in automatic mode.

Output data

Records can include:

• mode, country, siteId, itemId, and canonical url
• title, price, originalPrice, currencyId, and discountPercent
• condition, soldQuantity, availableQuantity, and freeShipping
• pictures, attributes, variations, categoryId, and categoryPath
• sellerId, sellerName, sellerReputation, and seller location
• review ratings, review text, reviewer names, and helpful-vote signals
• buyer questions, seller answers, and associated timestamps
• source, dateScraped, and _warnings for provenance and record context

{
  "mode": "search",
  "country": "MX",
  "siteId": "MLM",
  "itemId": "MLM1234567890",
  "title": "Wireless Bluetooth Headphones",
  "price": 899,
  "currencyId": "MXN",
  "condition": "new",
  "freeShipping": true,
  "sellerName": "Example Store",
  "source": "html"
}

AI agent workflows

The explicit mode, country, and source fields make the Actor suitable for Apify MCP and direct API tool calls.

Example agent request:

Search MercadoLibre Mexico for wireless headphones, return prices, shipping, seller names, and product IDs, then enrich selected products with attributes and variations.

Useful routing guidance:

• Use search plus country for market discovery.
• Use auto when an upstream workflow supplies mixed MercadoLibre URLs or item IDs.
• Use product for rich catalog enrichment.
• Use reviews and questions for customer-language research.
• Use seller for marketplace seller context.
• Keep country, siteId, itemId, and source in downstream records.

Run through the API

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~mercadolibre-all-in-one-scraper/runs" \
  -H "Authorization: Bearer YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "searchQuery": "wireless headphones",
    "country": "MX",
    "mode": "search",
    "maxResults": 25
  }'

The Apify token stays in the Authorization header. Dataset records can be downloaded through Apify in JSON, CSV, Excel, and other supported formats.

Data sourcing and recovery

The primary path uses Playwright with country-aware residential sessions, browser fingerprints, and marketplace warmup navigation. It extracts structured listing, product, review, question, and seller data from public MercadoLibre pages.

For search and category work, a configured SerpApi public-index route can recover canonical marketplace listings after the browser session pool reaches its retry threshold. Provider-backed records pass through the same URL validation, result cap, dataset, and event flow. The source field distinguishes browser and indexed records.

Pricing

This Actor uses Pay per event pricing with platform usage passed through. A result event is charged when a validated product, listing, review, question, seller, or category record is written. Treat the live Pricing tab as the current source of truth for event prices and billing details.

Use maxResults and focused modes to align the dataset with the regional research brief.

Best results

• Select the marketplace country that matches the analysis.
• Use automatic mode for mixed URL collections and focused modes for deterministic workflows.
• Start with search records, then enrich selected product URLs or item IDs.
• Use country-aware residential routing for consistent marketplace context.
• Preserve provenance and marketplace identifiers when combining countries.

Related Actors

• Use Google Shopping Scraper for broader merchant discovery before comparing selected offers with MercadoLibre listings.
• Pair with eBay All-in-One Scraper when the research workflow compares marketplace listings, sellers, and conditions across platforms.

Builder's note

I designed this Actor around the way regional ecommerce research actually expands: begin with a country and keyword, preserve each marketplace identifier, then enrich only the products, sellers, reviews, or questions that matter. The shared dataset contract keeps those modes composable for analytics and AI agents.

Responsible use

This Actor collects publicly available marketplace information. Use the results for legitimate ecommerce research and automation in line with applicable laws, marketplace terms, privacy requirements, and your organization's data-governance policies.