Mercado Livre tools
The 14 Mercado Livre operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- Get current userGETReturns the connected seller account: id, nickname, email, site_id and seller reputation. The id is the user_id, seller and seller_id of the other tools, and site_id (MLB in Brazil) goes in Search categories.
- Search itemsGETLists the ids of the listings of the seller, 50 per page by default. results has only item ids: List items returns their details. Page with offset and limit; past 1000 results use search_type scan and the scroll_id of each response.
- List itemsGETReturns up to 20 listings by id in one call: title, price, available_quantity, sold_quantity, status, permalink, pictures and attributes. Each element has status_code, id and the listing in body.
- Search categoriesGETPredicts the category of a product from its title, with the domain and the attributes recognized in the text. The first result is the most likely. Its category_id goes in Create item and in List category attributes.
- List category attributesGETLists the attributes of a category with their id, value_type, accepted values and tags. Attributes tagged required must be sent in Create item, and new_required ones when the item is new.
- Create itemPOSTPublishes a listing and returns it with its id. Under the User Products model, active for every seller, send family_name and no title: Mercado Livre builds the title. The description is added afterwards with Create item description.
- Update itemPUTChanges a listing and returns it. Only the fields sent change. status paused hides it, active brings it back and closed ends it for good. title and family_name only change while the listing has no sales.
- Get item descriptionGETReturns the description of a listing in plain_text, with date_created and last_updated.
- Create item descriptionPOSTAdds the description to a listing that has none, such as one just made with Create item. Fails with 400 when a description already exists: use Update item description.
- Update item descriptionPUTReplaces the description of a listing that already has one.
- Search ordersGETLists the sales of the seller from the last 12 months, with buyer, items, payments and shipping id. sort date_desc brings the newest first. Page with offset and limit; paging.total has the count.
- Get orderGETReturns a sale: status, items, quantities, prices, payments, buyer, tags and the shipping id.
- Search questionsGETLists the questions buyers asked on the listings of the seller, or on one listing, with the answer when there is one. Unanswered questions older than 7 months are deleted. Page with offset and limit.
- Answer questionPOSTPublishes the answer of the seller to a buyer question and returns the question with the answer. The answer is public on the listing.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
