Mercado Libre

App · 20 actions

Run your Mercado Libre store: publish and update listings, price and stock, follow orders and shipments, answer buyers' questions and message buyers after a sale.

Actions

ActionWhat it does
Answer questionAnswer a buyer's question on one of your listings.
Change item statusPause a listing, reactivate a paused one, or close it.
Delete itemDelete a listing for good, closing it first if it is open.
Get categoryGet a category: its name, path, subcategories and the settings its listings follow, such as currencies and conditions.
Get itemGet one listing: title, price, stock, status, pictures, attributes and link.
Get item descriptionGet the plain-text description shown on a listing.
Get my accountGet the Mercado Libre account the connection signed in as: its user id, nickname, country site and seller reputation.
Get orderGet one sale: status, items, amounts, payments, buyer and shipment id.
Get order messagesGet the messages between you and an order's buyer.
Get questionGet one question and its answer, if it has one.
Get shipmentGet a sale's shipment: its status, tracking number, addresses and package.
List category attributesList the attributes a category's listings take, such as brand and model, and which of them are required.
List my itemsList your own listings with their title, price, stock and status, filtered by status or SKU.
Publish itemPublish a new listing in a category, with its price, stock, pictures, attributes and description.
Search ordersFind your sales by status, date or a word (order number, item or buyer nickname).
Search questionsFind questions buyers asked on your listings, by listing or status.
Send message to buyerSend a message to an order's buyer in its post-sale conversation.
Set item descriptionGive a listing its description, replacing the one it has.
Suggest categoryFind the category to list a product in from its title, as Mercado Libre's own predictor does, with attributes it recognised.
Update itemChange a listing's price, stock or title.

Answer question

Answer a buyer's question on one of your listings. The answer is public on the listing. Up to 2000 characters.

Inputs

Question IDquestion_idtextRequired
The question's number, from 'Search questions' or a trigger.
AnswertexttextRequired
What to answer, up to 2000 characters.

Outputs

answeredtrue/false
Always true once sent
questionobject
The question, with its answer
Example output
{
  "answered": true,
  "question": {
    "answer": {
      "date_created": "2026-01-05T14:00:00.000-04:00",
      "status": "ACTIVE",
      "text": "S\u00ed, tenemos talle 42."
    },
    "date_created": "2026-01-05T13:22:01.600-04:00",
    "deleted_from_listing": false,
    "from": {
      "id": 419067349
    },
    "hold": false,
    "id": 11436370259,
    "item_id": "MLA1136716168",
    "seller_id": 202593498,
    "status": "ANSWERED",
    "text": "Hola, \u00bftienen talle 42?"
  }
}

Change item status

Pause a listing, reactivate a paused one, or close it. A closed listing can't be reactivated.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.
StatusstatustextRequired
What the listing becomes.One of: active (Active (reactivate a paused item)), paused, closed (Closed (ends the listing for good)).

Outputs

itemobject
The listing
Example output
{
  "item": {
    "attributes": [
      {
        "id": "BRAND",
        "value_name": "Propia"
      }
    ],
    "available_quantity": 2,
    "base_price": 15000,
    "buying_mode": "buy_it_now",
    "category_id": "MLA109027",
    "condition": "new",
    "currency_id": "ARS",
    "date_created": "2022-05-10T21:55:46.000Z",
    "id": "MLA1136716168",
    "initial_quantity": 2,
    "last_updated": "2022-05-22T09:49:16.725Z",
    "listing_type_id": "gold_special",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
    "pictures": [],
    "price": 15000,
    "seller_id": 202593498,
    "site_id": "MLA",
    "sold_quantity": 0,
    "status": "paused",
    "sub_status": [],
    "tags": [
      "test_item"
    ],
    "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
    "title": "Zapatillas Avid Fof - Test Item",
    "variations": []
  }
}

Delete item

Delete a listing for good, closing it first if it is open. This can't be undone.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.

Outputs

