Contact

If you encounter any issues or need to exchange information, please feel free to contact us through the following link: My profile

Mercadolibre.com Scraper: Extract Product Data & Pricing Intelligence

Introduction

MercadoLibre stands as the leading e-commerce platform in Latin America, operating across 18 countries including major markets like Argentina, Brazil, Mexico, and Chile. With 60.8 million unique marketplace buyers as of Q3 2024 and experiencing 21% year-over-year growth, the platform represents one of the most dynamic and valuable data sources for understanding Latin American consumer behavior and market trends.

The complexity of monitoring thousands of products across multiple countries and categories manually creates significant challenges for businesses seeking market intelligence. Whether you're conducting competitor analysis, tracking pricing trends, or identifying new market opportunities, manually collecting product data from MercadoLibre's vast marketplace is time-consuming and prone to errors.

Our MercadoLibre Product Search Scraper addresses this critical need by automating the extraction of comprehensive product information, enabling businesses to make data-driven decisions based on real-time market intelligence from Latin America's most influential e-commerce platform.

Scraper Overview

The MercadoLibre Product Search Scraper is a sophisticated automation tool designed specifically for extracting detailed product information from search result pages across MercadoLibre's multi-country marketplace network. Built to handle the platform's complex structure and regional variations, this scraper provides reliable access to the rich product data that drives Latin American e-commerce.

Key Features:

• Multi-Country Support: Seamlessly processes data from all MercadoLibre domains (.com.ar, .com.mx, .cl, etc.)
• Flexible Item Limits: Configurable extraction limits per URL to optimize resource usage
• Advanced Proxy Integration: Residential proxy support with country-specific targeting for reliable access
• Retry Mechanisms: Intelligent error handling with configurable retry attempts
• Comprehensive Data Extraction: Captures essential product metrics, pricing, and metadata
• Search Result Processing: Efficiently handles product listing pages with multiple items

Target Users:

• E-commerce businesses expanding into Latin American markets
• Market researchers and business analysts
• Pricing optimization specialists and competitive intelligence teams
• Dropshipping and arbitrage entrepreneurs
• Digital marketing agencies serving LATAM clients
• Supply chain and procurement professionals

The scraper is particularly valuable for businesses looking to understand regional pricing strategies, identify trending products, or monitor competitor activities across MercadoLibre's diverse marketplace ecosystem.

Input and Output Details

Example url 1: https://listado.mercadolibre.com.ar/computacion/pc-escritorio/pc/pc-gamer_NoIndex_True

Example url 2: https://listado.mercadolibre.com.ni/iphone

Example url 3: https://listado.mercadolibre.cl/_Container_landing-electrodomesticos25-linea-blanca

Example Screenshot of product information page:

Input Format

The scraper accepts configuration through a JSON object with several key parameters:

Scrape with URLs:

{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each URL if scraping fails
  "proxy": { // Proxy configuration to avoid bot detection
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "US" // Choose a country that matches your target data location
  },
  "max_items_per_url": 20, // Limit the number of items to scrape per URL
  "urls": [ 
    "https://listado.mercadolibre.com.ar/computacion/pc-escritorio/pc/pc-gamer_NoIndex_True"
    // Add URLs of product list pages you want to scrape
  ],
  "ignore_url_failures": true // Continue scraping even if some URLs fail
}

The urls parameter: Add the URLs of the product list pages you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

The ignore_url_failures parameter: If set to true, the scraper will continue running even if some URLs fail to be scraped after the maximum number of retries is reached. This ensures that one problematic URL doesn't stop your entire scraping job.

When you provide a list of URLs for scraping, all options in the "Scrape with search filters" section will be disabled. The system will only collect data from the URLs you specified.

Scrape with Search Filters:

{
  "max_retries_per_url": 2, // Maximum number of retry attempts for each search request
  "proxy": { // Proxy configuration to avoid bot detection
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL" 
    ],
    "apifyProxyCountry": "US" // Choose a country that matches your target data location
  },
  "max_items_per_url": 20, // Total number of items you want to scrape
  "keyword": "laptop", // Search keyword to find products
  "country_code": "ar", // Country code to search for items
  "sort_by": "PRICE", // Sort products by specific criteria
  "page": 1 // Starting page number for search results
}

The keyword parameter: Enter the keyword to search for items (e.g., "laptop", "smartphone", "pc gamer", "iphone", "electrodomesticos").

The country_code parameter: Enter the country code to search for items:

• "ar" - Argentina
• "bo" - Bolivia
• "br" - Brasil
• "cl" - Chile
• "co" - Colombia
• "cr" - Costa Rica
• "do" - Dominicana
• "ec" - Ecuador
• "gt" - Guatemala
• "hn" - Honduras
• "mx" - México
• "ni" - Nicaragua
• "pa" - Panamá
• "py" - Paraguay
• "pe" - Perú
• "sv" - El Salvador
• "uy" - Uruguay
• "ve" - Venezuela

The sort_by parameter: Sort items by various criteria:

• "" - Relevance (most relevant results)
• "PRICE" - Price (low to high)
• "PRICE*DESC" - Price (high to low)

The page parameter: Specify the page number to start scraping from, useful for continuing interrupted scrapes or targeting specific result ranges.

When using search filters for scraping, you need to leave the urls field empty in the "Scrape with URLs" configuration.

General Options:

The max_items_per_url parameter: Limit the number of items per URL or search filters you want to scrape. The default value is 20, providing a manageable batch size while allowing for comprehensive data collection.

The max_retries_per_url parameter: Limit the number of retries for each URL or search filters if the scrape is detected as a bot or the page fails to load. The default value is 2, providing a good balance between thoroughness and efficiency.

The proxy parameter: Proxy configuration is essential for maintaining anonymity and avoiding detection. The residential proxy option ensures that your scraping activities appear as legitimate browsing, reducing the risk of being blocked or rate-limited. You should choose a country that matches the location of the website you're scraping (e.g., Argentina/AR for mercadolibre.com.ar, Mexico/MX for mercadolibre.com.mx).

Output Format

You get the output from the Mercadolibre.com Product Search Scraper stored in a tab. The following is an example of the Information Fields collected after running the Actor.

[ // List of product information
  {
  "id": "MLA932296520",
  "user_product_id": "MLAU311894489",
  "url": "click1.mercadolibre.com.ar/mclics/clicks/external/MLA/count",
  "url_fragments": "#polycard_client=search-nordic&is_advertising=true&search_layout=grid&position=1&type=pad&tracking_id=6eff968e-5e58-42ba-b357-fc448dfe4185&wid=MLA932296520&sid=search",
  "url_params": "?a=hf2FOiuqGBJiPjzb9UrIpGonDO4tMM%2FQ1CAhnWFI19lAEVtGQOZmTv7xU86VDc3W3HyApUQK6GEbWgphza56DZMrxgGAqZeDeRV2A%2FZY2m6ZTkIUnjMyGqMdpthOfV3u2sknF3m6Dv6SLnvPjGTAVvQPKKkTayPE9%2FwPDEJ73HOQV8OR3QFTLJdOrFtRb%2B8i9Ri8KMBpSbz1fHBVeIKSn%2FaEhOnqfZop4F0%2FsRGMZeZckF2vNHZB1XMkVUCF72t4FDJoC42W72TMKm%2Bv6buh5WHPi52kGKTlyfrdCdFOgAJPDVyKEccUUPDsUuk%2B9HVJ%2Ba28nbDXQoBryNKLCZK%2B1JQ3YJSr%2F65eYU8W3Uh23mwGTyIGKvCKeAsVpnjcvGuNoZTDNT74kjoxetL%2Bd13j%2FHKMU9lrewbXYHwr5BD3aGduEqrd1X0ma23bWmxNORsgjBUjEXdtmV5mHciCiwwx2dDQKSwRI9Aq3H4AL6omb2akjFDrgxOpL5vudeP2L60VVWGJG32arEnVDsllc0zRPXRMES0oPMp7J7rUnU8BsfAU5dOQQcq7PZnebX9PqhiFqhLNs8PH958ElflFIDHzLZW8LD%2FHrMoleAabTqwmh3c7DU%2Fy%2Bm9y0M%2FwlFPi93fMsvdh0l2Cf%2FCAjVjG2Cs1ZmmNCAIVH4JytH7yUZoXkr5ATvXw24lz12IlC80T2JOWrs%2FBHlEBij6gLMH6b%2BKTX98H0KAjp7g8NdQfCLn0HZ5ZcNufsnxJ1bOQRGGZqspWIH5bDup5bP%2F2AjgYjcEsC2%2BRDKB0",
  "tracks": {},
  "is_pad": "true",
  "domain_id": "MLA-DESKTOP_COMPUTER_KITS",
  "bulk_sale": "false",
  "item_position": "7",
  "category_id": "MLA1649",
  "vertical_id": "CORE",
  "price_per_quantity": "false",
  "pxu_b2b": "false",
  "picture": null,
  "components": [
    {
      "type": "title",
      "id": "title",
      "title": {
        "text": "Pc Armada Gamer Amd Ryzen 7 De 8/16 Nucleos 16gb Ram Ssd 480",
        "long_title": false,
        "title_tag": "h3"
      }
    },
    {
      "type": "reviews",
      "id": "reviews",
      "reviews": {
        "rating_average": 4.7,
        "total": 518,
        "alt_text": "Calificación 4,7 de 5 (518 calificaciones)"
      }
    },
    {
      "type": "price",
      "id": "price",
      "price": {
        "current_price": {
          "value": 557999,
          "currency": "ARS",
          "decimal_style": "superscript"
        },
        "previous_price": {
          "value": 899999,
          "currency": "ARS",
          "decimal_style": "normal"
        },
        "discount": {
          "value": 38
        },
        "installments": {
          "text": "Cuota promocionada en 6 cuotas de {price}",
          "no_interest": true,
          "values": [
            {
              "key": "price",
              "type": "price",
              "price": {
                "value": 115133,
                "currency": "ARS"
              }
            }
          ]
        }
      }
    },
    {
      "type": "shipping",
      "id": "shipping",
      "shipping": {
        "text": "Llega gratis hoy",
        "promise_type": "same_day"
      }
    }
  ],
  "shipping": null,
  "from_url": "https://listado.mercadolibre.com.ar/pc-gamer"
}, // ... Many other product details
]

