Mercado Libre Market Intelligence — LATAM Niche & Demand Analyzer

Disclaimer: Unofficial integration, not affiliated with Mercado Libre or MercadoLibre, Inc. Mercado Libre and related trademarks belong to their respective owners. Data is read from publicly accessible search results and product pages. Search pages may require optional session cookies when Mercado Libre shows a login wall.

This Actor is provided for informational, research, and market analysis purposes only. You are solely responsible for complying with applicable laws, Mercado Libre's terms of use, and your organization's policies.

Analyze Mercado Libre search and category listings across 18 Latin American country sites. Enter a keyword or category URL and receive title-filtered demand signals from public sold buckets, price percentiles, top sellers and brands, competition concentration, and a 0–100 opportunity score with a plain-language verdict.

This is SERP analytics, not a TAM model. Mercado Libre mixes unrelated products into narrow queries; the Actor drops cards whose titles do not match the query and omits GMV when the remaining sample is too thin. Sold counters like +1000 vendidos are bucket floors, not exact period sales. For a two-word niche, scrape listings and filter yourself.

For detailed niche inputs, output metrics, API examples, MCP prompts, pricing notes, and limitations, see the Mercado Libre Market Intelligence API documentation by Crawloop.

Each query produces a ready-to-use market report: market_summary in the dataset, REPORT.md, OUTPUT.json, and listings.csv with every analyzed listing.

Best for: LATAM niche validation, product research, market entry analysis, competitor benchmarking, assortment planning, pricing strategy, and category opportunity screening.

Crawloop Mercado Libre LATAM Suite — raw listing export and market intelligence across the same 18 country sites.

Mercado Libre Scraper	Mercado Libre Market Intelligence ◄── you are here
Raw listings, fast search, optional PDP	Title-filtered niche score, sold-bucket demand, market reports

---

When to use this Actor

• Niche validation — Check demand vs. competition before sourcing: sold buckets, seller concentration, opportunity score in one run — after off-query cards are dropped.
• Category analysis — Paste a Mercado Libre category URL (e.g. smartphones, air fryers) and analyze up to 500 top listings with one report.
• Competitor benchmarking — Top sellers by estimated revenue, official store share, FULL delivery and free shipping penetration.
• Pricing strategy — Price percentiles (p10–p90) with outlier cleaning, breakdown by condition, discount depth.
• Brand share analysis — Which brands dominate a niche by listings, units sold, and estimated revenue.
• Batch niche screening — Multiple keywords or categories in one run, ranked by opportunity score.

When not to use this Actor

• Narrow-SKU TAM / market volume — Mercado Libre mixes unrelated products into small queries. This Actor title-filters and omits GMV when the sample is thin; it is not a TAM calculator. For honest niche volume, run Mercado Libre Listings Scraper, filter the rows, and calculate yourself.
• Bulk raw export only — If you need thousands of listing rows without analytics, use Mercado Libre Scraper — LATAM Prices, Listings & Specs (faster search-only mode).
• Exact accounting-grade revenue — Sold counters are lifetime values; +1000 vendidos is a bucket floor, not a sale count.
• Real-time price alerts — Analytical snapshots, not continuous monitors.

---

Mercado Libre Scraper vs. Market Intelligence

	Listings Scraper	Market Intelligence (this Actor)
Primary output	Raw listing rows (JSON/CSV)	Market report + analytics + listing rows
Search & category	Yes	Yes
PDP enrichment	Optional (includeProductDetail)	On by default (required for demand/GMV)
Opportunity score	No	Yes (0–100)
Demand & GMV estimates	No	Title-matched only; GMV omitted if the sample is thin
Top sellers / brands tables	No	Yes
Markdown report	No	Yes (REPORT.md)
Best for	Catalogs, price feeds, bulk export	Broad category screens, go/no-go — not narrow-SKU TAM

---

Key Features