deletedtrue/false
Always true once deleted
itemobject
The listing, as Mercado Libre last returned it
item_idtext
The listing deleted
Example output
{
  "deleted": true,
  "item": {
    "attributes": [
      {
        "id": "BRAND",
        "value_name": "Propia"
      }
    ],
    "available_quantity": 2,
    "base_price": 15000,
    "buying_mode": "buy_it_now",
    "category_id": "MLA109027",
    "condition": "new",
    "currency_id": "ARS",
    "date_created": "2022-05-10T21:55:46.000Z",
    "id": "MLA1136716168",
    "initial_quantity": 2,
    "last_updated": "2022-05-22T09:49:16.725Z",
    "listing_type_id": "gold_special",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
    "pictures": [],
    "price": 15000,
    "seller_id": 202593498,
    "site_id": "MLA",
    "sold_quantity": 0,
    "status": "closed",
    "sub_status": [],
    "tags": [
      "test_item"
    ],
    "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
    "title": "Zapatillas Avid Fof - Test Item",
    "variations": []
  },
  "item_id": "MLA1136716168"
}

Get category

Get a category: its name, path, subcategories and the settings its listings follow, such as currencies and conditions.

Inputs

Category IDcategory_idtextRequired
The category, such as MLA1055. 'Suggest category' finds one from a product title.

Outputs

categoryobject
The category
Example output
{
  "category": {
    "children_categories": [],
    "id": "MLA1055",
    "name": "Celulares y Smartphones",
    "path_from_root": [
      {
        "id": "MLA1051",
        "name": "Celulares y Tel\u00e9fonos"
      }
    ],
    "settings": {
      "currencies": [
        "ARS"
      ],
      "item_conditions": [
        "new",
        "used"
      ]
    },
    "total_items_in_this_category": 79627
  }
}

Get item

Get one listing: title, price, stock, status, pictures, attributes and link.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.

Outputs

itemobject
The listing
Example output
{
  "item": {
    "attributes": [
      {
        "id": "BRAND",
        "value_name": "Propia"
      }
    ],
    "available_quantity": 2,
    "base_price": 15000,
    "buying_mode": "buy_it_now",
    "category_id": "MLA109027",
    "condition": "new",
    "currency_id": "ARS",
    "date_created": "2022-05-10T21:55:46.000Z",
    "id": "MLA1136716168",
    "initial_quantity": 2,
    "last_updated": "2022-05-22T09:49:16.725Z",
    "listing_type_id": "gold_special",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
    "pictures": [],
    "price": 15000,
    "seller_id": 202593498,
    "site_id": "MLA",
    "sold_quantity": 0,
    "status": "active",
    "sub_status": [],
    "tags": [
      "test_item"
    ],
    "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
    "title": "Zapatillas Avid Fof - Test Item",
    "variations": []
  }
}

Get item description

Get the plain-text description shown on a listing.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.

Outputs

descriptionobject
The description
plain_texttext
Its text
Example output
{
  "description": {
    "date_created": "2022-05-10T21:55:46.000Z",
    "last_updated": "2022-05-10T21:55:46.000Z",
    "plain_text": "Zapatillas urbanas.",
    "text": ""
  },
  "plain_text": "Zapatillas urbanas."
}

Get my account

Get the Mercado Libre account the connection signed in as: its user id, nickname, country site and seller reputation.

Inputs

None.

Outputs

accountobject
The signed-in account
Example output
{
  "account": {
    "country_id": "AR",
    "email": "test_user_50698062@testuser.com",
    "first_name": "Test",
    "id": 202593498,
    "last_name": "Test",
    "nickname": "TETE2870021",
    "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
    "registration_date": "2016-01-06T11:31:42.000-04:00",
    "seller_reputation": {
      "level_id": null,
      "power_seller_status": null
    },
    "site_id": "MLA",
    "tags": [
      "normal",
      "test_user"
    ],
    "user_type": "normal"
  }
}

Get order

Get one sale: status, items, amounts, payments, buyer and shipment id.

Inputs

Order IDorder_idtextRequired
The sale's order number, such as 2000003508419013.

Outputs

missing_partslist
Parts Mercado Libre couldn't include this time, such as buyer
orderobject
The order
Example output
{
  "missing_parts": [],
  "order": {
    "buyer": {
      "id": 207040551,
      "nickname": "TETE5029382"
    },
    "currency_id": "ARS",
    "date_closed": "2026-01-05T10:31:00.000-03:00",
    "date_created": "2026-01-05T10:30:00.000-03:00",
    "date_last_updated": "2026-01-05T10:35:00.000Z",
    "id": 2000003508419013,
    "order_items": [
      {
        "item": {
          "id": "MLA1136716168",
          "title": "Zapatillas"
        },
        "quantity": 1
      }
    ],
    "pack_id": null,
    "paid_amount": 15000,
    "payments": [
      {
        "id": 1833868697,
        "status": "approved"
      }
    ],
    "seller": {
      "id": 202593498,
      "nickname": "TETE2870021"
    },
    "shipping": {
      "id": 40732312470
    },
    "status": "paid",
    "status_detail": null,
    "tags": [
      "paid"
    ],
    "total_amount": 15000
  }
}

