Mercado Libre - Get Items

Description

This module allows querying items from your Mercado Libre account, either a specific item by ID or a list with status and search filters.

Configuration

Credentials

This module requires Mercado Libre (OAuth) credentials with the following fields:

Field	Description
access_token	Valid OAuth access token

Parameters

Field	Type	Required	Description
credentials_id	string	Yes	Credentials ID
item_id	string	No	Specific item ID (MLA123456789)
seller_id	string	No	Seller ID (uses credentials if not specified)
status	string	No	Item status
search	string	No	Search by title
limit	number	No	Items per page (max 50)
offset	number	No	Pagination offset

Item Statuses (status)

Value	Description
active	Active listing
paused	Paused listing
closed	Ended listing
under_review	Under MeLi review

Output

{
  "success": true,
  "items": [
    {
      "id": "MLA123456789",
      "title": "iPhone 15 Pro Max 256GB",
      "price": 1500000,
      "currency_id": "ARS",
      "available_quantity": 10,
      "sold_quantity": 25,
      "status": "active",
      "permalink": "https://articulo.mercadolibre.com.ar/...",
      "pictures": [...],
      "attributes": [...]
    }
  ],
  "total": 150,
  "offset": 0,
  "limit": 50,
  "message": "50 items retrieved"
}

Usage Example

Get item by ID

{
  "credentials_id": "meli_cuenta",
  "item_id": "MLA123456789"
}

List active items

{
  "credentials_id": "meli_cuenta",
  "status": "active",
  "limit": 50
}

Search items by title

{
  "credentials_id": "meli_cuenta",
  "search": "iPhone",
  "status": "active"
}

List paused items

{
  "credentials_id": "meli_cuenta",
  "status": "paused"
}

Item pagination

{
  "credentials_id": "meli_cuenta",
  "limit": 50,
  "offset": 100
}

Item Fields

Field	Description
id	Unique item ID (MLA…)
title	Listing title
price	Current price
currency_id	Currency (ARS, MXN, BRL, etc.)
available_quantity	Available stock
sold_quantity	Units sold
status	Listing status
condition	Condition (new, used)
listing_type_id	Listing type
permalink	Listing URL
pictures	Image array
attributes	Product attributes
shipping	Shipping configuration

Example Workflows

Stock sync

[Schedule every 30min] -> [MeliGetItems active] -> [Loop] -> [Update ERP]

Listing monitoring

[Daily schedule] -> [MeliGetItems] -> [Check prices] -> [Slack alert]

Catalog export

[Manual trigger] -> [MeliGetItems] -> [Pagination] -> [Generate Excel]

Usage with ExecuteScript

// Analyze items by status
const items = ctx.data.items;

const stats = {
  total: items.length,
  activos: items.filter(i => i.status === 'active').length,
  pausados: items.filter(i => i.status === 'paused').length,
  sin_stock: items.filter(i => i.available_quantity === 0).length,
  valor_inventario: items.reduce((sum, i) =>
    sum + (i.price * i.available_quantity), 0)
};

ctx.data = stats;

API Used

• API: Mercado Libre API
• Endpoint: GET /users/{user_id}/items/search, GET /items/{id}
• Documentation: https://developers.mercadolibre.com/

Notes

• The maximum limit per request is 50 items
• Items are fetched in batches of 20 to include full details
• The seller_id is taken from credentials if not specified
• The search (search) filters by item title

Related Nodes

• MeliCreateItem - Create new items
• MeliUpdateItem - Update existing items
• MeliGetOrders - Query item sales