Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação do

Última atualização em 21/06/2023

List properties

Now that we have analyzed the main points, we believe that you are ready to make your first publication. This guide will help you list your first classified item in Mercado Libre using our API.

Note:
We add a new substatus for publications that exceed the quota package assigned to client and can happen during publication process. The listings will become “closed” with substatus "pack_quota_exceeded” same day of creation.


Basics

Real estate and classified items in general are the only kind of listing that allows users to display their contact information to the public, so when users are browsing properties to rent or buy and they have an interest on one of the properties you own, they can get in contact with you right away. So, you won’t sale or rent your property directly from our site, but you’ll expose it to every user that’s browsing the web for properties.


Listing results

Each item you list will appear in the listing results of a given search. For example, when a user search for the query “Casa en Mar del Plata”, as a result he will get a list of all items related. Your property can be on this list. When someone clicks on an item, the Item details page is displayed showing all the information about the item that was provided at the time of listing, keep reading to know more about it.


Real estate item fields

Let’s see a real estate item by API. This is easy since you only need to know the item_id associated to that item, and since it’s public you can get it from the item’s page. A item_id, you will find it at the top of the page. You just need to add the site_id before the number you see and that’s it. Now you can call the Items resource to get all the information you need:

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID

Example:

curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA839018613

Response:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.000Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "condition": "not_specified",
    "permalink": "https://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "secure_thumbnail": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "secure_url": "https://mla-s2-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "size": "500x438",
            "max_size": "548x481",
            "quality": ""
        }
    ],
    "video_id": "gqkEN9poKM;matterport",
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "methods": [],
        "tags": [],
        "dimensions": null,
        "local_pick_up": false,
        "free_shipping": false,
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        },
        "latitude": -34.556595,
        "longitude": -58.48787,
        "id": 1087750186
    },
    "seller_contact": {
        "contact": "",
        "other_info": "",
        "country_code": "",
        "area_code": "",
        "phone": "",
        "country_code2": "",
        "area_code2": "",
        "phone2": "",
        "email": "",
        "webpage": ""
    },
    "location": {
        "address_line": "My property address NEW 111",
        "zip_code": "5000",
        "neighborhood": {
            "id": "TUxBQlBBTDI1MTVa",
            "name": "Palermo"
        },
        "city": {
            "id": "TUxBQ0NBUGZlZG1sYQ",
            "name": "Capital Federal"
        },
        "state": {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5780655,
        "longitude": -58.4265317
    },
    "geolocation": {
        "latitude": -34.5780655,
        "longitude": -58.4265317
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.000Z",
    "last_updated": "2020-02-13T19:49:09.226Z",
    "health": null,
    "catalog_listing": false
}

xThere’s a lot of information in the Json response. Below you’ll find some important guidelines.


Defining attributes

You must know some of the fields are mandatory when you create a JSON for your item, while some others can be skipped or will be automatically added by us. They will define how the item is displayed and the position on search results. Next, we mention the most important fields that you should send. Remember that, in addition to them, the complementary fields (attributes) must also be sent in the attribute array. For more information, you can read the categories and attributes guide.

Nota:
- When making the POST you must specify the channel to which you are publishing, send marketplace to avoid error when publishing a classified item. you can see the field in the example of the post.

- We have added a new attribute inscription_number, you must indicate it only if the temporary rental is in the Autonomous City of Buenos Aires.

-From July 17 the fields Common expenses, Pets, Parking, Storage, Bathrooms and Furnished will be mandatory and must be sent when creating the publication.


Title

Important:
As of June 15, Mercado Libre Chile will have a maximum of 60 characters allowed to publish a property and there will no longer be 200.

Avoid adjectives and abbreviations. The correct title must contain the operation type (lease/sale/temporary lease) + property type + rooms + neighborhood. The title words are very important, since they are the ones matching the search word of the user, so the higher the match is, the publication will appear in first places. Example: Apartment Sale 4 rooms Recoleta.


Description

Note:
To create the description, you must first create the publication without a description and then submit the description via a POST to /items/$ITEM_ID/description resource.

A detailed description will improve your chances to rent or buy your property and will save you time from answering unnecessary question. If you are interested in increasing your knowledge about this topic, check our item description guide.

Note:
The product description must be in plain text. Nor send contact information, such as phone, address and place in this field. In case it is sent, we will accept the publication, but it will be penalized or moderate and will have a poor classification in the searches. For moderated posts see Manage moderations.


Location

When publishing a classified ad, sending your location is mandatory. The location of Mercado Libre has 4 levels: country, state, city and neighborhood. You must send at least city or neighborhood. Example:

location: {
    address_line: "Avenida Jurucê, 436",
    zip_code: "04080011",
    neighborhood: {
      id: "TUxCQklORHduMDB0"
    },
    "city": {
      "id": "TUxCQ1NQLTkxMjE",
    },
    "state": {
    "id": "TUxCUFNBT085N2E4",
    },
    "country": {
    "id": "BR",
    },
  },

Always remember to send the id of each location sent, according to the example above. For the “address_line” field, always send the street followed by the number (the street number must always be the last information sent in this field. Correct example: Avenida Jurucê, 436 Incorrect example: Avenida Jurucê, 436 Moema


For information, learn how to check location codes of Mercado Libre.


Seller’s contacts

They are contact data of the seller who owns the ad. These values are optional, and, if they are not notified, Mercado Libre will use the seller’s account data. Example:

  seller_contact: {
    contact: "Nome Contato Teste",
    area_code: "11",
    phone: "4444-5555",
    area_code2: "21",
    phone2: "1111-3333",
    email: "contact-email@somedomain.com",
  },
Note:
In case of questions on ads by purchasers, Mercado Libre sends them to the seller’s e-mail (specified in the seller_contact.email field). In case it is not informed, Mercado Libre will use the seller’s account e-mail in the site. To manage API questions use our guide Manage questions and answers.
In case of "seller_contact": "not_allowed" field, the category not allow load information about that.
The country_code2, area_code2, phone2 fields can be used by the seller to receive contacts through WhatsApp.


Pictures

Good pictures can make your property more appealing and give other users a better idea of how it looks like. It is necessary to check by category the amount of images that you can publish, by max_pictures_per_item and max_pictures_per_item_var fields. This is a mandatory attribute according to the group by property type.

{
 ....
 "pictures":[
  {"source":"http://yourServer/path/to/your/picture.jpg"},
  {"source":"http://yourServer/path/to/your/otherPicture.gif"},
  {"source":"http://yourServer/path/to/your/anotherPicture.png"}
 ]
 ...
}

We highly recommend not to use slow servers to host your pictures since this can lead to disadvantages when listing. You can also add or change pictures to your item later on, please read more about this topic to know which kind of pictures are allowed and how to work with them on our Working with pictures guide.

The minimum amount of images has an impact on the quality of a publication and these amounts are different between the 3 groups of property types:

  • Grup 1: Houses / Apartments / Offices / Plots (12 pictures).
  • Grup 2: Premises / Agricultural / Sites / Lands / Warehouses / Lots (6 pictures).
  • Grup 3: Parking lots (4 photos).

Category & attributes

Sellers must define a category in MercadoLibre site. This attribute is mandatory and only accepts pre-established ids. Each category has it’s own attributes for you to work with. To get the details see our Categories and Attributes guide.

{
 ....
  "category_id":"MLA12683",
 ...
}

Price

The price is mandatory and must be in the publication.


Currency

This attribute is mandatory. You must define it using a preset ID. You will find available currency IDs by calling the category where you want to publish your article. Learn how to do it with our Location and Currencies guide.


Common Expense

The MAINTENANCE_FEE attribute is mandatory. You must include the monetary value of the monthly common expense in the corresponding currency of the country (each currency has a preset ID).


Pets

The IS_SUITABLE_FOR_PETS attribute is mandatory and must be sent. The values defined for this attribute where it must be defined if pets are accepted are Yes and No together with the preset ID.


Parking

The PARKING_LOTS attribute is a mandatory numeric value. In this attribute the number of parking spaces available must be defined.


Warehouses

The WAREHOUSES attribute is a mandatory numeric value. This attribute refers to the number of spaces counted as a warehouse.


Bathrooms

The FULL_BATHROOMS attribute is a mandatory numeric value. This attribute refers to the number of full bathrooms in the property.


Furnished

The FURNISHED attribute is mandatory. It refers to whether the property is furnished, and the values defined for this attribute are Yes and No as appropriate along with the corresponding ID.

Listing Type

It is the plan contracted by the client. This is another case of a mandatory attribute that only accepts pre-defined values and is very important for you to understand about it. There are different listing types available for each site. You should make a mixed call through sites and listing_types resources to know which listing_types are supported. Follow our guide to know which listing type will suite your property best.


Available_quantity

Must be sent 1. Represents the quantity of items in the ad. In Mercado Libre, Classified publications do not work with stock, each representing a single property, vehicle or service registry.


Condition

It can be "new" or "used", depending on the condition of the publication.


List a real estate property

You’re ready to list your first classified item. Notice you’ll need an access_token to make it. If you have questions regarding how to get your access token, please go back to the Authentication and Authorization tutorial. In addition, we highly recommended you validate the JSON you’re sending before making a POST, so you better check out this really easy and quick item validation tutorial. You can create a JSON for your item basing on the following example, or just send it and you’ll be listing a sample product on the site:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d {
"title": "Property title",
"category_id": "MLA401686",
"price": 100000,
"currency_id": "ARS",
"available_quantity": 1,
"buying_mode": "classified",
"listing_type_id": "silver",
"condition": "not_specified",
"channels": 
[
"marketplace" 
], 
"pictures": [
{
"source":"http://mla-d2-p.mlstatic.com/item-de-test-no-ofertar-543605-MLA25041518406_092016-O.jpg?square=false"
}
],
"seller_contact": {
"contact": "Contact name",
"other_info": "Additional contact info",
"area_code": "011",
"phone": "4444-5555",
"area_code2": "",
"phone2": "",
"email": "contact-email@somedomain.com",
"webmail": ""
},
"location": {
"address_line": "My property address 1234",
"zip_code": "01234567",
"neighborhood": {
"id": "TUxBQlBBUzgyNjBa"
},
"latitude": -34.48755,
"longitude": -58.56987
},
"attributes": [
{
"id": "ROOMS",
"value_name": "2"
},
{
"id": "FULL_BATHROOMS",
"value_name": "1"
},
{
"id": "PARKING_LOTS",
"value_name": "1"
},
{
"id": "BEDROOMS",
"value_name": "4"
},
{
"id": "COVERED_AREA",
"value_name": "30 m²"
},
{
"id": "TOTAL_AREA",
"value_name": "40 m²"
}
],
"video_id": "gqkEN9poKM;matterport",
"description": {plain_text: "This is the real estate property description. \n"},
}
https://api.mercadolibre.com/items

Response:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.499Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address 1234",
        "zip_code": "01234567",
        "neighborhood": {
            "id": "TUxBQlBBUzgyNjBa",
            "name": "Paso del Rey"
        },
        "city": {
            "id": "TUxBQ01PUmViMTE3",
            "name": "Moreno"
        },
        "state": {
            "id": "TUxBUEdSQWVmNTVm",
            "name": "Bs.as. G.b.a. Oeste"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.48755,
        "longitude": -58.56987,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.48755,
        "longitude": -58.56987
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.823Z",
    "last_updated": "2020-02-13T19:29:01.823Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}
Note:
For Mercado Libre México, real estate items published from the Mercado Libre API will be automatically displayed on the metroscubicos.com site.

Video, 360 video and virtual tour

To publish a video, 360 video or a virtual tour of a property you must use the video_id field in the publication, which has the string corresponding to the id of the multimedia resource and an identifier of the provider or platform related to the resource. Like this: video_id="; " will support these 2 types of multimedia resources:


Youtube (only video), for example: “video_id”:“gqkEN9poKM;youtube”.

Matterport (only virtual tour), for example: “video_id”:“gqkEN9poKM;matterport”.

It is only possible to report one type of multimedia content, that is, you must send the link of the YouTube video or a Matterport url.

Note:
This functionality is available for all sites, except properties published in:
Mercado Livre Brasil: from the Real Estate Projects category.
Mercado Libre Venezuela: Tu inmueble.
Mercado Libre México: Metros Cúbicos.


Modify the location of your property

To make changes in the publication, a PUT must be sent with the new fields to be edited. In the example below, a new location is sent:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -d '{
  "location": {
    "address_line": "My property address NEW 111",
    "zip_code": "5000",
    "neighborhood":{
               "id":"TUxBQlBBTDI1MTVa",
               "name":"Palermo"
    },
    "city":{
              "id":"TUxBQ0NBUGZlZG1sYQ",
              "name":"Capital Federal"
    }
  }
}

}' https://api.mercadolibre.com/items/{item_id}

Response:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": null,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.000Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "secure_url": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-O.jpg",
            "size": "500x438",
            "max_size": "548x481",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address NEW 111",
        "zip_code": "5000",
        "neighborhood": {
            "id": "TUxBQlBBTDI1MTVa",
            "name": "Palermo"
        },
        "city": {
            "id": "TUxBQ0NBUGZlZG1sYQ",
            "name": "Capital Federal"
        },
        "state": {
            "id": "TUxBUENBUGw3M2E1",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.6315538,
        "longitude": -58.7404704,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.6315538,
        "longitude": -58.7404704
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "unit": "m²",
                "number": 30
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "unit": "m²",
                        "number": 30
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "unit": "m²",
                "number": 40
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "unit": "m²",
                        "number": 40
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "secure_thumbnail": "https://mla-s1-p.mlstatic.com/910707-MLA40763776324_022020-I.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": "MLA-INDIVIDUAL_APARTMENTS_FOR_SALE",
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.000Z",
    "last_updated": "2020-02-13T19:48:23.890Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Official Stores for Vehicles and Real Estate

The official_store_id field is required for all listings of those users that have an Official Store associated.
If the seller does not have an associated Official Store, you can send the official_store_id field as null.
But it has an Official Store and not say will get an error:

{"message"=>"Validation error", "error"=>"validation_error", "status"=>400, "cause"=>[{"department"=>"items", "cause_id"=>144, "type"=>"error", "code"=>"item.official_store_id.invalid", "references"=>["item.official_store_id", "item.seller_id"], "message"=>"Users type brand have to provide a official store id"}]}

The objective of this field is to associate the item with the Official Store corresponding to the ID. Check the following Official Stores documentation to learn more.


How to know if your seller has an Official Store

If the seller has an Official Store, you can get the ID and more details of the brand.


How to add the official_store_id

When list the item (POST), you must add the store ID in the official_store_id field. In case of update (PUT), you should add the official_store_id field only if it is required to update this explicitly.


Learn more how list an item

Publicar un artículo en una Tienda Oficial es lo mismo que publicar cualquier otro artículo, salvo que también debes agregar el atributo official_store_id en el JSON.

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
  "title":"Item de Test -No Ofertar",
  "category_id":"MLA401686",
  "price":137000,
  "official_store_id": 3121,
  "currency_id":"USD",
  "available_quantity":1,
  "buying_mode":"classified",
  "listing_type_id":"silver",
  "condition":"new",
  "description": "Item:, Depto 2 Amb Semipiso Con Balcón Terraza Al Frente!",
  "video_id": "YOUTUBE_ID_HERE",
  "pictures":[
    {"source":"http://upload.wikimedia.org/wikipedia/commons/f/fd/ap.jpg"},
    {"source":"http://en.wikipedia.org/wiki/File:Teashades.gif"}
  ]
}'
 
https://api.mercadolibre.com/items

Response:

{
    "id": "MLA839018613",
    "site_id": "MLA",
    "title": "Property Title",
    "subtitle": null,
    "seller_id": 526655030,
    "category_id": "MLA401686",
    "official_store_id": 3121,
    "price": 100000,
    "base_price": 100000,
    "original_price": null,
    "inventory_id": null,
    "currency_id": "ARS",
    "initial_quantity": 1,
    "available_quantity": 1,
    "sold_quantity": 0,
    "sale_terms": [],
    "buying_mode": "classified",
    "listing_type_id": "silver",
    "start_time": "2020-02-13T19:29:01.499Z",
    "stop_time": "2020-05-14T04:00:00.000Z",
    "end_time": "2020-05-14T04:00:00.000Z",
    "expiration_time": null,
    "condition": "not_specified",
    "permalink": "http://departamento.mercadolibre.com.ar/MLA-839018613-property-title-_JM",
    "pictures": [
        {
            "id": "910707-MLA40763776324_022020",
            "url": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "secure_url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
            "size": "500x500",
            "max_size": "500x500",
            "quality": ""
        }
    ],
    "video_id": null,
    "descriptions": [
        {
            "id": "MLA839018613-2516619253"
        }
    ],
    "accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
    "shipping": {
        "mode": "not_specified",
        "local_pick_up": false,
        "free_shipping": false,
        "methods": [],
        "dimensions": null,
        "tags": [],
        "logistic_type": null,
        "store_pick_up": false
    },
    "international_delivery_mode": "none",
    "seller_address": {
        "id": 1087750186,
        "comment": "Referencia: The Testing Cavern",
        "address_line": "Testing Street 1450",
        "zip_code": "1430",
        "city": {
            "id": "TUxBQlNBQTM3Mzda",
            "name": "Saavedra"
        },
        "state": {
            "id": "AR-C",
            "name": "Capital Federal"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.5545188,
        "longitude": -58.4915986,
        "search_location": {
            "neighborhood": {
                "id": "TUxBQlNBQTM3Mzda",
                "name": "Saavedra"
            },
            "city": {
                "id": "TUxBQ0NBUGZlZG1sYQ",
                "name": "Capital Federal"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            }
        }
    },
    "seller_contact": {
        "contact": "Contact name",
        "other_info": "Additional contact info",
        "area_code": "011",
        "phone": "4444-5555",
        "area_code2": "",
        "phone2": "",
        "email": "contact-email@somedomain.com",
        "webpage": "",
        "country_code": "",
        "country_code2": ""
    },
    "location": {
        "address_line": "My property address 1234",
        "zip_code": "01234567",
        "neighborhood": {
            "id": "TUxBQlBBUzgyNjBa",
            "name": "Paso del Rey"
        },
        "city": {
            "id": "TUxBQ01PUmViMTE3",
            "name": "Moreno"
        },
        "state": {
            "id": "TUxBUEdSQWVmNTVm",
            "name": "Bs.as. G.b.a. Oeste"
        },
        "country": {
            "id": "AR",
            "name": "Argentina"
        },
        "latitude": -34.48755,
        "longitude": -58.56987,
        "open_hours": ""
    },
    "geolocation": {
        "latitude": -34.48755,
        "longitude": -58.56987
    },
    "coverage_areas": [],
    "attributes": [
        {
            "id": "ROOMS",
            "name": "Ambientes",
            "value_id": null,
            "value_name": "2",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "2",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "FULL_BATHROOMS",
            "name": "Baños",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PARKING_LOTS",
            "name": "Cocheras",
            "value_id": null,
            "value_name": "1",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "1",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "BEDROOMS",
            "name": "Dormitorios",
            "value_id": null,
            "value_name": "4",
            "value_struct": null,
            "values": [
                {
                    "id": null,
                    "name": "4",
                    "struct": null
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "COVERED_AREA",
            "name": "Superficie cubierta",
            "value_id": null,
            "value_name": "30 m²",
            "value_struct": {
                "number": 30,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "30 m²",
                    "struct": {
                        "number": 30,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "TOTAL_AREA",
            "name": "Superficie total",
            "value_id": null,
            "value_name": "40 m²",
            "value_struct": {
                "number": 40,
                "unit": "m²"
            },
            "values": [
                {
                    "id": null,
                    "name": "40 m²",
                    "struct": {
                        "number": 40,
                        "unit": "m²"
                    }
                }
            ],
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
        },
        {
            "id": "PROPERTY_TYPE",
            "name": "Inmueble",
            "value_id": "242062",
            "value_name": "Departamento",
            "value_struct": null,
            "values": [
                {
                    "id": "242062",
                    "name": "Departamento",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION",
            "name": "Operación",
            "value_id": "242075",
            "value_name": "Venta",
            "value_struct": null,
            "values": [
                {
                    "id": "242075",
                    "name": "Venta",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        },
        {
            "id": "OPERATION_SUBTYPE",
            "name": "Subtipo de operación",
            "value_id": "244562",
            "value_name": "Propiedad individual",
            "value_struct": null,
            "values": [
                {
                    "id": "244562",
                    "name": "Propiedad individual",
                    "struct": null
                }
            ],
            "attribute_group_id": "MAIN",
            "attribute_group_name": "Principales"
        }
    ],
    "warnings": [],
    "listing_source": "",
    "variations": [],
    "thumbnail": "http://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "secure_thumbnail": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/I-ES.jpg",
    "status": "active",
    "sub_status": [],
    "tags": [
        "test_item"
    ],
    "warranty": null,
    "catalog_product_id": null,
    "domain_id": null,
    "seller_custom_field": null,
    "parent_item_id": null,
    "differential_pricing": null,
    "deal_ids": [],
    "automatic_relist": false,
    "date_created": "2020-02-13T19:29:01.823Z",
    "last_updated": "2020-02-13T19:29:01.823Z",
    "health": null,
    "catalog_listing": false,
    "item_relations": []
}

Know the common mistakes when list in Official Stores

Below, you can see the error 400 received by those users associated with Official Stores that do not send the attribute.
If you don´t send the official_store_id of the item for an Official Multibrand Store, you will receive in response the possible IDs that you could send with your user:

"message": "Validation error",
   "error": "validation_error",
   "status": 400,
   "cause": [{
    "code": "item.official_store_id.invalid",
    "message": "Users type brand have to provide a official store id"

If you send an invalid official_store_id for an Official multi-brand Store, you will receive:

{
   "message": "body.invalid_official_store_id",
   "error": "The seller 148829068 is not allowed to use official_store_id 315 on site MLA.",
   "status": 403,
   "cause": []
}

Next: Sync and moditify listings.