Get order messages

Get the messages between you and an order's buyer. Reading them here doesn't mark them as read.

Inputs

Order IDorder_idtextRequired
The sale's order number, such as 2000003508419013.
How manylimitnumber
How many to return, 1 to 100. Mercado Libre's default is 10.From 1 to 100.
Start atoffsetnumber
How many messages to skip, for the next page.At least 0.

Outputs

conversation_statusobject
Whether the conversation is open, and why not
countnumber
How many are on this page
messageslist
The messages
pack_idtext
The conversation's pack
seller_max_message_lengthnumber
The longest message you may send
totalnumber
How many there are in all
Example output
{
  "conversation_status": {
    "status": "active",
    "substatus": null
  },
  "count": 1,
  "messages": [
    {
      "from": {
        "user_id": "202593498"
      },
      "id": "fd1d2e37ad004ede9e0bf25d1215002d",
      "message_attachments": [],
      "message_date": {
        "created": "2026-01-05T20:01:46.000Z",
        "read": null
      },
      "message_moderation": {
        "status": "clean"
      },
      "message_resources": [
        {
          "id": "2000003508419013",
          "name": "packs"
        }
      ],
      "site_id": "MLA",
      "status": "available",
      "text": "Hola, ya despachamos tu pedido.",
      "to": {
        "user_id": "207040551"
      }
    }
  ],
  "pack_id": "2000003508419013",
  "seller_max_message_length": 350,
  "total": 1
}

Get question

Get one question and its answer, if it has one.

Inputs

Question IDquestion_idtextRequired
The question's number, from 'Search questions' or a trigger.

Outputs

questionobject
The question
Example output
{
  "question": {
    "answer": null,
    "date_created": "2026-01-05T13:22:01.600-04:00",
    "deleted_from_listing": false,
    "from": {
      "id": 419067349
    },
    "hold": false,
    "id": 11436370259,
    "item_id": "MLA1136716168",
    "seller_id": 202593498,
    "status": "UNANSWERED",
    "text": "Hola, \u00bftienen talle 42?"
  }
}

Get shipment

Get a sale's shipment: its status, tracking number, addresses and package. The order's shipping id is the shipment id.

Inputs

Shipment IDshipment_idtextRequired
The shipment's number: an order's shipping id.

Outputs

shipmentobject
The shipment
Example output
{
  "shipment": {
    "date_created": "2026-01-05T10:31:00.000-03:00",
    "destination": {
      "receiver_name": "Test Test",
      "type": "buying_address"
    },
    "dimensions": {
      "height": 10,
      "length": 30,
      "weight": 500,
      "width": 20
    },
    "id": 40732312470,
    "last_updated": "2026-01-05T12:00:00.000-03:00",
    "logistic": {
      "mode": "me2",
      "type": "drop_off"
    },
    "origin": {
      "type": "selling_address"
    },
    "status": "ready_to_ship",
    "substatus": "printed",
    "tracking_number": "TR123"
  }
}

List category attributes

List the attributes a category's listings take, such as brand and model, and which of them are required.

Inputs

Category IDcategory_idtextRequired
The category, such as MLA1055. 'Suggest category' finds one from a product title.

Outputs

attributeslist
The attributes
countnumber
How many there are
requiredlist
The ids of the required ones
Example output
{
  "attributes": [
    {
      "id": "BRAND",
      "name": "Marca",
      "tags": {
        "required": true
      },
      "value_type": "string",
      "values": [
        {
          "id": "9344",
          "name": "Apple"
        }
      ]
    }
  ],
  "count": 1,
  "required": [
    "BRAND"
  ]
}

List my items

List your own listings with their title, price, stock and status, filtered by status or SKU. Gets one page of up to 100; run it again with 'next_offset' for the next.

Inputs

