Classifieds

Classified location selection & search tutorial

To list a real state item, you will have to determine the property location, which includes state, city and in most cases neighborhood as well. To accomplish this, it’s better if you get familiar with the Classified Locations API. Location selection You only need to send the leaf location ID when publishing a property. This […]

Continue Reading

Listing types and item upgrades tutorial

You can list items under a few different listing types, according to the level of exposition to users you want to get. Each listing type has it’s own characteristics and feeds. Listings types by site First of all, to see all available listing types on a site, you should make a GET to listing_types resources […]

Continue Reading

Visits API tutorial

This API retrieves information about visits on MercadoLibre items VIPs (View Product Page). You can query data by time windows and sites. Remember that relistings inherit the item historic visits of it’s parent_item, no matter how many times they are relisted. Parameter description Total visits by user Retrieves the total visits on every item of […]

Continue Reading

Addresses API

The Addresses API resource retrieves the addresses associated to an user. To make a call to this API you’ll need an access token. curl -X GET “Content-Type: application/json” -d https://api.mercadolibre.com/users/{User_id}/addresses?access_token=$ACCESS_TOKEN RESPONSE { “id”: 145834937, “user_id”: “160252486”, “contact”: null, “phone”: null, “address_line”: “Guatemala 5100”, “floor”: null, “apartment”: null, “street_number”: “5100”, “street_name”: “Guatemala”, “zip_code”: “1000”, “city”: -{ “id”: […]

Continue Reading

Classified contacts API tutorial

This is a read only API, very useful to take metrics of your classified items. You can query data about questions, and keep a record of how many times the ‘See phone’ option was clicked on. You can query by user, item, dates and time windows. Parameters description    Total questions You can get the […]

Continue Reading

User Promotion Packs API

Promotions Packs are listing packages for Car Dealers and Real State Agency Classifieds listings. In this tutorial you’ll learn how to get information about packages and also engage and activate a package. Obtain packages by category The possible values for classifieds_promotion_packs categories are different each site. Possible values are: {site_id}1743: Car Dealer. {site_id}1459: Real Estate […]

Continue Reading

Real estate listing

Overview Posting a real estate classified is a special case of listing an item. Make sure you go over the First Steps for developing with our API and that you have created your App. Then, go through the Authentication section to get an access_token and through the first steps of Listing items. Table of Contents […]

Continue Reading

Operation and property type selection

To list a real estate property, you will have to choose the operation and property type for the property. In MELI this is known as category_id. First, determine the SITE_ID that corresponds to the country your user belongs to. To accomplish this go to the following URL: https://api.mercadolibre.com/sites Once there you will be able to […]

Continue Reading

Real Estate JSON

Full Specification A real estate property JSON is composed by the following information: *Mandatory fields JSON example: { “site_id”: “MLA”, “title”: “Property title”, “category_id”: “MLA52745”, “price”: 500, “currency_id”: “ARS”, “available_quantity”: 1, “buying_mode”: “classified”, “listing_type_id”: “silver”, “condition”: “not_specified”, “pictures”: [ { “id”: “MLA2096545948_102011” }, { “source”:”http://farm3.staticflickr.com/2417/2176897085_946b7b66b8_b.jpg” }, { “source”:”http://farm2.staticflickr.com/1056/628680053_3b7c315548_b.jpg” } ], “seller_contact”: { “contact”: “Contact name”, […]

Continue Reading

Modify, pause or finalize your property publication

You can use our Items API to visualize the details of a property, by accessing the following URL (by browser or by sending a GET request): https://api.mercadolibre.com/items/ITEM_ID Example: https://api.mercadolibre.com/items/MLA12345678 Modify your property Using our Items API you will be able to modify the same elements that you are currently able to modify when browsing our […]

Continue Reading

Pictures upload

Pictures are optional when listing, but they make a big difference in the publication quality and results (visits and contacts), specially when talking about real estate properties. If you already have your pictures uploadad to an accesible web URL, you can then skip this picture uploading step and send these URLs directly as seen in […]

Continue Reading

Relist your items

All listings have an expiration date on MercadoLibre. This expiration date is usually up to two months from the activation date. Once an item has reached its expiration date, it will be automatically finalized and will no longer be visible to other users. When this occurs, you may choose to relist your item to make […]

Continue Reading

Validate your Real Estate JSON

If you want you can validate your JSON before actually listing it by sending it in a POST request body to the following URL: https://api.mercadolibre.com/items/validate?access_token=YOUR_ACCESS_TOKEN If the response status code is 200 OK or 204 No content, then the JSON was successfully validated and your property is ready to be listed. This validation process is […]

Continue Reading

Adding description

An item description is a large HTML which contains detailed information about the item you are selling. E.g.: specifications, descriptions, images, everything you find useful for buyers. The description will appear on the item’s VIP. See List an item for adding a description and pictures at the moment of listing. To add or replace current […]

Continue Reading