Output Fields Explained:

• ID: Unique MercadoLibre item identifier for tracking and reference
• User Product ID: Seller's internal product reference code
• URL: Direct link to the product page for manual verification
• URL Fragments: Parsed URL components useful for categorization and analysis
• URL Params: Search context parameters that affect product visibility
• Tracks: Category and classification tags for market segmentation
• Is iPad: Boolean indicating mobile-optimized display format
• Domain ID: Country-specific MercadoLibre domain identifier (MLA=Argentina, MLB=Brazil, etc.)
• Bulk Sale: Indicates whether the item is available for wholesale purchasing
• Item Position: Product ranking position in search results
• Category ID: MercadoLibre's internal category classification system
• Vertical ID: Business vertical classification for market analysis
• Price Per Quantity: Unit pricing information for cost analysis
• PXU B2B: Business-to-business listing indicator
• Picture: Primary product image URL for visual recognition
• Components: Product feature tags for detailed specification analysis

Each field serves specific business intelligence purposes: ID and URL enable tracking, Category and Vertical data support market segmentation, Price information drives competitive analysis, and Position data reveals search performance metrics.

Usage Guide

Step-by-Step Implementation

Option 1: Scraping with URLs

1. Define Search Targets: Identify specific product categories, brands, or search terms relevant to your market research objectives. Use MercadoLibre's native search to find appropriate URLs from different country domains (e.g., mercadolibre.com.ar, mercadolibre.com.mx).

2. Collect Target URLs: Navigate to MercadoLibre's search results or category pages and copy the URLs. You can collect URLs from multiple countries to compare markets.

3. Configure Geographic Settings: Set proxy country to match your target MercadoLibre domain (Argentina, Brazil, Mexico, etc.) for optimal data quality and access reliability.

4. Set Extraction Limits: Start with 20 items per URL to balance data volume with processing efficiency. Adjust based on your specific needs and available resources.

5. Implement Retry Logic: Configure 2-3 retries to handle temporary network issues or rate limiting without overwhelming MercadoLibre's servers. Enable ignore_url_failures to continue scraping even if some URLs fail.

6. Execute and Monitor: Run the scraper during off-peak hours when possible to minimize load and improve success rates.

Option 2: Scraping with Search Filters

1. Define Search Keywords: Identify the products you want to research by defining specific keywords (e.g., "laptop", "smartphone", "electrodomesticos").

2. Select Target Country: Choose the appropriate country_code from the 18 available MercadoLibre markets (Argentina, Brazil, Chile, Colombia, Mexico, Peru, etc.) based on your market research objectives.

3. Configure Search Filters:

   • Set your keyword to match the products you're researching
   • Choose country_code to target specific markets
   • Configure sort_by to organize results by relevance or price
   • Set page to start from a specific result page if needed

4. Set Geographic Settings: Configure proxy settings to match your target country for better access and data quality.

5. Set Extraction Limits: Start with 20 items per search to test your configuration, then scale up based on your data requirements.

6. Implement Retry Logic: Configure 2-3 retries to handle temporary issues. Leave urls field empty when using search filters.

