MercadoLibre Multi-Country Marketplace Scraper

Search MercadoLibre by keyword or category, fetch item detail by ID, or list a country's category tree across 9 Latin American sites. Returns price, seller, shipping and category data per item.

Open in Apify Store$0.99 / 1K on Free

Short answer

MercadoLibre Multi-Country Marketplace Scraper is an Apify Store Actor for MercadoLibre data that returns 10 published output fields, including itemId, title, price, condition. It lists $0.99 per 1,000 results on the Free plan (pay per event), $0.49 on the Business plan. It takes 26 input settings; 2 are required (mode, siteId). It covers 6 of the 6 core MercadoLibre fields this site tracks. Last updated Oct 29, 2026.

From the public Store listing and published build schema, synced 2026-11-12.
MercadoLibre EcommerceAutomationLead generation

What it returns

10 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

  • recordType
  • itemId
  • title
  • price
  • currency
  • condition
  • sellerName
  • freeShipping
  • rank
  • itemUrl

How it differs from the other MercadoLibre Actors

Among the 2 catalogue Actors for MercadoLibre with a published schema, only this one returns freeShipping.

Pick another Actor if you need

ActorFields it addsPrice / 1K
MercadoLibre Mexico Marketplace Price Scraper shippingLabel, rating, reviewsCount $0.99

Input

SettingTypeRequiredDefaultWhat it does
mode string Yes search Choose the kind of MercadoLibre data you need.
siteId string Yes MLA MercadoLibre country marketplace to query.
searchQuery string No laptop Keyword to search for (mode=search). Example: laptop.
searchUrls array No [] Paste MercadoLibre search, category or seller listing URLs (mode=search/seller). One per line.
categoryId string No – Category to browse or use as a filter (mode=search/categories/bestSellers/deals). Example: MLM1652.
categoryQuery string No – Find matching categories from a keyword (mode=categories). Example: laptop.
sellerId string No – Seller to catalog (mode=seller/search). Numeric ID, _CustId_ URL or seller_id URL.
productUrls array No [] Product, catalog or item URLs or IDs (mode=product/reviews/questions). One per line.
sort string No relevance How to order search and seller results.
condition string No any Filter products by condition (mode=search/seller).
Show the other 16 settings
SettingTypeRequiredDefaultWhat it does
priceMin number No 0 Lowest price in the country currency (mode=search/seller). 0 means no minimum.
priceMax number No 0 Highest price in the country currency (mode=search/seller). 0 means no maximum.
freeShippingOnly boolean No false Keep products with free shipping (mode=search/seller).
fullShippingOnly boolean No false Keep products fulfilled by MercadoLibre FULL (mode=search/seller).
officialStoresOnly boolean No false Keep products sold by official stores (mode=search/seller).
minDiscount integer No 0 Keep products discounted by at least this percentage (mode=search/seller/deals). 0 disables it.
includeSponsored boolean No true Include paid placements in search and seller results.
includeDetails boolean No false Fetch the full detail page for every search or seller result (mode=search/seller). Slower, more fields.
includeReviews boolean No false Attach review summary and review rows to product records (mode=product).
includeQuestions boolean No false Attach buyer questions and answers to product records (mode=product).
includeSellerProfile boolean No false Emit a seller profile row before the catalog (mode=seller).
includeAttributes boolean No false Attach the attribute schema to a category record (mode=categories with categoryId).
maxItems integer No 50 Maximum records to return. Product queries stop at the source's 2,000-row window.
maxReviews integer No 30 Maximum review rows per product (mode=reviews). Values above 330 sweep every rating bucket.
reviewRating string No all Only collect reviews with this star rating (mode=reviews).
maxQuestions integer No 20 Maximum buyer questions per product (mode=questions/product).

Example input

Built from the input form's published example values and defaults.