Statusstatustext
Only listings in this status. Leave empty for all.One of: active, paused, closed, under_review (Under review), inactive.
SKUseller_skutext
Only listings with this SKU (their SELLER_SKU attribute).
Seller custom fieldskutext
Only listings with this value in their older seller custom field (seller_custom_field).
Ordersorttext
How to sort them. Mercado Libre's default is ending soonest first.One of: start_time_desc (Newest listed first), start_time_asc (Oldest listed first), last_updated_desc (Most recently changed first), last_updated_asc (Least recently changed first), price_asc (Lowest price first), price_desc (Highest price first), available_quantity_asc (Least stock first), available_quantity_desc (Most stock first), stop_time_asc (Ending soonest first (Mercado Libre's default)), stop_time_desc (Ending latest first).
How manylimitnumber
How many to return, 1 to 100. Mercado Libre's default is 50.From 1 to 100.
Start atoffsetnumber
How many to skip, for the next page: use 'next_offset' from the page before. At most 1000.From 0 to 1000.

Outputs

countnumber
How many are on this page
item_idslist
Their ids
itemslist
The listings, in order
next_offsetnumber
The offset of the next page, or empty when there is none (or it would pass Mercado Libre's limit of 1000)
offsetnumber
Where this page starts
totalnumber
How many match in all
unreadablelist
Ids Mercado Libre listed but couldn't read back
Example output
{
  "count": 1,
  "item_ids": [
    "MLA1136716168"
  ],
  "items": [
    {
      "attributes": [
        {
          "id": "BRAND",
          "value_name": "Propia"
        }
      ],
      "available_quantity": 2,
      "base_price": 15000,
      "buying_mode": "buy_it_now",
      "category_id": "MLA109027",
      "condition": "new",
      "currency_id": "ARS",
      "date_created": "2022-05-10T21:55:46.000Z",
      "id": "MLA1136716168",
      "initial_quantity": 2,
      "last_updated": "2022-05-22T09:49:16.725Z",
      "listing_type_id": "gold_special",
      "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
      "pictures": [],
      "price": 15000,
      "seller_id": 202593498,
      "site_id": "MLA",
      "sold_quantity": 0,
      "status": "active",
      "sub_status": [],
      "tags": [
        "test_item"
      ],
      "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
      "title": "Zapatillas Avid Fof - Test Item",
      "variations": []
    }
  ],
  "next_offset": null,
  "offset": 0,
  "total": 1,
  "unreadable": []
}

Publish item

Publish a new listing in a category, with its price, stock, pictures, attributes and description. Use 'Suggest category' to find the category and 'List category attributes' to see which attributes it needs.

Inputs

TitletitletextRequired
Product, brand, model and key details, such as 'Notebook HP 14 4 GB 320 GB'. No condition or stock.
Category IDcategory_idtextRequired
The category, such as MLA1055. 'Suggest category' finds one from a product title.
PricepricenumberRequired
The price, in the category's currency.
Stockavailable_quantitynumberRequired
How many you have to sell.At least 0.
Listing typelisting_type_idtextRequired
How the listing is shown and what it costs, such as Clásica.
Conditionconditiontext
New, used or not specified. Defaults to new.One of: new, used, not_specified (Not specified). Default: new.
Buying modebuying_modetext
Defaults to buy it now.One of: buy_it_now (Buy it now), auction. Default: buy_it_now.
Currencycurrency_idtext
Such as ARS or BRL. Leave empty to use the category's own currency.
Picture linkspicture_urlslist
Links to up to 10 pictures, each starting with https://.
Attributesattributesobject
Attribute ids and values, such as BRAND: Acme and MODEL: X1. Most categories need some; 'List category attributes' names them.
Warranty typewarranty_typetext
Such as 'Garantía del vendedor'.
Warranty timewarranty_timetext
Such as '90 días'.
Descriptiondescriptiontext
Plain text shown on the listing. Line breaks are kept.

Outputs

description_settrue/false
Whether a description was added
itemobject
The new listing
Example output
{
  "description_set": true,
  "item": {
    "attributes": [
      {
        "id": "BRAND",
        "value_name": "Propia"
      }
    ],
    "available_quantity": 2,
    "base_price": 15000,
    "buying_mode": "buy_it_now",
    "category_id": "MLA109027",
    "condition": "new",
    "currency_id": "ARS",
    "date_created": "2022-05-10T21:55:46.000Z",
    "id": "MLA1136716168",
    "initial_quantity": 2,
    "last_updated": "2022-05-22T09:49:16.725Z",
    "listing_type_id": "gold_special",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
    "pictures": [],
    "price": 15000,
    "seller_id": 202593498,
    "site_id": "MLA",
    "sold_quantity": 0,
    "status": "active",
    "sub_status": [],
    "tags": [
      "test_item"
    ],
    "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
    "title": "Zapatillas Avid Fof - Test Item",
    "variations": []
  }
}

Search orders

Find your sales by status, date or a word (order number, item or buyer nickname). Gets one page of up to 50; run it again with 'next_offset' for the next.

Inputs

Statusstatuslist
Only orders in these statuses. Leave empty for all.One or more of: confirmed, payment_required (Payment required), payment_in_process (Payment in process), partially_paid (Partially paid), paid, cancelled, invalid.
Created aftercreated_fromdate and time
Only orders created at or after this time (to the hour).
Created beforecreated_todate and time
Only orders created at or before this time (to the hour).
Changed afterupdated_fromdate and time
Only orders last changed at or after this time.
Changed beforeupdated_todate and time
Only orders last changed at or before this time.
Search forquerytext
An order number, item id, item title or buyer nickname.
Ordersorttext
Newest or oldest first. Mercado Libre's default is oldest first.One of: date_desc (Newest first), date_asc (Oldest first (Mercado Libre's default)).
How manylimitnumber
How many to return, 1 to 50. Mercado Libre's default is 50.From 1 to 50.
Start atoffsetnumber
How many to skip, for the next page: use 'next_offset' from the page before. At most 1000.From 0 to 1000.