7. Execute and Monitor: Run the scraper and monitor progress. The scraper will automatically construct search URLs based on your filters.

Best Practices

General Optimization:

• Respect Rate Limits: Space requests appropriately to maintain good standing with MercadoLibre's infrastructure
• Monitor Data Quality: Regularly validate extracted data against manual samples to ensure accuracy
• Handle Regional Variations: Different countries may have slight variations in page structure or available data fields
• Manage Large Datasets: For extensive market research, consider processing data in batches to maintain system performance
• Start Small: Test with limited items first, then scale up once you verify the configuration works correctly

URL Strategy:

• Use URLs when you need to scrape specific, predefined searches or categories
• Collect URLs from multiple country domains to perform cross-market comparisons
• Verify URLs are accessible before adding them to your configuration
• Use pagination in URLs to target specific result ranges

Filter Strategy:

• For single-market research: Use keyword + country_code to focus on one specific market
• For price comparison: Use the same keyword across different country_codes to compare pricing across markets
• For competitive analysis: Search for specific brand names or product models with appropriate sorting
• For market sizing: Use broad keywords with relevance sorting to understand overall market composition
• For price analysis: Use PRICE or PRICE*DESC sorting to identify pricing patterns and outliers

Country Selection Tips:

• Match proxy country with the target country_code for best results
• Consider time zones when scheduling scrapes for different countries
• Be aware that product availability and pricing vary significantly across markets
• Some products may be region-specific and not available in all countries

Common Issues and Solutions

General Issues:

• Proxy Timeouts: Switch to different geographic regions or proxy providers if experiencing consistent failures
• Missing Data Fields: Some products may lack certain information; implement null value handling in your analysis pipeline
• Category Variations: Product categorization may differ between countries; normalize category data for cross-market analysis
• Currency Differences: Prices are returned in local currencies; implement conversion for comparative analysis

URL-Specific Issues:

• Invalid URLs: Verify URLs are from MercadoLibre domains and properly formatted before scraping
• Duplicate Results: Different URLs may return overlapping products; deduplicate using product IDs
• URL Changes: MercadoLibre may update URL structures; monitor and update your URL collection regularly

Filter-Specific Issues:

• No Results: Verify keyword spelling and try broader search terms; some products may not be available in certain countries
• Limited Results: Some country markets have fewer products; adjust expectations based on market size
• Language Barriers: Use local language keywords for better results (Spanish for most markets, Portuguese for Brazil)
• Country Mismatch: Ensure proxy country matches country_code for consistent results
• Sort Order Inconsistencies: Different countries may interpret sorting differently; validate results match expected order

Cross-Market Comparison Tips:

• When comparing across countries, use consistent keywords (translate appropriately)
• Account for currency exchange rates in price comparisons
• Consider local market conditions (taxes, import duties) when analyzing price differences
• Use relevance sorting initially to understand what products dominate each market

Benefits and Applications

Time and Efficiency Savings

Manual product research across MercadoLibre's vast inventory can require days or weeks for comprehensive market analysis. This scraper reduces that timeframe to hours, enabling rapid competitive intelligence and market opportunity identification.

Real-World Applications

Competitive Pricing Analysis: Track competitor pricing strategies across different markets and product categories to optimize your own pricing structure.

Market Entry Research: Identify product demand, pricing ranges, and competitive landscape before entering new Latin American markets.

Trend Identification: Monitor emerging product categories and popular items to guide inventory and marketing decisions.

Supply Chain Optimization: Analyze regional price variations to optimize sourcing and distribution strategies across multiple countries.

Business Value

For international retailers, market research firms, and e-commerce entrepreneurs, automated MercadoLibre data collection enables strategic decision-making based on comprehensive market intelligence rather than limited manual sampling.

Conclusion

The MercadoLibre Product Search Scraper transforms complex, time-intensive market research into an efficient, automated process. By leveraging MercadoLibre's platform that connects millions of buyers and sellers with comprehensive product feedback systems, this tool provides the foundation for data-driven expansion into Latin America's rapidly growing e-commerce markets.

Whether you're analyzing competitive landscapes, identifying market opportunities, or optimizing pricing strategies, this scraper delivers the comprehensive product intelligence needed for successful Latin American market engagement.

Related Actors

• Mercadolibre.com Product Details Scraper: A specialized data extraction solution engineered to harvest comprehensive product information from Mercadolibre.com's.

Your feedback

We are always working to improve Actors' performance. So, if you have any technical feedback about Mercadolibre.com Product Search Scraper or simply found a bug, please create an issue on the Actor's Issues tab in Apify Console.