Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Publica inmuebles
Consultar inmuebles
Solo debes conocer el item_id asociado a la publicación y, como es público, puedes obtenerlo desde la página de la publicación. El item_id, lo encontrarás en la parte superior de la página. Debes agregar el site_id antes del número que ves y listo. Ahora puedes llamar al recurso Artículos para obtener toda la información que necesites:
Llamada:
curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_IDEjemplo:
curl - X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLA839018613
Respuesta:
{
"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
}
Atributos
A continuación mencionamos los campos más importantes que deben enviarse. Recuerde que, además de ellos, también deben enviarse los campos complementarios (atributos) en el array de atributos. Para obtener más información, puedes leer la guía de categorías y atributos.
Título
Evitar adjetivos y abreviaciones. El título correcto debe tener tipo de operación ( alquiler/venta/alquiler temporario ) + tipo de propiedad + ambientes + barrio. Las palabras del titulo son muy importantes ya que son las que coinciden con la palabra de búsqueda del usuario entonces cuanto mayor esta coincidencia más arriba aparece la publicación.
Ejemplo: Venta Departamento 4 ambientes Recoleta
Descripción
Conoce cómo agregar la descripción al ítem publicado.
Conoce cómo consultar una descripción mediante un GET al recurso /items/$ITEM_ID/description.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/descriptionEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'https://api.mercadolibre.com/items/MLC614111912/descriptionRespuesta:
{
"text": "",
"plain_text": "Excelente casa, con ubicación nororiente. Texto TEST.
"date_created": "2021-05-19T19:56:12.000Z",
"snapshot": {}
}
Ubicación
Al publicar un anuncio clasificado, es obligatorio que envíes tu ubicación. La ubicación de Mercado Libre posee 4 niveles: country, state, city y neighborhood. Debes enviar, como mínimo, city o neighborhood. Ejemplo:
location: {
address_line: "Avenida Jurucê, 436",
zip_code: "04080011",
neighborhood: {
id: "TUxCQklORHduMDB0"
},
"city": {
"id": "TUxCQ1NQLTkxMjE",
},
"state": {
"id": "TUxCUFNBT085N2E4",
},
"country": {
"id": "BR",
},
},Siempre recuerda enviar la id de cada ubicación enviada, según el ejemplo precedente. Para el campo “address_line”, siempre envía la calle seguida del número (el número de la calle siempre debe ser la última información enviada en este campo.
Ejemplo correcto: Avenida Jurucê, 436
Ejemplo incorrecto: Avenida Jurucê, 436 Moema.
Para saber cómo consultar los códigos de ubicaciones de Mercado Libre, visita Localiza inmuebles.
Contactos del vendedor
Son los datos de contacto del vendedor propietario del anuncio. Estos valores son opcionales y, si no se los informa, Mercado Libre utilizará los datos de la cuenta del vendedor. Ejemplo:
seller_contact: {
contact: "Nome Contato Teste",
area_code: "11",
phone: "4444-5555",
area_code2: "21",
phone2: "1111-3333",
email: "contact-email@somedomain.com",
},
Imágenes
Las buenas imágenes pueden hacer que tu propiedad sea más atractiva y ofrecer a los usuarios una idea más certera de cómo es. Es necesario consultar por la categoría la cantidad de imágenes que si puede publicar, por los campos max_pictures_per_item y max_pictures_per_item_var. Este es un atributo obligatorio de acuerdo al grupo por tipo de propiedad.
{
....
"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"}
]
...
}Te recomendamos no utilizar servidores lentos para alojar tus imágenes porque pueden generar desventajas al momento de publicar. También puedes agregar o cambiar las imágenes de tu artículo más tarde. Por favor, lee más sobre este tema en nuestra guía Trabajar con imágenes para conocer qué tipo de imágenes se permiten y cómo trabajar con ellas.
La cantidad de imágenes mínima tiene impacto sobre la calidad de una publicación y estas cantidades son distintas entre los 3 grupos de tipos de propiedad:
- Grupo 1: Casas/ Departamentos/ Oficinas/ Parcelas (12 fotos).
- Grupo 2: Locales/ Agrícolas/ sitios/Terrenos/ Bodegas/ Loteos (6 fotos).
- Grupo 3: Estacionamientos (4 fotos).
Categoría y atributos
Los vendedores deben definir una categoría ( ej: “Venta” y “Alquiler”) en el site de Mercado Libre. Este atributo es obligatorio y solo acepta ID preestablecidos. Cada categoría tiene sus propios atributos para trabajar. Para conocer los detalles, consulta nuestra guía Categorías y Atributos.
{
....
"category_id":"MLA12683",
...
}Precio
El precio es obligatorio y deberá estar en la publicación.
Moneda
Este atributo es obligatorio. Debes definirlo utilizando un ID preestablecido. Encontrarás ID de monedas disponibles llamando a la categoría donde deseas publicar tu artículo. Conoce cómo hacerlo con nuestra guía nuestra guía Categorías.
Gasto Común
El atributo MAINTENANCE_FEE es obligatorio. Debes incluir el valor monetario del gasto común mensual en la moneda correspondiente del país (cada moneda tiene un ID preestablecido).
Mascotas
El atributo IS_SUITABLE_FOR_PETS es obligatorio y deberá ser enviado. Los valores definidos para este atributo donde se debe definir si se aceptan mascotas son Sí y No junto con el ID preestablecido.
Estacionamiento
El atributo PARKING_LOTS es un valor numérico obligatorio. En este atributo se deben definir el número de espacios de estacionamiento con los que se cuenta.
Bodega
El atributo WAREHOUSES es un valor numérico obligatorio. Este atributo se refiere al número de espacios con los que se cuentan como bodega.
Baños
El atributo FULL_BATHROOMS es un valor numérico obligatorio. Este atributo hace referencia a la cantidad de baños completos con los que se cuenta en la propiedad.
Amoblado
El atributo FURNISHED es obligatorio. Hace referencia si la propiedad se encuentra amueblada, y los valores definidos para este atributo son Sí y No según corresponda junto con el ID correspondiente.
Listing Type
Básicamente, se trata del plan contratado. Es otro caso de un atributo obligatorio que solo acepta valores predefinidos y es muy importante que lo entiendas. Existen diferentes "Listing Type" disponibles para cada site. Debes realizar una llamada mixta a través de los sites y recursos listing_types para conocer los listing_types soportados. Sigue nuestra guía para saber que tipo de publicación te convendrá más para tu propiedad.
Available_quantity
Se debe enviar siempre "1". Representa la cantidad de items de la publicación. En Mercado Libre, las publicaciones de clasificados no trabajan con stock, cada una representa un registro de inmueble, vehículo o servicio único.
Condition
Puede ser “new”, “used” o "not_specified", dependiendo de la condición de la publicación.
Publica un inmueble
Estás listo para publicar tu primer artículo inmueble. Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor regresa al tutorial Autenticación y Autorización. Además, te recomendamos validar el JSON que envías antes de realizar la solicitud POST; por eso, será mejor que consultes este tutorial de validación de artículos. Puedes crear un JSON para tu inmueble en base al ejemplo a continuación o simplemente envíalo y estarás publicando un producto de muestra en el site.
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "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/itemsRespuesta:
{
"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": []
}
Items penalizados
Items penalizados necesitan de la atención del vendedor para que vuelvan a tener una buena exposición o, en casos graves, no sean pausados. Para identificar estos ítems para los dominios de Vehículos e Inmuebles, disponibilizamos 2 tags con los siguientes motivos de penalización: .
- misplaced_personal_data: item penalizado por datos personales en campos no indicados.
- moderation_penalty : Ítem penalizado. En este caso, por ser un tag genérico, es necesario hacer una consultaal recurso /infractions para conocer el motivo.
Para listar los ítems en esta condición, es posible utilizar el GET:
Llamada:
curl --location --request GET 'https://api.mercadolibre.com/users/$USER_ID/items/search?tags=$TAG' \
--header 'Authorization: Bearer $ACCESS_TOKEN'Ejemplo:
curl --location --request GET 'https://api.mercadolibre.com/users/705332753/items/search?tags=misplaced_personal_data' \
--header 'Authorization: Bearer $ACCESS_TOKEN'Respuesta:
{
"seller_id": "705332753",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 1
},
"results": [
"MLB1790900231"
],
"orders": [
{
"id": "stop_time_asc",
"name": "Order by stop time ascending"
}
],
"available_orders": [
{
"id": "stop_time_asc",
"name": "Order by stop time ascending"
},
{
"id": "stop_time_desc",
"name": "Order by stop time descending"
},
{
"id": "start_time_asc",
"name": "Order by start time ascending"
},
{
"id": "start_time_desc",
"name": "Order by start time descending"
},
{
"id": "available_quantity_asc",
"name": "Order by available quantity ascending"
},
{
"id": "available_quantity_desc",
"name": "Order by available quantity descending"
},
{
"id": "sold_quantity_asc",
"name": "Order by sold quantity ascending"
},
{
"id": "sold_quantity_desc",
"name": "Order by sold quantity descending"
},
{
"id": "price_asc",
"name": "Order by price ascending"
},
{
"id": "price_desc",
"name": "Order by price descending"
},
{
"id": "last_updated_desc",
"name": "Order by lastUpdated descending"
},
{
"id": "last_updated_asc",
"name": "Order by last updated ascending"
},
{
"id": "total_sold_quantity_asc",
"name": "Order by total sold quantity ascending"
},
{
"id": {
"id": "total_sold_quantity_desc",
"field": "sold_quantity",
"missing": "_last",
"order": "desc"
},
"name": "Order by total sold quantity descending"
},
{
"id": {
"id": "inventory_id_asc",
"field": "inventory_id",
"missing": "_last",
"order": "asc"
},
"name": "Order by inventory id ascending"
}
]
}
}Video, video 360 y tour virtual
Para publicar un video, video 360 o un tour virtual de un inmueble debes usar el campo video_id en la publicación, que está compuesto por el string correspondiente al id del recurso multimedia y a un identificador del proveedor o plataforma relacionada al recurso. De esta manera, video_id =multimedia_resource_id;multimedia_provider_id soporta estos 2 tipos de recursos multimedia:
Youtube (solo para videos), por ejemplo: “video_id”:“gqkEN9poKM;youtube”.
Matterport (solo para tours virtuales), por ejemplo: “video_id”:“gqkEN9poKM;matterport”.
Sólo es posible informar un tipo de contenido multimedia, o sea debes enviar el link del video de Youtube o una url de Matterport.
El campo video_id no acepta parámetros. Por esto, si envías el contenido como “video_id”:“URTsWQ6iHsJ&brand=0;matterport”, no va funcionar.
Publica inmuebles en Portal inmobiliario (Solo aplica para MLC)
En Chile (MLC), para que el ítem quede correctamente cargado en MercadoLibre y Portal Inmobiliario, debes incluir en el Post del ítem dentro de attributes, el atributo CMG_Site, lo que incorporará el listing_source: portalinmobiliario dejando visible en ambos portales. Para incluirlo, debes agregarlo tal cual el siguiente json:
{
"id": "CMG_SITE",
"name": "Sitio de origen",
"value_id": null,
"value name": "POI",
"value_struct": null,
"attribute_group_id": "OTHERS",
"attribute_group_name": "Otros"
}
Modifica la localización de tu inmueble
Para efectuar modificaciones en la publicación, se debe enviar un PUT con los nuevos campos que se modificarán. En el ejemplo abajo, se envía una nueva ubicación:
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}Respuesta:
{
"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": []
}Tiendas Oficiales para Vehículos e Inmuebles
El campo official_store_id es requerido para todas las publicaciones de aquellos usuarios que tengan asociada una Tienda Oficial.
Si el vendedor no tiene una Tienda Oficial asociada, puedes enviar el campo official_store_id como null. Pero si tiene una Tienda Oficial y no la menciona va generar un 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"}]}El objetivo de este campo es asociar el ítem a la Tienda Oficial correspondiente al ID. Revisa la siguiente documentación sobre Tiendas Oficiales para conocer más.
Cómo saber si tu vendedor tiene Tienda Oficial
En el caso que el vendedor tenga una Tienda Oficial, puedes obtener el ID y más detalles de la marca siguiendo esta guía.
Cómo agregar el official_store_id
Al momento de publicar (POST) el ítem, deberás agregar el ID de la tienda en el campo official_store_id. En el caso del update (PUT), deberás agregar el campo official_store_id solo si se requiere actualizar este explícitamente.
Conoce más cómo publicar un ítem
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.
Ejemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' "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/itemsRespuesta:
{
"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": []
}Conoce los errores comunes al publicar en Tiendas Oficiales
A continuación, puedes ver el error 400 que reciben aquellos usuarios asociados a Tiendas Oficiales que no envíen el atributo.
Si no envías el official_store_id del artículo para una Tienda Oficial multimarca, recibirás como respuesta los posibles ID que podrías enviar con tu usuario:
"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"{
"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": []
}
Configurar paquete para usuario de prueba
Para añadir un paquete para publicaciones de prueba, cargue los datos de su usuario de test en el soporte por site:
Siguiente: Sincroniza publicaciones.