{
  "mode": "search",
  "siteId": "MLA",
  "searchQuery": "laptop",
  "searchUrls": [],
  "productUrls": [],
  "sort": "relevance",
  "condition": "any",
  "priceMin": 0,
  "priceMax": 0,
  "freeShippingOnly": false,
  "fullShippingOnly": false,
  "officialStoresOnly": false,
  "minDiscount": 0,
  "includeSponsored": true,
  "includeDetails": false,
  "includeReviews": false,
  "includeQuestions": false,
  "includeSellerProfile": false,
  "includeAttributes": false,
  "maxItems": 1,
  "maxReviews": 30,
  "reviewRating": "all",
  "maxQuestions": 20
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "search",
    "siteId": "MLA",
    "searchQuery": "laptop",
    "searchUrls": [],
    "productUrls": [],
    "sort": "relevance",
    "condition": "any",
    "priceMin": 0,
    "priceMax": 0,
    "freeShippingOnly": False,
    "fullShippingOnly": False,
    "officialStoresOnly": False,
    "minDiscount": 0,
    "includeSponsored": True,
    "includeDetails": False,
    "includeReviews": False,
    "includeQuestions": False,
    "includeSellerProfile": False,
    "includeAttributes": False,
    "maxItems": 1,
    "maxReviews": 30,
    "reviewRating": "all",
    "maxQuestions": 20
}

run = client.actor("vexaloom-labs/mercadolibre-multi-country-marketplace-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

pip install apify-client

JavaScript

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "search",
    "siteId": "MLA",
    "searchQuery": "laptop",
    "searchUrls": [],
    "productUrls": [],
    "sort": "relevance",
    "condition": "any",
    "priceMin": 0,
    "priceMax": 0,
    "freeShippingOnly": false,
    "fullShippingOnly": false,
    "officialStoresOnly": false,
    "minDiscount": 0,
    "includeSponsored": true,
    "includeDetails": false,
    "includeReviews": false,
    "includeQuestions": false,
    "includeSellerProfile": false,
    "includeAttributes": false,
    "maxItems": 1,
    "maxReviews": 30,
    "reviewRating": "all",
    "maxQuestions": 20
};

