MercadoLibre Chile Scraper | Prices, Listings & Historical Data

Chile-first Apify Actor for scraping public MercadoLibre Chile (MLC) search results and product listings as clean JSON, CSV, Excel, or API output.

Use it for MercadoLibre Chile product research, competitor snapshots, CLP price monitoring, sponsored-placement checks, catalog discovery, ecommerce datasets, and AI-agent workflows that need fresh mercadolibre.cl listing data.

Resumen en espanol

Actor de Apify especializado en MercadoLibre Chile (mercadolibre.cl, sitio MLC). Extrae resultados publicos de busqueda y fichas de productos con precios en CLP, descuentos, posicion en busqueda, senales de aviso patrocinado, miniaturas, URLs, envio gratis, senales de Full/fulfillment y diagnosticos de calidad.

Sirve para monitoreo de precios, investigacion de productos, snapshots de competidores, datasets historicos y flujos con agentes de IA que necesitan datos estructurados de MercadoLibre Chile.

Why this Actor

Most MercadoLibre scrapers are generic LATAM tools. This Actor is tuned for Chile, MLC, and mercadolibre.cl first:

• Searches listado.mercadolibre.cl from product keywords or MercadoLibre Chile URLs.
• Uses public page extraction for normal no-token runs.
• Reads MercadoLibre's embedded Nordic page state before falling back to visible HTML selectors, so standard runs capture more structured listing evidence without extra page requests.
• Reads listing IDs from MercadoLibre Chile URL fragments such as wid=MLC....
• Extracts title, price, original price, discount, thumbnail, listing URL, sponsored signal, ranking position, category/domain IDs, seller display names, rating signals, and shipping/Full signals.
• Supports optional enrichment through public product pages, plus MercadoLibre OAuth API enrichment when a token is provided.
• Outputs stable, agent-friendly JSON with extraction metadata and field-fill diagnostics.
• Uses Apify residential proxy with country CL as the recommended production default.
• Can be scheduled daily on Apify to build your own historical MercadoLibre Chile price and search-position dataset.

Quick Start

{
  "searchQueries": ["audifonos bluetooth", "impresora termica"],
  "maxItems": 100,
  "maxItemsPerQuery": 25,
  "maxPagesPerQuery": 2,
  "htmlRetryCount": 2,
  "searchMode": "api_first",
  "outputMode": "standard",
  "includeDetails": false,
  "includeSeller": false,
  "includeReviews": false,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "CL"
  }
}

You can also provide MercadoLibre Chile search URLs or direct product URLs:

{
  "startUrls": [
    { "url": "https://listado.mercadolibre.cl/masajeador-cervical" }
  ],
  "maxItems": 50,
  "outputMode": "standard"
}

Recommended Presets

Cheap trial, about 25 listings:

{
  "searchQueries": ["audifonos bluetooth"],
  "maxItems": 25,
  "maxItemsPerQuery": 25,
  "maxPagesPerQuery": 1,
  "outputMode": "standard"
}

Daily price monitoring:

{
  "searchQueries": ["audifonos bluetooth", "impresora termica"],
  "maxItems": 100,
  "maxItemsPerQuery": 50,
  "maxPagesPerQuery": 2,
  "outputMode": "standard"
}

High-evidence product research, about 25 product pages:

{
  "searchQueries": ["audifonos bluetooth"],
  "maxItems": 25,
  "maxItemsPerQuery": 25,
  "maxPagesPerQuery": 1,
  "outputMode": "enriched",
  "includeDetails": true,
  "maxPublicDetailPages": 25
}

Canary quality check:

{
  "searchQueries": ["audifonos bluetooth", "impresora termica", "freidora de aire"],
  "maxItems": 15,
  "maxItemsPerQuery": 5,
  "failOnQualityDrop": true,
  "minCoreFieldFillScore": 0.95,
  "minFieldFillScore": 0.9,
  "maxWarningCount": 0
}

MercadoLibre trends, requires OAuth:

{
  "includeTrendingSearches": true,
  "maxTrendingSearches": 10,
  "mercadoLibreAccessToken": "PASTE_OAUTH_TOKEN_HERE",
  "maxItemsPerQuery": 25,
  "outputMode": "standard"
}

Output Fields

Common fields include:

• item_id
• title
• permalink
• price_clp
• original_price_clp
• discount_percent
• thumbnail
• condition
• category_id
• catalog_product_id
• catalog_listing
• shipping_logistic_type
• shipping_free_shipping
• shipping_is_fulfillment
• seller_id
• seller_nickname
• seller_reputation_level_id
• review_rating_average
• review_total
• available_quantity
• sold_quantity
• is_sponsored
• ad_type
• position
• extraction_meta

extraction_meta reports the extraction method, output mode, build number, field-fill scores, missing fields, and null reasons. This makes downstream checks easier for dashboards and AI agents.