Outputs

countnumber
How many are on this page
next_offsetnumber
The offset of the next page, or empty when there is none (or it would pass Mercado Libre's limit of 1000)
offsetnumber
Where this page starts
orderslist
The orders
totalnumber
How many match in all
Example output
{
  "count": 1,
  "next_offset": null,
  "offset": 0,
  "orders": [
    {
      "buyer": {
        "id": 207040551,
        "nickname": "TETE5029382"
      },
      "currency_id": "ARS",
      "date_closed": "2026-01-05T10:31:00.000-03:00",
      "date_created": "2026-01-05T10:30:00.000-03:00",
      "date_last_updated": "2026-01-05T10:35:00.000Z",
      "id": 2000003508419013,
      "order_items": [
        {
          "item": {
            "id": "MLA1136716168",
            "title": "Zapatillas"
          },
          "quantity": 1
        }
      ],
      "pack_id": null,
      "paid_amount": 15000,
      "payments": [
        {
          "id": 1833868697,
          "status": "approved"
        }
      ],
      "seller": {
        "id": 202593498,
        "nickname": "TETE2870021"
      },
      "shipping": {
        "id": 40732312470
      },
      "status": "paid",
      "status_detail": null,
      "tags": [
        "paid"
      ],
      "total_amount": 15000
    }
  ],
  "total": 1
}

Search questions

Find questions buyers asked on your listings, by listing or status. Gets one page of up to 50.

Inputs

Itemitem_idtext
Only questions on this listing. Leave empty for all.
Statusstatustext
Only questions in this status, such as unanswered.One of: UNANSWERED, ANSWERED, CLOSED_UNANSWERED (Closed without an answer), UNDER_REVIEW (Under review), BANNED, DELETED, DISABLED.
Ordersorttext
Newest or oldest first.One of: DESC (Newest first), ASC (Oldest first).
How manylimitnumber
How many to return, 1 to 50. Mercado Libre's default is 50.From 1 to 50.
Start atoffsetnumber
How many to skip, for the next page: use 'next_offset' from the page before. At most 1000.From 0 to 1000.

Outputs

countnumber
How many are on this page
next_offsetnumber
The offset of the next page, or empty when there is none (or it would pass Mercado Libre's limit of 1000)
offsetnumber
Where this page starts
questionslist
The questions
totalnumber
How many match in all
Example output
{
  "count": 1,
  "next_offset": null,
  "offset": 0,
  "questions": [
    {
      "answer": null,
      "date_created": "2026-01-05T13:22:01.600-04:00",
      "deleted_from_listing": false,
      "from": {
        "id": 419067349
      },
      "hold": false,
      "id": 11436370259,
      "item_id": "MLA1136716168",
      "seller_id": 202593498,
      "status": "UNANSWERED",
      "text": "Hola, \u00bftienen talle 42?"
    }
  ],
  "total": 1
}

Send message to buyer

Send a message to an order's buyer in its post-sale conversation. Up to 350 characters; Mercado Libre blocks messages on cancelled orders.

Inputs

Order IDorder_idtextRequired
The sale's order number, such as 2000003508419013.
MessagetexttextRequired
What to send, up to 350 characters.

Outputs

buyer_idtext
Who it was sent to
messageobject
The message sent
pack_idtext
The conversation's pack
Example output
{
  "buyer_id": "207040551",
  "message": {
    "from": {
      "user_id": "202593498"
    },
    "id": "fd1d2e37ad004ede9e0bf25d1215002d",
    "message_attachments": [],
    "message_date": {
      "created": "2026-01-05T20:01:46.000Z",
      "read": null
    },
    "message_moderation": {
      "status": "clean"
    },
    "message_resources": [
      {
        "id": "2000003508419013",
        "name": "packs"
      }
    ],
    "site_id": "MLA",
    "status": "available",
    "text": "Hola, ya despachamos tu pedido.",
    "to": {
      "user_id": "207040551"
    }
  },
  "pack_id": "2000003508419013"
}

Set item description

Give a listing its description, replacing the one it has. Plain text only; line breaks are kept.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.
Descriptionplain_texttextRequired
The new description, as plain text.

Outputs

item_idtext
The listing
plain_texttext
The description now
replacedtrue/false
Whether it replaced an existing description
Example output
{
  "item_id": "MLA1136716168",
  "plain_text": "Zapatillas urbanas.",
  "replaced": false
}

Suggest category

Find the category to list a product in from its title, as Mercado Libre's own predictor does, with attributes it recognised.

Inputs

Product titlequerytextRequired
What you are selling, such as 'celular iphone 13'.
How manylimitnumber
How many to return, 1 to 8. Mercado Libre's default is 4.From 1 to 8.

Outputs

countnumber
How many were found
suggestionslist
The best matches first
Example output
{
  "count": 1,
  "suggestions": [
    {
      "attributes": [
        {
          "id": "BRAND",
          "value_id": "9344",
          "value_name": "Apple"
        }
      ],
      "category_id": "MLA1055",
      "category_name": "Celulares y Smartphones",
      "domain_id": "MLA-CELLPHONES",
      "domain_name": "Celulares"
    }
  ]
}

Update item

Change a listing's price, stock or title. Only the fields you fill in change. The title can change only before the first sale.

Inputs

Itemitem_idtextRequired
The listing, such as MLA1136716168. Pick one of yours, or use an id from an earlier step.
New pricepricenumber
Leave empty to keep the price.
New stockavailable_quantitynumber
Leave empty to keep the stock. 0 pauses the listing until stock is added.At least 0.
New titletitletext
Leave empty to keep the title.

Outputs

changedlist
The fields sent
itemobject
The listing, as it is now
Example output
{
  "changed": [
    "price"
  ],
  "item": {
    "attributes": [
      {
        "id": "BRAND",
        "value_name": "Propia"
      }
    ],
    "available_quantity": 2,
    "base_price": 15000,
    "buying_mode": "buy_it_now",
    "category_id": "MLA109027",
    "condition": "new",
    "currency_id": "ARS",
    "date_created": "2022-05-10T21:55:46.000Z",
    "id": "MLA1136716168",
    "initial_quantity": 2,
    "last_updated": "2022-05-22T09:49:16.725Z",
    "listing_type_id": "gold_special",
    "permalink": "https://articulo.mercadolibre.com.ar/MLA-1136716168-zapatillas-avid-fof-test-item-_JM",
    "pictures": [],
    "price": 15000,
    "seller_id": 202593498,
    "site_id": "MLA",
    "sold_quantity": 0,
    "status": "active",
    "sub_status": [],
    "tags": [
      "test_item"
    ],
    "thumbnail": "https://http2.mlstatic.com/D_963513-MLA49868862376_052022-I.jpg",
    "title": "Zapatillas Avid Fof - Test Item",
    "variations": []
  }
}

On this page