const run = await client.actor("vexaloom-labs/mercadolibre-multi-country-marketplace-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

npm install apify-client

cURL

curl -X POST "https://api.apify.com/v2/actors/vexaloom-labs~mercadolibre-multi-country-marketplace-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"search","siteId":"MLA","searchQuery":"laptop","searchUrls":[],"productUrls":[],"sort":"relevance","condition":"any","priceMin":0,"priceMax":0,"freeShippingOnly":false,"fullShippingOnly":false,"officialStoresOnly":false,"minDiscount":0,"includeSponsored":true,"includeDetails":false,"includeReviews":false,"includeQuestions":false,"includeSellerProfile":false,"includeAttributes":false,"maxItems":1,"maxReviews":30,"reviewRating":"all","maxQuestions":20}'

Waits for the run and returns the dataset items (runs over 300 seconds return HTTP 408; start an async run instead).

MCP (AI agents)

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=vexaloom-labs/mercadolibre-multi-country-marketplace-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Adds this Actor as a tool in an MCP client that takes a remote server URL (Cursor, VS Code, Claude Code) through Apify's hosted MCP server. OAuth sign-in also works without the header. Clients that only start local servers can wrap the URL with npx mcp-remote.

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

Apify planPer 1,00010,000 results100,000 results
Free plan$0.99$9.90$99
Starter plan$0.82$8.20$82
Scale plan$0.66$6.60$66
Business plan$0.49$4.90$49
  • Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
  • The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
  • Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
  • Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among MercadoLibre routes

It ranks 2 of 2 catalogue Actors for MercadoLibre on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

Route diagram for MercadoLibre dataMercadoLibre Mexico Marketplace Price Scraper: stops at 6 of the 10 fields shown; MercadoLibre Multi-Country Marketplace Scraper: stops at 7 of the 10 fields shown; Other Store tools (10): stops at 10 of the 10 fields shown; Mercado Libre Developers API: public, field coverage not compared.MercadoLibreitem idtitlepricesellerconditionurlfree shippingoriginal pricescrapedAtinstallments12+API

Stops are fields. A ring means the field is in that route's published output schema; no ring means the line passes without it. Bold labels are the core fields for this website, the rest are fields that differ between routes. A white capsule means every data line stops there. The red line is the official API; its field coverage is not compared. A crossed red line means there is no open official API.

Official route: Mercado Libre Developers API

Public API. Mercado Libre publishes APIs for search, items, users and categories, with authentication and site-specific behavior.

No general per-call fee is published; see developer terms.

Official documentation

Other Store tools for MercadoLibre

Reference only, from their public listings.

ToolFieldsPrice / 1K
MercadoLibre Scraper 202643$1.00
MercadoLibre Scraper30$2.00
MercadoLibre Scraper: Search, Products, Reviews, Q&A, Sellers111$5.00
MercadoLibre Scraper12$4.00
Mercado Livre Scraper (Mercado Libre Brazil)18$1.50

What people use it for

  • Monitor product prices
  • Collect seller catalogs
  • Analyze buyer feedback

Other catalogue Actors for MercadoLibre

MercadoLibre Mexico Marketplace Price Scraper

Search MercadoLibre Mexico by keyword or category URL and get price, discount, condition, seller, brand and rating for each matching product,…

6/6 core fields 10 output fields $0.99 per 1K

Ozon.ru Product Pricing, Ratings & Seller Scraper

Search, browse categories, or fetch full product details from Ozon.ru with pricing, discount, rating breakdown, seller profile, spec, and variant…

38 output fields $0.99 per 1K

Allegro.pl Listings by Search, Category or URL

Find Allegro.pl products by keyword search, category page, or direct offer URL, with price, seller rating, condition, shipping, and rating…

10 output fields $0.99 per 1K

Amazon Search, Category & Seller Listings Extractor

Get Amazon products from search results, categories, seller storefronts, or ASIN lookups across 20+ marketplaces, with price, rating, badges,…

8 output fields $0.99 per 1K

eBay Multi-Marketplace Listing & Seller Data Scraper

Search eBay listings by keyword or category across 8 marketplaces, with titles, prices, conditions, sellers, ratings, watch counts, sold counts…

42 output fields $0.99 per 1K

Flipkart Product Price & Specs Scraper

Pull Flipkart products by keyword, category URL or exact product link, with current price, original MRP, discount percentage, rating, key…

10 output fields $0.99 per 1K

Hepsiburada Product Search & Category Price Scraper

Search Hepsiburada by keyword, browse a category page, look up specific product URLs, or find a keyword's top sellers, and get price, rating,…

$0.99 per 1K

Questions people ask

How much does MercadoLibre Multi-Country Marketplace Scraper cost?

The published result rate depends on your Apify plan: $0.99 per 1,000 on Free, $0.82 per 1,000 on Starter, $0.66 per 1,000 on Scale, $0.49 per 1,000 on Business. So 10,000 results cost about $9.90 on the Free plan and $4.90 on Business, plus a start fee of $0.10 per run per GB of memory on Free. Platform usage is billed separately.

What data does MercadoLibre Multi-Country Marketplace Scraper return?

Its published output schema lists 10 fields: recordType, itemId, title, price, currency, condition, sellerName, freeShipping, rank, itemUrl. A listed field is not guaranteed to be filled in every row.

What input does MercadoLibre Multi-Country Marketplace Scraper need?

Required: mode, siteId. Optional settings include searchQuery, searchUrls, categoryId, categoryQuery, sellerId, productUrls.

What are the alternatives to MercadoLibre Multi-Country Marketplace Scraper for MercadoLibre?

2 catalogue Actors cover MercadoLibre. Close alternatives: MercadoLibre Mexico Marketplace Price Scraper. The MercadoLibre page compares all of them field by field.

How do I run MercadoLibre Multi-Country Marketplace Scraper from Python or the API?

Use the Apify API client: in Python, ApifyClient(token).actor("vexaloom-labs/mercadolibre-multi-country-marketplace-scraper").call(run_input=...), then read the run's default dataset (run.default_dataset_id); in JavaScript the same call is client.actor("vexaloom-labs/mercadolibre-multi-country-marketplace-scraper").call(input). Without a client, POST the input JSON to https://api.apify.com/v2/actors/vexaloom-labs~mercadolibre-multi-country-marketplace-scraper/run-sync-get-dataset-items with your API token. Ready-to-paste code with the example input is on this page.

Sources

Actor updated 2026-10-29 Data synced 2026-11-12
Cite this page

Scraper Finder. "MercadoLibre Multi-Country Marketplace Scraper." https://scraperfinder.com/catalogue/mercadolibre-multi-country-marketplace-scraper/ (data checked 2026-11-12).

Run MercadoLibre Multi-Country Marketplace Scraper

$0.99 per 1,000 results. Paste the example input above, set your MercadoLibre query, then export the dataset. Still choosing? Compare every MercadoLibre route.

Open in Apify Store