• Title filter on every card — Drops SERP mix-ins whose titles do not contain the query (Unicode-aware: paño matches pano).
• 0–100 opportunity score — Demand, competition, official stores, shipping, and discount pressure combined into one verdict.
• Demand from sold buckets — Aggregated lifetime counters (+N vendidos is a floor). GMV is omitted when too few title-matched listings remain.
• Competition analysis — Unique sellers, top-5 revenue share, official store share, FULL and free shipping rates.
• Price analytics — Median, mean, std dev, p10/p25/p75/p90 with outlier trimming; breakdown by new/used/refurbished.
• Top sellers, brands, products — Ranked by estimated revenue with units sold.
• Promotion radar — Discount share, average/max discount, interest-free installment coverage.
• 18 LATAM sites — MLA, MLB, MLM, MCO, MLC, MPE, and 12 more with country-targeted residential proxy.
• Keyword or category input — searchQueries or categoryUrls (one market report per target).
• Three export formats — Dataset summaries, key-value store JSON/Markdown/CSV.

---

How it works

1. Keyword search hits Mercado Libre's public search API first (title-filtered). HTML listado is the fallback; Ofertas is last-resort only.
2. Drops cards whose titles do not match the query so unrelated expensive SKUs cannot enter the sample.
3. Enriches remaining listings via product detail page in parallel (sold quantity, brand, specs, stock) — enabled by default.
4. Computes price, demand, and competition on the matched set. Omits GMV when the sample is too thin. +N vendidos is labeled as a bucket floor.
5. Scores the niche 0–100 and writes REPORT.md. A wall plus a handful of cards fails the run. Coverage is in the dataset and COVERAGE.
6. Pushes one market_summary per query/category, listing rows, and OUTPUT.json / listings.csv.

---

Supported country sites

Site ID	Country	Currency
MLA	Argentina	ARS
MLB	Brazil	BRL
MLM	Mexico	MXN
MCO	Colombia	COP
MLC	Chile	CLP
MPE	Peru	PEN
MLU	Uruguay	UYU
MLV	Venezuela	VES
MEC	Ecuador	USD
MBO	Bolivia	BOB
MPA	Panama	USD
MPY	Paraguay	PYG
MRD	Dominican Republic	DOP
MCR	Costa Rica	CRC
MNI	Nicaragua	NIO
MGT	Guatemala	GTQ
MHN	Honduras	HNL
MSV	El Salvador	USD

---

Input Parameters

Parameter	Type	Default	Description
searchQueries	Array	—	Keywords/niches to analyze (one report per query).
categoryUrls	Array	—	Mercado Libre category or filtered listing URLs (one report per URL).
siteId	String	MLA	Country site code (see table above).
maxItemsPerQuery	Integer	50	Listings analyzed per query or category (5–500).
includeProductDetail	Boolean	true	Visit product pages for sold counters, brands, specs. Required for demand/GMV.
condition	String	any	Filter: any, new, used, refurbished.
priceMin / priceMax	Integer	—	Price bounds in local currency.
officialStoresOnly	Boolean	false	Official store listings only.
includeItems	Boolean	true	Push listing rows to dataset and CSV.
outputFormat	String	full	full, summary_only, or items_only.
pdpConcurrency	Integer	5	Parallel PDP fetches (1–15).
sessionPoolSize	Integer	4	Residential proxy sessions (1–10).
cookies / sessionCookies	Array / String	—	Optional logged-in Mercado Libre cookies when search hits the login wall.
proxyConfiguration	Object	auto	Residential proxy in target country auto-configured.

Input example — keyword niche

{
  "searchQueries": ["freidora de aire"],
  "siteId": "MLA",
  "maxItemsPerQuery": 100,
  "includeProductDetail": true
}

Input example — category analysis

{
  "categoryUrls": ["https://listado.mercadolibre.com.ar/celulares-smartphones"],
  "siteId": "MLA",
  "maxItemsPerQuery": 300,
  "includeProductDetail": true
}

---

Output Format

Market summary (one per query or category)

{
  "type": "market_summary",
  "query": "celulares-smartphones",
  "sourceType": "category",
  "siteId": "MLA",
  "currency": "ARS",
  "summary": {
    "opportunityScore": 70,
    "verdict": "strong_opportunity",
    "demandLevel": "very_high",
    "competitionLevel": "moderate",
    "medianPrice": { "amount": 400450, "display": "$400,450", "currency": "ARS" },
    "estimatedTotalRevenue": { "amount": 9059121723, "display": "$9,059,121,723", "currency": "ARS" },
    "confidence": "high",
    "quickTake": "Strong demand with moderate seller concentration. Opportunity score 70/100."
  }
}

Listing rows

Full fields per analyzed product: id, title, price, soldQuantity, availableQuantity, seller, condition, attributes, permalink, categoryUrl, and more.

Key-value store

