MercadoLibre Exodus Intelligence Feed

What is MercadoLibre Exodus Intelligence Feed?

MercadoLibre Exodus Intelligence Feed is an authenticated MercadoLibre API feed for automotive-parts teams that need verified listing data rather than browser guesses. It returns one enriched dataset row per listing with title, price, description, seller reputation and seller location, or one vehicle-compatibility report per MercadoLibre user product drawn from the authorized MLM-CARS_AND_VANS_FOR_COMPATIBILITIES domain. A third mode extracts the Mexican compatibility domain itself with no credentials, which makes a quick health check. Catalog managers, pricing analysts and AI agents use it to keep MercadoLibre Mexico parts data accurate.

Why parts teams choose this MercadoLibre feed

• Official API data. Listings and compatibility come from MercadoLibre's authenticated endpoints, so every field traces back to the marketplace.
• Real fitment, never inferred. Compatibility rows contain exactly the vehicle entries MercadoLibre returns for a user product, up to maxVehicleMatchesPerProduct.
• Listing enrichment in one row. Description and seller signals arrive together on each enriched listing.
• Search or explicit URLs. Enrich known listing URLs, or send a searchQuery for one marketplace and enrich up to maxResults listings.
• Clear outcomes. Each run writes OUTPUT and RUN_SUMMARY with COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT, UPSTREAM_FAILED or CONFIG_ERROR.
• Light and quick. API calls with bounded concurrency, no browser and no residential proxy.

Best fit for this Actor

• Designed for authorized partner workflows where the Actor owner has configured MercadoLibre OAuth access as the MELI_ACCESS_TOKEN environment secret. The token is never a run input and never appears in logs.
• Best fit for Mexican automotive-parts catalogs that need seller-verified descriptions and MercadoLibre-backed vehicle fitment.
• The compatibility_domain mode works for everyone with no credentials and confirms the compatibility domain is reachable.
• When you want public listing discovery by keyword across LATAM, start with MercadoLibre Search Scraper, then pass the listing URLs into startUrls here for enrichment.
• For public product and seller data with no OAuth access, use MercadoLibre Product and Seller Data Scraper instead.

Example workflow: from a parts search to verified fitment

A parts catalog manager starts each morning with a listing_enrichment job for searchQuery "filtro aire jetta" in MX, with maxResults at 150. The dataset returns each listing's itemId, price, description, sellerReputation and sellerLocation. They then pass the listing URLs of the products they plan to stock into a vehicle_compatibility job, which returns MercadoLibre's own fitment list per user product. The team compares fitment against their internal catalog, exports mismatches for review, and schedules both jobs daily so pricing and fitment stay current.

Input

Vehicle compatibility for known listings:

{
  "mode": "vehicle_compatibility",
  "startUrls": [
    { "url": "https://articulo.mercadolibre.com.mx/MLM-1234567890-example-_JM" }
  ],
  "maxResults": 150,
  "maxVehicleMatchesPerProduct": 50,
  "apiConcurrency": 4
}

Search then enrich:

{
  "mode": "listing_enrichment",
  "country": "MX",
  "searchQuery": "filtro aire jetta",
  "maxResults": 150,
  "apiConcurrency": 4
}

Compatibility-domain check with no credentials (the default input):

{
  "mode": "compatibility_domain",
  "compatibilityQuery": "camioneta"
}

Field	Type	What it controls
mode	string	compatibility_domain (default), listing_enrichment or vehicle_compatibility.
compatibilityQuery	string	Query for the compatibility-domain lookup. Default camioneta.
startUrls	array	MercadoLibre listing URLs to enrich or check for fitment.
searchQuery	string	Listing search for listing_enrichment mode.
country	string	Marketplace: MX (default), BR, AR, CL, CO, PE, UY, EC or DO.
maxResults	integer	Listings or products to process. Default 10.
apiConcurrency	integer	Parallel API calls. Default 4.
userProductIds	array	MercadoLibre user product IDs, used in place of listing URLs for fitment.
maxVehicleMatchesPerProduct	integer	Vehicle entries per product. Default 50.

Output

Field	What it contains
mode, country, siteId, source	Which operation produced the row and the marketplace
itemId, title, url, categoryId, categoryPath	Listing identity and category
price, originalPrice, currencyId, discountPercent	Pricing
condition, soldQuantity, availableQuantity, freeShipping, installments	Offer details
thumbnail, pictures, attributes, variations	Media, attributes and variations
description	Listing description from the item-description endpoint
sellerId, sellerName, sellerReputation, sellerLocation, location	Seller signals
reviewRating, reviewCount	Review aggregates when MercadoLibre supplies them
compatibilityDomain	Compatibility domain ID, name, category and attributes
dateScraped, _warnings	Collection time and any field-level notes

Compatibility-domain row:

{
  "mode": "compatibility_domain",
  "country": "MX",
  "siteId": "MLM",
  "itemId": null,
  "title": "Carros y camionetas para compatibilidades",
  "url": null,
  "price": null,
  "currencyId": "MXN",
  "attributes": [
    { "id": "REGION", "name": "Región", "value": "México" },
    { "id": "ASPIRATION", "name": "Aspiración", "value": "Aspirado" }
  ],
  "categoryId": "MLM456252",
  "categoryPath": "Auto y Camioneta para Compats",
  "description": null,
  "sellerId": null,
  "compatibilityDomain": {
    "id": "MLM-CARS_AND_VANS_FOR_COMPATIBILITIES",
    "name": "Carros y camionetas para compatibilidades",
    "categoryId": "MLM456252",
    "categoryName": "Auto y Camioneta para Compats"
  },
  "dateScraped": "2026-10-02T15:02:01.366Z",
  "source": "mercadolibre-domain-discovery-api",
  "_warnings": null
}

Enriched listing row (illustrative values):

{
  "mode": "listing_enrichment",
  "country": "MX",
  "siteId": "MLM",
  "itemId": "MLM1234567890",
  "title": "Filtro De Aire Jetta A6 2.5",
  "url": "https://articulo.mercadolibre.com.mx/MLM-1234567890-example-_JM",
  "price": 289,
  "currencyId": "MXN",
  "condition": "new",
  "description": "Filtro de aire de reemplazo para Jetta A6 2.5.",
  "sellerId": "123456789",
  "sellerReputation": "5_green",
  "sellerLocation": "Ciudad de México",
  "dateScraped": "2026-10-02T15:02:01.366Z",
  "_warnings": null
}

Pricing

This Actor uses Pay per event plus Apify platform usage. The events are Actor Start (once per run), Premium enriched listing (one per enriched listing row, with description and seller fields included) and Vehicle compatibility report (one per user product, covering every returned vehicle entry up to your cap). Compatibility-domain rows carry only the start event. For example, a daily enrichment of 150 listings is one start event plus 150 enriched-listing events, plus the platform usage of that job. The live Pricing tab on this page shows the current price of each event.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~mercadolibre-exodus-intelligence-feed/run-sync-get-dataset-items?token=YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode": "compatibility_domain", "compatibilityQuery": "camioneta"}'

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")
run = client.actor("khadinakbar/mercadolibre-exodus-intelligence-feed").call(run_input={
    "mode": "listing_enrichment",
    "country": "MX",
    "searchQuery": "filtro aire jetta",
    "maxResults": 20,
})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(row["itemId"], row["price"], row["sellerReputation"])

Use with AI agents (MCP)

The Actor is available through Apify MCP for Claude, ChatGPT, Cursor and other MCP clients. Example prompt:

Enrich these three MercadoLibre Mexico listing URLs with description and seller reputation, then check their vehicle compatibility and list the vehicles each one fits.

The agent starts the Actor in listing_enrichment and then vehicle_compatibility mode, reads rows with get-dataset-items, and reads OUTPUT.outcome to confirm each step. Keep itemId, url and dateScraped for provenance. For cost and scope, set maxResults and maxVehicleMatchesPerProduct before starting, and begin with compatibility_domain to confirm access.

Best results

Starting situation	Helpful action	Expected outcome
Confirming the feed is reachable	Use the default compatibility_domain input	One domain row with only the start event
You already store user product IDs	Send userProductIds in place of listing URLs	Fitment with one fewer lookup per product
Broad parts research	Use searchQuery with a focused part name and maxResults	A bounded batch of enriched listings
Large fitment lists	Set maxVehicleMatchesPerProduct to the depth you need	Predictable row size per product
Automated pipelines	Branch on OUTPUT.outcome	Clean handling of PARTIAL and VALID_EMPTY outcomes

Enrichment and fitment modes depend on the OAuth access configured for this Actor; the CONFIG_ERROR outcome signals that access needs attention, and the domain mode keeps working throughout.

Builder's note

I built this feed to replace a slow browser verification loop with direct MercadoLibre API calls, because parts catalogs live or die on fitment accuracy. I designed the compatibility mode to return only what MercadoLibre's authorized endpoint states, so the feed never derives fitment from a title or category, and I kept the credential in an environment secret so it never travels in run input.

FAQ

Do I need my own MercadoLibre token?

The OAuth access is configured on the Actor by its owner as an environment secret. The compatibility_domain mode needs no credentials at all.

Which marketplaces are covered?

Listing enrichment works across MX, BR, AR, CL, CO, PE, UY, EC and DO. Vehicle compatibility focuses on the Mexican MLM-CARS_AND_VANS_FOR_COMPATIBILITIES domain.

Responsible use

Use the results for legitimate ecommerce research in line with applicable law, MercadoLibre's terms and API policies, and your organization's data-governance rules. MercadoLibre token scopes and compatibility rights remain the authority for item and user-product data. MercadoLibre is a trademark of its owner; this independent Actor is not affiliated with or endorsed by MercadoLibre.