Have questions? Leave your message here or Schedule a quick call with our manager now

A Step-by-Step Guide to the MercadoLibre Developers API

A Step-by-Step Guide to the MercadoLibre Developers API

Updated 19 October 2026 |

The MercadoLibre Developers API is a REST API that allows software applications to access and manage product listings, orders, shipments, and claims on Mercado Libre, one of Latin America's largest eCommerce marketplaces. It uses JSON for data exchange and OAuth 2.0 for authorization, with country-specific site IDs such as MLB for Brazil, MLA for Argentina, and MLM for Mexico.

Mercado Libre operates across 18 countries. Therefore, developers must account for local currencies, product categories, and marketplace requirements when building integrations.

API2Cart connects SaaS applications to 80+ eCommerce platforms and marketplaces through one unified API.

🇪🇸 También disponible en español: Si buscas documentación de la API de MercadoLibre en español, consulta nuestra guía en Integración con MercadoLibre →

Why MercadoLibre API Integration Matters in Latin America

Mercado Libre is a major eCommerce marketplace in Latin America. Its expanding ecosystem creates demand for integrations with ERP, OMS, PIM, inventory management, and shipping software.

According to Mercado Libre's Q2 2026 financial results, the marketplace generated approximately $22 billion in gross merchandise volume (GMV), up 36% year over year on an FX-neutral basis.

Moreover, the marketplace reached 89 million unique active buyers and sold 795 million items during Q2 2026. These figures highlight the scale of marketplace operations that eCommerce SaaS providers need to support.

Growth was particularly strong in three major markets. According to the same Q2 2026 report, items sold increased by 56% in Brazil, 34% in Mexico, and 22% in Argentina year over year.

Consequently, software providers need reliable access to product listings, orders, inventory, and fulfillment data across regional marketplaces. MercadoLibre API integration helps automate these operations and reduce manual data processing.

This guide explains the MercadoLibre Developers API, including its REST architecture, authentication, technical features, and integration best practices for eCommerce SaaS developers.

Why MercadoLibre API Integration Matters in Latin America

Mercado Libre is a major eCommerce marketplace in Latin America. Its expanding ecosystem creates demand for integrations with ERP, OMS, PIM, inventory management, and shipping software.

According to Mercado Libre's Q2 2026 financial results, the marketplace generated approximately $22 billion in gross merchandise volume (GMV), up 36% year over year on an FX-neutral basis.

Moreover, the marketplace reached 89 million unique active buyers and sold 795 million items during Q2 2026. These figures highlight the scale of marketplace operations that eCommerce SaaS providers need to support.

Growth was particularly strong in three major markets. According to the same Q2 2026 report, items sold increased by 56% in Brazil, 34% in Mexico, and 22% in Argentina year over year.

Consequently, software providers need reliable access to product listings, orders, inventory, and fulfillment data across regional marketplaces. MercadoLibre API integration helps automate these operations and reduce manual data processing.

This guide explains the MercadoLibre Developers API, including its REST architecture, authentication, technical features, and integration best practices for eCommerce SaaS developers.

Importance of MercadoLibre API for Developers

The MercadoLibre API is a powerful tool for developers who want to integrate with one of the largest eCommerce marketplaces in Latin America. With the MercadoLibre API, developers can create applications that interact with the platform. They can add products, control stock, and process orders. This automation ensures accurate, up-to-date information in all systems. Developers can integrate these features into their applications to enhance eCommerce performance, capacity, and productivity.

youtube placeholder image

Technical Features of MercadoLibre API

Core Functionality:

  • RESTful Architecture: The MercadoLibre API follows a RESTful pattern, which is familiar to many developers. This means that developers can use the HTTP methods such as GET, POST, PUT, and DELETE to work with data, easing the learning process for developers experienced in web development.
  • Resource-Based Endpoints: The API has a structured set of endpoints. These serve as access points to MercadoLibre’s platform resources, such as products, orders, sellers, shipments, claims, and more. Each endpoint has specific functionalities for handling its respective resource (e.g., inquiring about product details, placing orders, and handling shipping labels).

Data Management:

  • JSON Data Format: The MercadoLibre API uses JSON, a lightweight and easy-to-manage data format for developers.
  • Filtering and Sorting: The API allows developers to arrange data according to specific parameters, boosting efficiency by fetching only the essential data.
  • Pagination: The MercadoLibre API offers pagination, allowing developers to limit data volume and improve the performance and user experience of their applications.

Authentication and Security:

  • HTTPS Protocol: The API uses the HTTPS protocol to ensure secure communication, protecting sensitive information such as login and financial details.
  • OAuth Authentication: OAuth enables secure user authorization, allowing developers to access user data without storing sensitive information like passwords.
  • Rate Limiting: The API has rate limits to prevent overuse and ensure fair access for all users.

Developing Integrations with MercadoLibre API

Integrating with the MercadoLibre API might be a challenging process, especially if the programmer is not familiar with the API endpoints, authentication, and data processing mechanisms. However, using a single integration platform, such as API2Cart, can help avoid these challenges. MercadoLibre is one of the eCommerce platforms integrated by API2Cart, simplifying the development process. API2Cart allows developers to focus on building their application while leveraging the power of the MercadoLibre API.