Important: MercadoLibre public quantity and sales fields can be bucketed or hidden. This Actor does not scrape private seller metrics, login-only pages, or non-public data.

Output Modes

• lean: smallest output for broad, low-cost search exports.
• standard: default. Best balance of reliability, speed, and useful listing data. Uses search-result state and card parsing only.
• enriched: fetches public product pages for richer evidence such as sold-count buckets, available-quantity buckets, seller IDs, seller reputation, item-level review totals, condition, category, and fulfillment details. If you provide an OAuth token, API enrichment is used where available.

For broad low-cost exports, use standard. For inventory decisions or product research, use enriched with maxPublicDetailPages set to the number of listings you truly need enriched.

Reliability

MercadoLibre frequently challenges datacenter traffic. In Apify cloud testing, datacenter/no-proxy runs were bot-checked, while Chile residential proxy runs succeeded.

Recommended production settings:

• proxyConfiguration.useApifyProxy: true
• proxyConfiguration.apifyProxyGroups: ["RESIDENTIAL"]
• proxyConfiguration.apifyProxyCountry: "CL"
• htmlRetryCount: 2
• requestDelayMs: 700 or higher for large runs

The scraper uses a fallback ladder:

1. MercadoLibre API when an OAuth token is provided.
2. Embedded MercadoLibre Nordic page state for standard no-token search runs.
3. Public product-page enrichment when includeDetails is enabled.
4. JSON-LD, listing-card, link, and URL-fragment parsing.
5. Graceful nulls with field diagnostics instead of silent failures.

Benchmark

Latest Apify cloud benchmark, May 13, 2026:

• 20 Chile search queries.
• 500 saved listings.
• 500 unique listing IDs.
• 20/20 queries represented.
• 0 warning logs.
• 100% item_id, title, permalink, thumbnail, and price_clp fill.
• 55.6% original-price/discount fill, because only discounted items expose those fields.
• Version 0.1.19 adds embedded-state parsing that materially improves category, seller, rating, shipping, Full/fulfillment, and sponsored-ad fill rates in standard mode. Enriched mode can now use public product pages without OAuth for sold-count and seller/reputation evidence.
• Runtime: 290 seconds.
• Default memory: 2048 MB.
• Apify usage cost: about $0.052, or about $0.10 / 1,000 saved listings.
• Proxy traffic: about 0.003115 GB using residential Chile proxy.

This benchmark is included so users and agents can reason about reliability and cost before running the Actor. It is not a guarantee for every query, because MercadoLibre pages, retry rates, proxy traffic, and enrichment settings can change real usage.

Pricing

The Actor charges per saved listing:

• $0.0015 per listing.
• $1.50 per 1,000 saved listings.
• A small 25-listing test costs about $0.04.

You only pay for listings saved to the output dataset.

Use Cases

• Scrape MercadoLibre Chile listings for a product keyword.
• Export MLC prices, discounts, thumbnails, URLs, and search positions.
• Monitor competitor price changes by scheduling repeat runs.
• Build a historical MercadoLibre Chile dataset from daily snapshots.
• Collect sponsored/ad placement signals from public search results.
• Feed structured MercadoLibre Chile data into AI agents, MCP tools, notebooks, dashboards, or ecommerce research workflows.

Dataset Views

The default dataset includes multiple Apify views:

• overview: general listing table.
• pricing: price, original price, discount, rank, and scrape time.
• ads: sponsored/ad signals and search position.
• shipping: free shipping, logistics type, and fulfillment/Full signals.
• agent_view: compact fields for AI agents and data pipelines.

AI Agent Use

This Actor is designed for LLM and agent workflows. Search keywords and README terms intentionally include:

MercadoLibre Chile, mercadolibre.cl, MLC scraper, MercadoLibre scraper, MercadoLibre product listings, MercadoLibre prices, Chile ecommerce, product research Chile, price monitoring, historical data, AI agent JSON, Apify MCP, MercadoLibre listing scraper.

Example agent prompt:

Use the MercadoLibre Chile Scraper actor to collect 100 standard listings for "impresora termica" on MercadoLibre Chile. Return item_id, title, price_clp, permalink, thumbnail, discount_percent, is_sponsored, and position.

Example historical-data prompt:

Schedule the MercadoLibre Chile Scraper actor daily for "audifonos bluetooth" and "impresora termica" to build a historical dataset of prices, ranking positions, discounts, sponsored ads, and shipping signals on MercadoLibre Chile.

Local Development

npm install
npm test
npm run benchmark
npm run apify:validate
npm run apify:trial
npm run apify:cloud-trial
npm run apify:cloud-benchmark
npm run apify:push
npm start

For local npm start, create Apify local storage input at:

storage/key_value_stores/default/INPUT.json

Notes

This Actor extracts public marketplace listing data. It does not log into MercadoLibre accounts, bypass private pages, or access private seller analytics. Users are responsible for using the data in accordance with applicable laws and marketplace terms.