Mercado Livre Brazil

Mercado Livre Brazil at a glance

Mercado Livre Brazil is a ready-to-run Apify actor from abotapi for collecting web data. Its documented output includes image, title, change type (incremental mode), listing id and catalogue id, which you can export as JSON, CSV or Excel or read through the Apify API. It costs $1.70 per 1,000 results on the Apify Free plan and from $1.10 on paid plans, with smaller per-run or optional feature charges listed on Apify.

Runs on: Apify cloud: console, API, schedules and integrations
Data type: Web data
Pricing: $1.70 per 1,000 results (Free plan), from $1.10 on paid plans
Output: Documented below · JSON, CSV, Excel
Inputs: 12 options

Scrape Mercado Livre Brazil's best-sellers, category and product-video feeds without login. Extract prices, discounts, instalments, sold counts, shipping, sellers, images and videos. Category mode auto-pages the app's home tabs. Keyword search is sign-in gated.

What Mercado Livre Brazil can do

Auto-paging category feeds. Walk every tab the app's home page shows (Tudo, Moda, Beleza, Celulares, Veículos, Supermercado, Lar, Computação, Televisores, Tv, Primeira Compra) with continuous auto-paging. The feed keeps serving fresh products page after page, just set max products.
Sold counts and shipping signals. Every card carries its marketplace sold count, free-shipping flag, FULL badge and coupon percentage where present.
Incremental mode. Schedule the actor and only pay for new and changed products; unchanged rows are suppressed automatically.
Product videos included. A dedicated video mode returns the marketplace's product-clip feed: playable video URLs, view counts, prices, discounts and seller names for every clip.
Clean, honest output. Every product carries its marketplace id, canonical URL, prices, discount percentage, sold counts, shipping signals and the seller's details. The dataset schema declares every field the Output tab renders.

Choose what to collect

These inputs let you configure Mercado Livre Brazil - Deals, Prices, Sellers & Product Videos. Open the actor on Apify to enter your values and review the current options.

Supported input fields
Input	What it controls
`category`array	Which category feeds to walk, in order (used by category mode only). Empty walks the general Tudo feed.
`maxItems`integer	Hard cap on how many products this run returns and bills for, across every keyword or link.
`maxPages`integer	Optional bound on result pages walked for each keyword or search link. Each page holds up to 48 products. 0 (the default) means unlimited: the walk goes as deep as the marketplace serves and stops on Max products, on a page that returns nothing new, or on the internal 400-page safety stop.
`resumeFromRunId`string	Paste a previous run ID or dataset ID to continue a large pull without returning or charging for products already collected there. Use this after an interrupted run. The walk restarts from the first result page and steps over the products that run already collected, so raise Max result pages per search when you resume a deep pull. For recurring daily monitoring of the same search, use Incremental mode below instead.
`incrementalMode`boolean	Turn this on for daily or recurring monitoring. The first run returns every matching product as NEW. Later runs normally return only NEW, UPDATED and REAPPEARED products. What is compared: every returned field (price, original price, discount, installments, shipping, seller, stock, rating and review count, title, images and so on); changedFields names the ones that moved. What is excluded: scrapedAt (changes on every scrape), reviews (the review rows themselves; a new review still shows up through the review count and rating), and the search-context fields searchPosition (rank on the page), totalResults (size of the result set), searchKeyword (the query that found the product), resultType and sponsored (how this run found the row) and highlight (the ranking badge); these depend on the page and query, not on the product. A changed promotions entry does count as a change. Add more with Ignore fields when detecting changes. Turn on Emit unchanged or Emit expired only when you also want those rows returned (and billed). State is kept separately for each keyword, filter and detail setup; use State key to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.
`stateKey`string	Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently configured runs. Leave empty to let the actor derive a key automatically from the keywords, filters and detail settings, so different searches never mix state with each other.
`emitUnchanged`boolean	Off by default. Turn on to also return products that have not changed since the last run, marked UNCHANGED. This returns, and bills, extra rows you already have, so leave it off unless you want the full snapshot every run.