File	Content
REPORT.md	Human-readable report with seller, brand, and product tables.
OUTPUT.json	All summaries and items in one JSON document.
listings.csv	Flat CSV with estimated revenue per row.

---

Pricing

Pay-per-event on Apify. You are charged for:

Event	Description
listing-analyzed	Each listing scraped and enriched with product page data (sold quantity, brand, specs, stock) and included in analytics.
market-report	One structured market report per search query or category URL (opportunity score, price stats, demand, GMV, competition, REPORT.md, OUTPUT.json).

Typical run cost scales with listings analyzed plus one report per niche. Deep analysis (PDP) is required for demand and revenue metrics.

---

Understanding the metrics

Opportunity score (0–100)

Score	Verdict
70+	Strong opportunity
45–69	Moderate opportunity
25–44	Weak opportunity
<25	Saturated or low demand

Demand level

From aggregated sold counters: very_high (20,000+ units), high (5,000+), medium (500+), low (50+), very_low (<50).

Confidence

high (80+ listings), medium (30+), low (10+), very_low (<10). Disabling PDP lowers confidence for demand metrics.

---

Integration examples

Node.js

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/mercado-libre-market-intelligence').call({ searchQueries: ['freidora de aire'], siteId: 'MLA', maxItemsPerQuery: 30, includeProductDetail: true, outputFormat: 'full' });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 5));

Python

from apify_client import ApifyClient

client = ApifyClient(token)
run = client.actor("crawloop/mercado-libre-market-intelligence").call(
    run_input={"searchQueries": ["freidora de aire"], "siteId": "MLA", "maxItemsPerQuery": 30, "includeProductDetail": True, "outputFormat": "full"}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("type") or item.get("title"), item.get("query"), item.get("price"))

cURL

curl "https://api.apify.com/v2/acts/crawloop~mercado-libre-market-intelligence/runs?token=$APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["freidora de aire"],"siteId":"MLA","maxItemsPerQuery":30,"includeProductDetail":true,"outputFormat":"full"}'

MCP and AI assistants

Use this Actor from AI tools via Apify MCP. Connect your Apify account, then call crawloop/mercado-libre-market-intelligence.

Example prompts:

• "Run Mercado Libre Market Intelligence for freidora de aire on MLA and summarize opportunity score"
• "Analyze Mercado Libre Brazil niches for wireless earbuds and return demand vs competition"
• "Chain Market Intelligence then Mercado Libre Listings Scraper for bulk raw export"

Suite next step

For bulk raw listing export, use Mercado Libre Listings Scraper.

FAQ

How is this different from the Mercado Libre Listings Scraper?

This Actor adds title-filtered market analytics — opportunity score, demand from sold buckets, competition tables, and Markdown reports. GMV is omitted when too few matched listings remain. The Mercado Libre Scraper — LATAM Prices, Listings & Specs exports raw listing rows for custom pipelines (filter yourself for a narrow niche).

Can I analyze a category instead of a keyword?

Yes. Paste a Mercado Libre category or filtered search URL into categoryUrls. The Actor paginates the category and produces one market report for that niche.

How accurate are revenue estimates?

Sold counters are Mercado Libre's public lifetime values. +1000 vendidos is a bucket floor, not an exact count. GMV is omitted when fewer than 10 title-matched listings remain or the SERP mix-in rate is high. Use figures to compare broad categories, not to size a two-word SKU.

Do I need deep analysis (PDP)?

Yes for demand and GMV — sold counters appear on product pages only. With includeProductDetail: false you still get price and competition stats from search cards at lower runtime.

How long does a run take?

Roughly 3–4 minutes per 100 listings with PDP enabled (parallel pages). A 300-listing category analysis takes about 12–13 minutes. Search-only analytics (no PDP) is faster but skips demand/GMV.

How does it bypass bot protection?

Public search API first, then headless Chromium with residential proxies. A captcha wall plus a thin Ofertas yield fails the run instead of publishing a fake TAM. The Actor does not solve captchas.

Does it export JSON and CSV?

Yes. Summaries and listings go to the Apify dataset; OUTPUT.json, REPORT.md, and listings.csv are in the key-value store.

---

Also see: Mercado Libre Scraper — LATAM Prices, Listings & Specs — raw Mercado Libre listing export, fast search mode, category URLs, and optional PDP enrichment across the same 18 LATAM sites.