Nexra
All connectors
Implemented
Commerce, marketplaces & inventory
Mercado Libre logo

Mercado Libre

Read and manage Mercado Libre listings (items, price, stock, descriptions), read orders and shipments, answer buyer questions, and read categories and attributes.

Sync Latin American marketplace listings, stock and prices with your catalogue and route Mercado Libre orders and buyer questions into operations.

Build a flow with Mercado LibreProvider API documentation

Source actions

13

Destination actions

4

Data types

10

Validation status

Implemented · fixture tested.

Implementation is checked against provider-shaped fixtures for every action, authentication failures, rate limits, pagination and duplicate safety. Provider sandbox and authorised account validation are recorded separately when credential-backed runs are completed.

What you can map

answers
  • Answer question
    Destination
    Not retried automatically
    Approval before production

    Post the seller's public answer to a buyer question.

    answers.send
categories
  • Get category
    Source

    A category with its path from root, children and listing settings.

    categories.get
  • List site categories
    Source

    Top-level categories for the connection's site.

    categories.list
category attributes
  • List category attributes
    Source

    Attributes a category supports, with required flags and allowed values.

    category_attributes.list
category predictions
  • Predict category
    Source

    Suggested domains and categories for a product title.

    category_predictions.list
item descriptions
  • Get item description
    Source

    A listing's plain-text description.

    item_descriptions.get
  • Update item description
    Destination
    Provider duplicate protection
    Approval before production

    Replace a listing's plain-text description.

    item_descriptions.update
items
  • Create item
    Destination
    Not retried automatically
    Approval before production

    Publish a listing with explicit price and stock (title or family name).

    items.create
  • Get item
    Source

    A listing with price, stock, status, attributes, variations and pictures.

    items.get
  • Search seller items
    Source

    IDs of the seller's listings by status or SKU.

    items.search
  • Update item
    Destination
    Provider duplicate protection
    Approval before production

    Change a listing's title, price, stock, status (active or paused) or attributes.

    items.update
orders
  • Get order
    Source

    One order with items, payments and shipment reference.

    orders.get
  • Search orders
    Source
    Incremental

    The seller's orders updated since a date, oldest first, optionally by status.

    orders.list
questions
  • Get question
    Source

    One buyer question with its answer.

    questions.get
  • List buyer questions
    Source

    Questions on the seller's listings, by status or item.

    questions.list
shipments
  • Get shipment
    Source

    Shipment status, tracking number, logistics type and receiver address.

    shipments.get
users
  • Get authorised user
    Source

    The authorised seller's ID, nickname, site and reputation.

    users.get

Authentication

OAuth 2.0 refresh token (single-use, rotated on refresh)

Plans and access

Any Mercado Libre seller with a registered application in the DevCenter. The application needs read, write and offline_access permissions; some categories require the User Products model (family_name instead of title).

Test environment

Create test users with POST /users/test_user on your application to test listings and orders.

Rate limits

Per-application quotas (orders search about 100 requests per minute); HTTP 429 when exceeded. Access tokens last 6 hours.

Pagination

offset and limit with paging.total (items search max 100 per page and 1,000 results; orders 51 per page).

Provider events

Notifications for orders_v2, items, questions, shipments and payments topics. Nexra event triggers are not yet available; flows run on demand or on a schedule.

Before you build a flow

  • This is the marketplace API; Mercado Pago payments are a separate connector.
  • Refresh tokens are single-use: every refresh writes the new token back to Key Vault, and a failed write requires re-authorisation.
  • Item search returns IDs only; use Get item for full details. Results beyond 1,000 need scan mode, which is not implemented.
  • Closing or deleting listings, cancellations, refunds and claims are not implemented.
  • Mercado Libre documents no idempotency key; item creation and answers are not repeated automatically when uncertain.
  • Buyer contact details and addresses are masked by Mercado Libre and only available on shipments.

Developer reference

  1. Create the Mercado Libre credentials described above with the narrowest permissions your flows need.
  2. In Nexra, open Connect, then Connections, then New connection, choose Mercado Libre, enter its settings and credentials, and tick only the write actions you need. Connection guide
  3. Test the connection, then use its actions as flow sources and destinations. Flow guide
Mercado Libre docsAPI referenceMercado Libre docsAuthenticationMercado Libre docsRate limitsMercado Libre docsWebhooks

Machine-readable detail: GET /api/public/connect/connectors/mercado-libre and the Connections API.