Show 5 more inputs

More input fields
Input	What it controls
`emitExpired`boolean	Off by default. Turn on to also return products that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned the tracked search, so never when Max products capped it or when Resume was used. This returns, and bills, extra synthetic rows, so leave it off unless you need expiry tracking.
`ignoreFieldsForChanges`array	Output field names that should NOT make a product count as UPDATED, even when they changed (incremental mode only). Matches a field name at any nesting depth. Ignored fields are still returned in the output. Always excluded: scrapedAt, reviews, searchPosition, totalResults, searchKeyword, resultType, sponsored and highlight (they depend on the page and query that found the product, not on the product).
`mcpConnectors`array	Optionally send results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize one under Apify, Settings, API & Integrations, then select it here. Notion gets a rich page-per-item export; other connectors get a best-effort write or digest. Leave empty to skip; never changes the dataset output. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com).
`notionParentPageUrl`string	URL or id of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors.
`maxNotifyListings`integer	Cap on items written to each connector per run. Does not affect the dataset.

Fields in the output

The documented dataset includes the fields below. Availability can depend on the source page and selected mode.

imageImage (image)

titleTitle

changeTypeChange type (incremental mode) (text)

itemIdListing ID

catalogProductIdCatalogue ID

brandBrand

pricePrice (BRL)

originalPricePrice before discount (BRL)

discountPercentDiscount %

currencyCurrency

installmentsTextInstalments

conditionCondition

Show 15 more fields

freeShippingFree shipping

fulfillmentMarketplace fulfilled

sellerNameSeller

officialStoreOfficial store

sellerReputationSeller reputation

availableQuantityAvailable stock

stockStatusStock status

soldQuantitySold

ratingRating

reviewCountOpinions

categoryPathCategory

urlURL (link)

changedFieldsChanged fields (incremental mode)

firstSeenAtFirst seen

lastSeenAtLast seen

Example output

An example from this actor’s documentation. Values are illustrative; this is not a fresh live result.

{
  "itemId": "MLB50196682",
  "title": "Sony PlayStation Store Gift Card R$ 150 (Digital)",
  "price": 150,
  "currency": "BRL",
  "soldText": "+50mil",
  "installmentsText": "5x R$ 30 sem juros",
  "imageUrl": "https://http2.mlstatic.com/D_Q_NP_2X_902418-...webp",
  "url": "https://www.mercadolivre.com.br/MLB50196682"
}

Ways to use this data

Price monitoring: track best-sellers and category feeds on a schedule to spot price drops and discount trends.
Market research: walk category feeds across the app's tabs to see what's actually selling.
Competitive analysis: extract sold counts, discounts and shipping signals to benchmark sellers and products.

Before you run

Start with a small input and check the resulting records against your expected fields. Source content and actor options can change; the current Apify listing is the reference for availability and pricing.

Questions about this actor

What data does Mercado Livre Brazil return?

The documented output for Mercado Livre Brazil includes image, title, change type (incremental mode), listing id, catalogue id, brand, price (brl) and price before discount (brl). Availability of each field depends on the source page and the selected mode.

How much does Mercado Livre Brazil cost?

It costs $1.70 per 1,000 results on the Apify Free plan and from $1.10 on paid plans, with smaller per-run or optional feature charges listed on Apify. The Apify listing shows the current rate for every plan.

Can I get only new or changed products on a schedule?

Yes, turn on Incremental mode and schedule the actor. The first run returns everything; later runs only return new and changed products. See Resume and recurring updates above.

Can I use it with AI agents or MCP?

Yes, connect the dataset to any MCP-compatible client using the MCP connectors input, or pull the results through the API.

A category link that carries a keyword

If you paste a category path with a keyword, the marketplace may serve it as the plain keyword search and drop the category, so the results can differ from what the category alone would show.