mercadolibre-developers-api-integration

API2Cart simplifies MercadoLibre integration. It lets developers manage product catalogs, stock, orders, and customers across multiple eCommerce systems via one interface. After integrating with API2Cart, eCommerce software can communicate with MercadoLibre and other integrated platforms without further coding. API2Cart offers detailed documentation, software development kits and support to ensure smooth integration. This support helps businesses unlock the potential of the MercadoLibre marketplace and improve their eCommerce operations.

How Can You Add Products to MercadoLibre Using the API2Cart?

To publish products on MercadoLibre programmatically, developers need a reliable way to send structured product data to the marketplace. API2Cart provides a unified ProductAdd API method that allows your software to create new product listings on MercadoLibre using a single request format.

Below is an example request structure that demonstrates how to add a product to MercadoLibre via the API.


{
  "name": "Bag",
  "model": "bag_01",
  "description": "Product description",
  "price": 99.9,
  "sku": "bag_01",
  "category_id": "6",
  "quantity": 0,
  "gtin": "12345678912345",
  "manufacturer": "Samsung",
  "image_url": "https://docs.api2cart.com/img/logo.png",
  "specifics": [
    {
      "name": "string",
      "value": "string"
    }
  ],
  "condition": "Like New",
  "listing_type": "FixedPrice",
  "idempotency_key": "098f6bcd4621d373cade4e832627b4f6"
}

This request sends all essential product data required by MercadoLibre, including pricing, stock availability, category mapping, and media assets. By using API2Cart, developers avoid working directly with MercadoLibre’s native API specifics and can reuse the same ProductAdd logic across multiple marketplaces.

This approach is especially useful for SaaS products that manage catalogs, automate product publishing, or synchronize inventory across multiple sales channels.

MercadoLibre API for LatAm Markets: Regional Considerations

MercadoLibre operates across 18 countries in Latin America, and the API has important regional distinctions that affect how SaaS products should build integrations:

CountrySite IDNotes
ArgentinaMLALargest market by GMV; ARS currency, local fulfillment network (Mercado Envíos)
BrazilMLBHighest transaction volume; BRL currency, Pix payment integration common
MexicoMLMFast-growing; MXN currency, cross-border commerce from US sellers
ColombiaMCOCOP currency; significant growth in 2023-2024
ChileMLCCLP currency; high internet penetration
OtherVariousUruguay (MLU), Venezuela (MLV), Peru (MPE), and more

Each Site ID has its own category tree, currency, and sometimes different API behavior. SaaS products integrating with multiple LatAm markets need to handle site_id routing in their request logic. API2Cart's MercadoLibre connector normalizes these differences so your product logic stays platform-independent.

Key LatAm-specific integration notes:

  • Product listings require site-specific category IDs — a category in MLA is different from MLB
  • Shipping rules differ by country (Mercado Envíos is the default carrier in most markets)
  • Currency handling must support 6+ currencies across the region
  • OAuth tokens are valid per user account but scoped per site

For Spanish-language documentation and integration support, see also: Integración MercadoLibre con API2Cart (ES)

Conclusion

Integrating with the MercadoLibre API allows software vendors and SaaS teams to extend their eCommerce solutions into one of the most active and competitive marketplaces in Latin America. By working directly with MercadoLibre’s Developers API, developers can manage products, orders, inventory, and customer data while adapting their software to regional market requirements.

To reduce development complexity and avoid maintaining a standalone integration, many teams choose a unified API approach. API2Cart provides a single integration point to connect with MercadoLibre alongside dozens of other eCommerce platforms, allowing developers to focus on core product functionality instead of ongoing API maintenance.

If you are building or scaling an eCommerce integration, sign up for free and explore how API2Cart can simplify your MercadoLibre API integration.

FAQs

Why is MercadoLibre API integration important for eCommerce software vendors?

MercadoLibre is the dominant marketplace in Latin America, making it a critical sales channel for merchants in this region. For eCommerce software vendors, integrating with the MercadoLibre API allows them to support merchants operating in Argentina, Brazil, Mexico, and other high-growth markets. As a result, software providers can expand their product reach, improve customer acquisition, and offer true multi-marketplace capabilities.

What types of eCommerce data can developers manage via the MercadoLibre API?

The MercadoLibre API provides access to core commerce entities such as products, orders, inventory, shipments, sellers, and claims. This allows SaaS platforms to automate catalog management, order processing, and stock synchronization. Consequently, developers can build scalable solutions that keep data consistent across systems and reduce manual operational work.

What technical challenges should developers consider when working with the MercadoLibre API?

Developers need to handle OAuth authentication, rate limits, pagination, and marketplace-specific data structures. In addition, maintaining compatibility with frequent API updates can increase long-term development and support costs. Because of this, many teams look for abstraction layers that reduce direct dependency on native marketplace APIs.

How does API2Cart simplify integration with the MercadoLibre Developers API?

API2Cart provides a unified API that abstracts MercadoLibre’s native endpoints into a consistent data model shared across 80+ eCommerce platforms. This allows developers to reuse the same logic for product publishing, order synchronization, and inventory management. As a result, SaaS teams reduce integration complexity, speed up time-to-market, and minimize ongoing maintenance effort.

Related Articles