Consulta Usuarios Avanzados

Ahora que ya sabes como trabajar con usuarios de MercadoLibre, es hora que entremos en características especiales de ellos:

Contenidos:

Please rate this

Sincroniza publicaciones

Una vez que tienes publicaciones activas en nuestro marketplace, es probable que debas actualizarlas y modificarlas en forma periódica para sincronizar el stock con otras plataformas con las que trabajas, pausar publicaciones, mejorar descripciones, actualizar precios, etc.
Sigue esta guía para aprender cómo hacerlo.

Contenidos:

Consideraciones

No todos los campos se pueden actualizar y esto cambiará si el artículo tiene ventas o no. Además, recuerda que tu artículo debe estar activo para poder modificarlo. Puedes modificar los valores para:

  • Título
  • Available_quantity
  • Precio
  • Video
  • Imágenes
  • Descripción*
  • Envío

*No es posible modificar, sólo agregar un post.
Cuando el artículo tiene ventas, no podrás cambiar ninguno de los siguientes campos del mismo:

  • Título
  • Estado
  • Modo de compra
  • Métodos de Pago distintos de MercadoPago
  • Dimensiones de envío
  • Garantía

También recuerda que:

  • La categoría no se puede modificar a través de la API.
  • El tipo de publicación se puede modificar solo una vez.
  • El título no se puede modificar en un artículo con ventas salvo seas parte de las tiendas oficiales de MercadoLibre.

Actualiza tu artículo

Veamos un ejemplo básico de actualización del título y el precio de un artículo. Lo único que necesitas es el item_id del producto publicado y, por supuesto, el access_token del vendedor.

Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Bien: el título y precio de tu artículo fueron actualizados y deberías recibir un estado de respuesta con código 200 OK para confirmar que no hubo inconvenientes.
Recuerda que puede tardar un momento hasta ver la información actualizada.

Descripciones

Es muy fácil actualizar una descripción y lo puedes hacer independientemente de que el artículo tenga o no ofertas. Pero como existen ciertas consideraciones que debes recordar al agregar o reemplazar descripciones, consulta nuestro artículo sobre descripciones para asegurarte de entenderlo bien.

Imágenes

Siempre puedes agregar o reemplazar imágenes de artículos; consulta nuestro tutorial Trabajar con imágenes para conocer la mejor forma de hacerlo.

Tipos de publicación

Cuando quieres más exposición para tu artículo, debes actualizar el tipo de publicación. Conoce los detalles y consideraciones y aprende cómo realizar una actualización en nuestro tutorial Tipos y actualización de publicaciones.

Cambia el estado de las publicaciones

Cualquier artículo publicado en nuestro marketplace puede tener diferentes estados; analiza la descripción de cada uno a continuación:

cerrado: Finaliza tu publicación. Una vez cerrado, no se puede volver a activar, pero se puede volver a publicar.
pausado: Pausa tu publicación. Una vez pausado, no será visible para otros usuarios de MercadoLibre, pero no se cerrará y se podrá reactivar más tarde.
activo: Reactiva un artículo previamente pausado.

Si necesitas realizar cambios en el estado del artículo, debes enviar uno de estos valores para el campo “estado”. Recuerda que el valor distingue entre mayúsculas y minúsculas y se debe enviar en minúscula.

Para pausar un artículo activo, sigue el ejemplo a continuación:

Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

¡Excelente! Tu artículo ha sido pausado. Ahora puedes intentar reactivarlo realizando exactamente la misma llamada, pero enviando “activo” en lugar de “pausado” como valor del estado.

Si actualmente tu artículo está cerrado y quieres volver a publicarlo, consulta nuestro artículo sobre volver a publicar para hacerlo rápido.
Para más información sobre el estado del artículo, por favor consulta el artículo sobre el ciclo de vida de las publicaciones.

Elimina publicaciones

Después de eliminar una publicación no hay vuelta atrás; por eso, ten cuidado cuando realizas esta acción. Además, recuerda que no es necesario eliminar los artículos cerrados porque serán descartados automáticamente después de cierto tiempo.
Si aún necesitas eliminar un artículo, por ejemplo artículos en estado: payment_required que no responderán al estado ‘cerrado’, haz lo siguiente:
Ejemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}

{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

¡Eso es! Tu artículo será eliminado.



Siguiente:
Gestiona contactos y visitas.

Please rate this

Recibe notificaciones

Algunos eventos se producen del lado de Mercado Libre y la única forma de conocerlos es a través de notificaciones.
Recibir notificaciones te permite tener un feed en tiempo real de los cambios que se producen en los diferentes recursos de nuestra la API.
Por ejemplo, si publicaste un artículo y más tarde fue pausado, si alguien formuló una pregunta, si compraron un artículo o incluso lo pagaron y/o solicitó envío.
¡Una manera eficiente sin tener que consultar permanentemente nuestra API!

Contenidos:

Suscríbete a las notificaciones

Si quieres comenzar a recibir notificaciones, debes dirigirte a nuestro administrador de aplicaciones, donde creaste tu aplicación por primera vez, editar los detalles y especificar los topics que recibirás.
Nota: Si aún no creaste tu Aplicación, dirígete a la sección Crea tu aplicación.

Topics

– Callback URL de Notificaciones: Configura el URL público del dominio donde quieres recibir notificaciones para los diferentes topics. Por ejemplo: “http://myshoes-app.com/callbacks”.

– Topics: Selecciona entre diferentes topics para recibir sus notificaciones.
Aclaración: Ten en cuenta que los topics orders, created_orders y payments no son utilizados para vehículos, inmuebles y servicios ya que no se generan ventas ni pagos.

Topics Disponibles

  • items – Recibirás notificaciones de cualquier cambio en un artículo que publicaste.
  • orders – Recibirás notificaciones de cualquier cambio que se realice en alguna de tus ventas confirmadas.
  • created_orders – Recibirás notificaciones de tus ventas recién creadas cuando ingresan por el flujo de Mercado Pago obligatorio.
    Sólo obtendrás datos del producto y cantidad de unidades ya que la compra aún no fue confirmada. No debes realizar ninguna acción hasta que no pase a “paid”.
    Sirve únicamente para reservar el stock, ya que si el comprador finalmente paga pero el item ya no tiene stock, el pago se devuelve automáticamente y se cancela la venta.
  • Aclaración: Una vez que la orden esté paga, se comenzarán a enviar las notificaciones al igual que desde “orders”, por lo que sugerimos elegir sólo uno de los topics para evitar eventos duplicados.

  • questions – Recibirás notificaciones de todas las preguntas formuladas o respondidas.
  • payments – Recibirás notificaciones cuando se crea un pago en una orden o el estado del mismo cambia.
  • pictures – Recibirás notificaciones sólo de las imágenes que por algún error no van a poder descargarse.
  • Nota: En paralelo se envía un e-mail automático al vendedor agrupando las imágenes que tuvieron problemas.

Consideraciones

  • Los mensajes se enviarán y se reintentará enviarlos por un período de 12 horas. Después de ese período, si no son aceptados por la aplicación, serán descartados.
  • Como enviaremos un POST a tu URL, tu aplicación debe acusar recibo con un código de estado HTTP 200; de lo contrario, el mensaje será considerado no entregado y se reintentará enviarlo.
  • Tu aplicación debe enviar una respuesta en 20 segundos; de lo contrario, el límite de tiempo expirará, se considerará no entregada y se reintentará enviarla.

¿Qué eventos disparan notificaciones?

items

  • Cambios en cualquiera de los atributos.
  • Cambios en el estado: La publicación debe ser revisada por un operador y el estado se modifica a “under_review” o se pausa y el estado se modifica a “pausado”.

orders

  • Reducción de stock: Alguien compra uno de tus artículos y el stock se reduce. Se crea un nuevo pedido.
  • Pago: El comprador agrega un pago al pedido.
  • Envío: Existe nueva información de envío asociada al pedido o el estado del envío cambia a: pendiente, listo para imprimir, en tránsito, entregado, no entregado.
  • Feedback: El comprador te califica como vendedor o envías feedback al comprador. Se recibe un feed en el pedido.
  • Aclaración: orders está compuesto por bloques de otras apis, pero no todos los datos se muestran ya que no son necesarios. Esos bloques independientes pueden tener cambios, lo que genera eventos y posteriores notificaciones sobre la orden, aunque a veces no se vean cambios con respecto al json anterior.

created_orders

  • Llegará la notificación de created_orders cuando se crea una orden que ingresó por el flujo de Mercado Pago obligatorio. Sirve únicamente para reservar el stock.
  • El resto de las notificaciones una vez que está “paid” la orden, son las mismas que las del topic “orders”. Si están ambos seleccionados, llegan notificaciones de los dos topics.

questions

  • Recibes una nueva pregunta.
  • Respondes una pregunta.
  • Eliminas una pregunta que consideras inapropiada.

payments

  • Se genera un pago.
  • El estado del pago cambia.

pictures

  • Cuando alguna imagen por error no pudo descargarse.



Aclaración: En caso que recibas notificaciones que consideres duplicadas ten en cuenta que existen eventos internos que no son visibles al integrador pero disparan notificaciones.

Accede a los detalles

Después de recibir una notificación sobre un tema, deberás realizar una solicitud GET al recurso para acceder a los detalles y luego, si guardaste el JSON anterior, comparar ambos.

items

Notification response:

{
  "resource": "/items/MLB139876",
  "user_id": 1234,
  "topic": "items",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Con esta información podrás realizar un GET al recurso de ítems:

curl -X GET https://api.mercadolibre.com/items/{Item_id}?access_token=ACCESS_TOKEN


orders y created_orders

Notification response:

{
    "resource": "/orders/139876",
    "user_id": 1234,
    "topic": "orders",
    "received": "2011-10-19T16:38:34.425Z",
    "sent" : "2011-10-19T16:40:34.425Z",
}

Con esta información podrás realizar un GET al recurso de órdenes:

curl -X GET https://api.mercadolibre.com/orders/{Order_id}?access_token=ACCESS_TOKEN


questions

Notification response:

{
  "resource": "/questions/139876",
  "user_id": 1234,
  "topic": "questions",
  "received": "2011-10-19T16:38:34.425Z",
  "sent" : "2011-10-19T16:40:34.425Z",
}

Con esta información podrás realizar un GET al recurso de questions:

curl -X GET https://api.mercadolibre.com/questions/{Question_id}?access_token=ACCESS_TOKEN


payments

Notification response:

{
  "resource": "/collections/1780558484",
  "user_id": 149218964,
  "topic": "payments",
  "application_id": 2470,
  "attempts": 1,
  "sent": "2016 - 01 - 15 T18: 12: 31.313 Z ",
  "received": "2016 - 01 - 15 T18: 12: 31.299 Z "
}

Con esta información podrás realizar un GET al recurso de collections:

curl -X GET https://api.mercadolibre.com/collections/{Payment_id}?access_token=ACCESS_TOKEN


pictures

Notification response:

{
  "messages": [
    {
      "_id": "123aaa456bbb789ccc",
      "application_id": "1234",
      "user_id": "123456789",
      "resource": "/pictures/12345-MLA1234567-20160729"/errors,
      "topic": "pictures",
      "sent": "2016-07-24T11:00:00.836Z",
      "received": "2016-07-24T11:00:00.836Z",
      "attempts": "2",
      "created_at": "2016-07-24T11:00:00.836Z"
    }
  ]
}

Con esta información podrás realizar un GET al recurso de picture:

curl -X GET https://api.mercadolibre.com/pictures/{picture_id}/errors?access_token=ACCESS_TOKEN

Deberás identificar por qué la imagen no se pudo procesar correctamente. Ver “Consideraciones y mejores prácticas para trabajar con imágenes

Recurso historial de Feeds

Guardamos un registro de tu historial de notificaciones y puedes acceder al mismo en cualquier momento llamando a nuestro recurso myfeeds.
Ejemplo:

curl -X GET https://api.mercadolibre.com/myfeeds?app_id={App_id}

Respuesta:

{
  "messages": [
  {
    "_id": "123aaa456bbb789ccc",
    "application_id": "1234",
    "user_id": "123456789",
    "resource": "/orders/12345678",
    "topic": "orders",
    "sent": "2014-10-24T11:00:00.836Z",
    "received": "2014-10-24T11:00:00.836Z",
    "attempts": "2",
    "http_code": "400",
    "created_at": "2014-10-24T11:00:00.836Z"
  }
}
}

Nota: Ten en cuenta que por defecto sólo se mostrarán 10 notificaciones pero, puedes utilizar LIMIT y OFFSET para modificar la cantidad que quieres recibir tal como se muestra a continuación:

https://api.mercadolibre.com/myfeeds?app_id=(APP_ID)&offset=1&limit=5



Siguiente:
Consultas avanzadas.

Please rate this

Gestiona Paquetes

Los Paquetes Promocionales son paquetes para publicaciones de Clasificados de Concesionarios de Autos e Inmobiliarias. Para realizar pruebas de test, deberás enviar el usuario al canal de soporte para que sea activado como car dealer o real state.

Contenidos:

Consultar paquetes por categoría

Los valores posibles para las categorías classifieds_promotion_packs son diferentes en cada site. Los valores posibles son:
{site_id}1743: Concesionario de autos.
{site_id}1459: Inmobiliaria.
Por ejemplo, en Argentina, la categoría de paquetes para Concesionarios de Autos es MLA1743, mientras que en Brasil es MLB1743.
Realiza una solicitud GET para buscar paquetes en una categoría específica:

curl -X GET https://api.mercadolibre.com/categories/{category_id}/classifieds_promotion_packs

Respuesta:

[
  {
	"id": "IPAA",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 15 Básico",
	"price": 350,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCAA",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 15
  	}
	]
  },
  {
	"id": "IPAR",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 15 Premium",
	"price": 600,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCAR",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "gold",
    	"available_listings": 6
  	},
  	{
    	"listing_type_id": "gold_premium",
    	"available_listings": 1
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 8
  	}
	]
  },
  {
	"id": "IPAS",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 15 Especial",
	"price": 410,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCAS",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
	    "available_listings": 10
  	},
  	{
    	"listing_type_id": "gold",
    	"available_listings": 5
  	}
	]
  },
  {
	"id": "IPBA",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 30 Básico",
    "price": 480,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCBA",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 30
  	}
    ]
  },
  {
	"id": "IPBR",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 30 Premium",
	"price": 880,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCBR",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 16
  	},
  	{
    	"listing_type_id": "gold_premium",
    	"available_listings": 2
  	},
  	{
    	"listing_type_id": "gold",
    	"available_listings": 12
  	}
	]
  },
  {
	"id": "IPBS",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 30 Especial",
	"price": 560,
	"package_type": "rotary",
	"duration": 30,
    "status": "active",
	"charge_type_id": "CCBS",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 20
  	},
  	{
    	"listing_type_id": "gold",
    	"available_listings": 10
  	}
	]
  },
  {
	"id": "IPCA",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 60 Básico",
	"price": 570,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCCA",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 60
  	}
	]
  },
  {
	"id": "IPCR",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 60 Premium",
	"price": 910,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCCR",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 32
  	},
  	{
    	"listing_type_id": "gold",
    	"available_listings": 24
  	},
  	{
    	"listing_type_id": "gold_premium",
    	"available_listings": 4
  	}
	]
  },
  {
	"id": "IPCS",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 60 Especial",
	"price": 650,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCCS",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "gold",
    	"available_listings": 20
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 40
  	}
	]
  },
  {
	"id": "IPDA",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
    "description": "Paquete 100 Básico",
	"price": 750,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCDA",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
        "available_listings": 100
  	}
	]
  },
  {
	"id": "IPDR",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 100 Premium",
	"price": 1180,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCDR",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "gold_premium",
    	"available_listings": 5
  	},
  	{
    	"listing_type_id": "gold",
    	"available_listings": 35
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 60
  	}
	]
  },
  {
	"id": "IPDS",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 100 Especial",
	"price": 820,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCDS",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "gold",
    	"available_listings": 25
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 75
  	}
	]
  },
  {
	"id": "IPEA",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 500 Básico",
	"price": 850,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCEA",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "silver",
    	"available_listings": 500
  	}
	]
  },
  {
	"id": "IPER",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 500 Premium",
	"price": 1900,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCER",
	"max_upgrades": 0,
	"listing_details": [
  	{
	    "listing_type_id": "gold",
    	"available_listings": 100
  	},
  	{
    	"listing_type_id": "gold_premium",
    	"available_listings": 15
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 385
  	}
    ]
  },
  {
	"id": "IPES",
	"category_id": "MLA1459",
	"brand": "MLREALESTATE",
	"description": "Paquete 500 Especial",
	"price": 1000,
	"package_type": "rotary",
	"duration": 30,
	"status": "active",
	"charge_type_id": "CCES",
	"max_upgrades": 0,
	"listing_details": [
  	{
    	"listing_type_id": "gold",
    	"available_listings": 70
  	},
  	{
    	"listing_type_id": "silver",
    	"available_listings": 430
  	}
	]
  }
]

Obtener paquetes de publicación contratados por un usuario

curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?access_token=$ACCESS_TOKEN;

Respuesta:

[
   	{
	   "id": 754985,
	   "user_id": "135146148",
	   "promotion_pack_id": "MPAB",
	   "category_id": "MLU1743",
	   "description": "Paquete 15 Básico",
	   "package_type": "rotary",
	   "status": "active",
	   "date_created": "2013-05-23T15:34:48.498-04:00",
	   "date_start": "2013-05-23T15:34:47.544-04:00",
	   "date_expires": "2013-06-22T15:34:47.544-04:00",
	   "date_stopped": null,
	   "last_updated": "2013-05-23T15:35:48.211-04:00",
	   "engagement_type": "none",
	   "charge_id": 822129921,
	   "remaining_listings": 15,
	   "used_listings": 0,
	   "listing_details": [
    	 	{
        	 "listing_type_id": "silver",
        	 "available_listings": 15,
        	 "used_listings": 0,
        	 "remaining_listings": 15
    	 	}
	   ]
   	}
]

Obtener paquetes de destaque contratados por un usuario

curl -X GET 
https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs?package_content=upgrades&status=active&access_token=$ACCESS_TOKEN;

Respuesta:

[
    {
        "id": 1584151,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGGP5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Premium Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:29.124-04:00",
        "date_start": "2017-08-31T09:08:29.113-04:00",
        "date_expires": "2017-09-30T09:08:29.113-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.860-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387845,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold_premium",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    },
    {
        "id": 1584150,
        "user_id": "XXXXXX",
        "promotion_pack_id": "IPUPGG5INT",
        "category_id": "MLA1459",
        "brand": "MLREALESTATE",
        "description": "5 Destaques Oro Interior",
        "package_type": "rotary",
        "status": "active",
        "date_created": "2017-08-31T09:08:28.752-04:00",
        "date_start": "2017-08-31T09:08:28.742-04:00",
        "date_expires": "2017-09-30T09:08:28.742-04:00",
        "date_stopped": null,
        "last_updated": "2017-08-31T09:25:57.747-04:00",
        "engagement_type": "none",
        "package_content": "upgrades",
        "charge_id": 3152387844,
        "bonus_id": null,
        "remaining_listings": 0,
        "used_listings": 5,
        "quota_type": "reusable",
        "next_promotion_pack_id": null,
        "parent_promotion_pack_id": null,
        "listing_details": [
            {
                "listing_type_id": "gold",
                "available_listings": 5,
                "used_listings": 5,
                "remaining_listings": 0
            }
        ]
    }
]

Descripción de recursos

atributo descripción
id Identificador único del paquete.
user_id ID único del usuario que contrató el paquete.
category_id Categoría del paquete.
description nombre del paquete.
package_type: detalle del paquete.
status los valores posibles del estado del paquete son:
activo: el usuario puede utilizar este paquete para publicar. Se descontará una available_listing cuando lo haga.
pendiente: el paquete aún no está activo.
finalizado: paquete expirado.
date_created fecha de creación del paquete.
date_start: fecha de activación del paquete.
date_expires fecha de expiración del paquete.
date_stopped fecha de finalización del paquete.
last_updated última actualización del paquete.
engagement_type Los valores posibles son:
“ninguno”: El paquete se contrató por única vez.
“recontratación”: Cuando el paquete expira, se recontratará automáticamente un package_type similar.
charge_id ID único del cargo generado durante la contratación del paquete.
listing_details información detallada sobre tipos y disponibilidad de publicaciones.
listing_type_id listing_type asociado con el paquete.
available_listings cantidad de publicaciones que el usuario obtiene con el paquete.
used_listings publicaciones ya utilizadas.
remaining_listings publicaciones restantes disponibles.

Verificar si un usuario tiene un listing_type específico disponible

curl -X GET https://api.mercadolibre.com/users/{user_id}/classifieds_promotion_packs/silver?access_token=$ACCESS_TOKEN

Actualizar el artículo

POST https://api.mercadolibre.com/items/{item_id}/listing_type?access_token=$ACCESS_TOKEN

Cuerpo:

{ “id”:”{listing_type}” }

La respuesta es el artículo actualizado.
Ejemplo:

curl -X POST --header "Content-type:application/json" -d '{"id":"gold"}' 'https://api.mercadolibre.com/items/MLA563940625/listing_type?access_token=$ACCESS_TOKEN'
{
	"id": "MLA563940625",
	"site_id": "MLA",
	"title": "Test 10 No Ofertar",
	"subtitle": null,
	"seller_id": 184854440,
	"category_id": "MLA50543",
    "official_store_id": null,
	"price": 2928282,
	"base_price": 2928282,
	"original_price": null,
	"currency_id": "ARS",
	"initial_quantity": 1,
	"available_quantity": 1,
	"sold_quantity": 0,
	"buying_mode": "classified",
	"listing_type_id": "gold",
	"start_time": "2015-06-09T20:25:50.000Z",
	"stop_time": "2015-07-05T19:51:17.587Z",
	"end_time": "2015-07-05T19:51:17.587Z",
	"condition": "not_specified",
	"permalink": "http://inmueble.mercadolibre.com.ar/MLA-563940625-test-10-no-ofertar-_JM",
	"thumbnail": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
	"secure_thumbnail": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-I.jpg",
	"pictures": [
    	{
        	"id": "302401-MLA20317818801_062015",
        	"url": "http://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
        	"secure_url": "https://mla-s1-p.mlstatic.com/302401-MLA20317818801_062015-O.jpg",
        	"size": "500x281",
        	"max_size": "1200x675",
        	"quality": ""
    	}
	],
	"video_id": null,
	"descriptions": [],
	"accepts_mercadopago": false,
    "non_mercado_pago_payment_methods": [],
	"shipping": {
    	"mode": "not_specified",
    	"local_pick_up": false,
    	"free_shipping": false,
    	"methods": [],
    	"dimensions": null,
    	"tags": []
	},
    "international_delivery_mode": "none",
	"seller_address": {
    	"id": 163310864,
    	"comment": "",
    	"address_line": "Test Address 123",
    	"zip_code": "1414",
    	"city": {
        	"id": "",
        	"name": "Palermo"
    	},
    	"state": {
        	"id": "AR-C",
        	"name": "Capital Federal"
    	},
    	"country": {
       	 "id": "AR",
        	"name": "Argentina"
    	},
    	"latitude": "",
    	"longitude": "",
    	"search_location": {
        	"neighborhood": {
            	"id": "TUxBQlBBTDI1MTVa",
            	"name": "Palermo"
        	},
        	"city": {
            	"id": "TUxBQ0NBUGZlZG1sYQ",
            	"name": "Capital Federal"
        	},
        	"state": {
            	"id": "TUxBUENBUGw3M2E1",
            	"name": "Capital Federal"
        	}
    	}
    },
	"seller_contact": {
    	"contact": "",
    	"other_info": "",
    	"area_code": "",
    	"phone": "",
    	"area_code2": "",
    	"phone2": "",
    	"email": "",
    	"webpage": ""
	},
	"location": {
    	"address_line": "falsa 123 123",
    	"zip_code": "",
    	"neighborhood": {
        	"id": "TUxBQkVTUDYyODRa",
        	"name": "Espartillar"
    	},
    	"city": {
        	"id": "TUxBQ0FETzQ2Nzc",
        	"name": "Adolfo Alsina"
    	},
    	"state": {
        	"id": "TUxBUFpPTmFpbnRl",
        	"name": "Buenos Aires Interior"
    	},
    	"country": {
        	"id": "AR",
        	"name": "Argentina"
    	},
    	"latitude": -34.6635266,
    	"longitude": -58.3654707,
    	"open_hours": ""
	},
	"geolocation": {
    	"latitude": -34.6635266,
    	"longitude": -58.3654707
	},
	"coverage_areas": [],
	"attributes": [
    	{
        	"id": "MLA1459-HORPREF",
        	"name": "Horario de contacto",
        	"value_id": "",
        	"value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
    	},
    	{
        	"id": "MLA50541-ACCESO",
        	"name": "Acceso",
        	"value_id": "",
        	"value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
    	},
    	{
        	"id": "MLA50541-ANTIG",
        	"name": "Antigüedad",
        	"value_id": "",
        	"value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
    	},
    	{
        	"id": "MLA50541-EXPENCEM",
        	"name": "Expensas ($)",
            "value_id": "",
        	"value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
    	},
    	{
        	"id": "MLA50541-SEGUR",
        	"name": "Seguridad",
       	 "value_id": "",
        	"value_name": "",
            "attribute_group_id": "ADICIONALES",
            "attribute_group_name": "Adicionales"
    	},
    	{
        	"id": "MLA1459-INMUEBLE",
        	"name": "Inmueble",
        	"value_id": "MLA1459-INMUEBLE-COCHERA",
        	"value_name": "Cochera",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
    	},
    	{
        	"id": "MLA1459-OPERACION",
        	"name": "Operación",
        	"value_id": "MLA1459-OPERACION-VENTA",
        	"value_name": "Venta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
    	},
    	{
        	"id": "MLA50541-MTRSTOTAL",
        	"name": "Superficie total (m²)",
        	"value_id": "",
        	"value_name": "24",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
    	},
    	{
        	"id": "MLA50541-TIPCOB",
        	"name": "Tipo de cobertura",
        	"value_id": "MLA50541-TIPCOB-CUBIERTA",
        	"value_name": "Cubierta",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
    	},
    	{
        	"id": "MLA50541-TIPOCOCH",
        	"name": "Tipo de cochera",
        	"value_id": "MLA50541-TIPOCOCH-FIJA",
        	"value_name": "Fija",
            "attribute_group_id": "FIND",
            "attribute_group_name": "Ficha técnica"
    	}
	],
	"listing_source": "",
	"variations": [],
	"status": "active",
	"sub_status": [],
	"tags": [],
	"warranty": null,
	"catalog_product_id": null,
	"seller_custom_field": null,
	"parent_item_id": null,
	"differential_pricing": null,
    "deal_ids": [],
	"automatic_relist": false,
	"date_created": "2015-06-09T20:25:50.000Z",
	"last_updated": "2015-06-10T12:20:32.418Z"
}

Siguiente:
Categorías y atributos

Please rate this

Publica inmuebles

Esta guía te ayudará a publicar tu primer artículo clasificado en MercadoLibre utilizando nuestra API.

Contenidos:

Puntos básicos

En general, los inmuebles y clasificados son el único tipo de publicación que permite a los usuarios mostrar su información de contacto al público; por eso, cuando los usuarios buscan propiedades para alquilar o comprar y les interesa una de las tuyas, pueden ponerse en contacto contigo de inmediato. Entonces, básicamente, en los artículos clasificados no se realiza ningún tipo de transacción, por lo cual no venderás ni alquilarás tu propiedad directamente desde nuestro site, sino que la mostrarás a todos los usuarios que buscan propiedades en la web.

Resultados de publicaciones

Cada artículo que publicas aparecerá en los resultados de publicaciones de una búsqueda determinada. Por ejemplo, cuando un usuario busca la consulta “Casa en Mar del Plata”, obtendrá como resultado una lista de todos los artículos relacionados. Tu propiedad puede estar incluida en esta lista.
Cuando alguien hace clic en un artículo, se muestra la página Detalles del artículo con toda la información sobre el artículo que fue ingresada al momento de la publicación. Para más información, sigue leyendo.

Página Detalles del artículo

Ésta es la página en el frontend de nuestro Marketplace para cada item.
Cuando un usuario selecciona una publicación de los resultados de la búsqueda, esta página muestra los siguientes detalles del artículo:

  • Item_id
  • Título
  • Ciudad
  • Imágenes
  • Precio
  • Información de contacto
  • Formulario de contacto
  • Atributos
  • Descripción detallada

Campos de una publicación de inmuebles

Veamos un artículo inmueble normal por API. Es fácil porque 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. En Argentina, 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 https://api.mercadolibre.com/items/{Item_id}

Ejemplo:

curl - X GET https://api.mercadolibre.com/items/MLA603335359

Respuesta:

{
  "id": "MLA603335359",
  "site_id": "MLA",
  "title": "Semana.santa 190 Por Capacidad Deptos Complejo Angel Del Sol",
  "subtitle": null,
  "seller_id": 50152177,
  "category_id": "MLA50283",
  "official_store_id": null,
  "price": 190,
  "base_price": 190,
  "original_price": null,
  "currency_id": "ARS",
  "initial_quantity": 1,
  "available_quantity": 1,
  "sold_quantity": 0,
  "buying_mode": "classified",
  "listing_type_id": "gold_premium",
  "start_time": "2016-01-31T14:16:20.000Z",
  "stop_time": "2017-01-30T14:16:20.000Z",
  "condition": "used",
  "permalink": "http://inmueble.mercadolibre.com.ar/MLA-603335359-semanasanta-190-por-capacidad-deptos-complejo-angel-del-sol-_JM",
  "thumbnail": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
  "secure_thumbnail": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-I.jpg",
  "pictures": [
	{
  	"id": "23423-MLA20248368790_022015",
  	"url": "http://mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23423-MLA20248368790_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23447-MLA20248368829_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23447-MLA20248368829_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23431-MLA20248368726_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23431-MLA20248368726_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23451-MLA20248368762_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23451-MLA20248368762_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23446-MLA20248368859_022015",
  	"url": "http://mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23446-MLA20248368859_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23449-MLA20248368490_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23449-MLA20248368490_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23466-MLA20248368893_022015",
  	"url": "http://mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23466-MLA20248368893_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23475-MLA20248368922_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23475-MLA20248368922_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23425-MLA20248370717_022015",
  	"url": "http://mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23425-MLA20248370717_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
 	 "id": "23448-MLA20248370762_022015",
  	"url": "http://mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/23448-MLA20248370762_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23403-MLA20248370781_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23403-MLA20248370781_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	},
	{
  	"id": "23480-MLA20248371283_022015",
  	"url": "http://mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
  	"secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/23480-MLA20248371283_022015-O.jpg",
  	"size": "500x375",
  	"max_size": "1200x900",
  	"quality": ""
	}
  ],
  "video_id": null,
  "descriptions": [
	{
  	"id": "MLA603335359-1022043551"
	}
  ],
  "accepts_mercadopago": false,
  "non_mercado_pago_payment_methods": [
  ],
  "shipping": {
	"mode": "not_specified",
	"local_pick_up": false,
	"free_shipping": false,
	"methods": [
	],
	"dimensions": null,
	"tags": [
	]
  },
  "international_delivery_mode": "none",
  "seller_address": {
	"id": 153363213,
	"comment": "ferreteria antartida",
	"address_line": "av3 y paseo127 111111",
	"zip_code": "7165",
	"city": {
  	"id": "TUxBQ1ZJTGU4OGM3",
  	"name": "Villa Gesell"
	},
	"state": {
  	"id": "AR-B",
  	"name": "Buenos Aires"
	},
	"country": {
  	"id": "AR",
  	"name": "Argentina"
	},
	"latitude": -37.25747514,
	"longitude": -56.97445905,
	"search_location": {
  	"neighborhood": {
    	"id": "",
    	"name": ""
  	},
  	"city": {
    	"id": "TUxBQ1ZJTGU4OGM3",
    	"name": "Villa Gesell"
  	},
  	"state": {
    	"id": "TUxBUENPU2ExMmFkMw",
    	"name": "Bs.As. Costa Atlántica"
  	}
	}
  },
  "seller_contact": {
	"contact": "",
	"other_info": "",
	"area_code": "",
	"phone": "",
	"area_code2": "",
	"phone2": "",
	"email": "",
	"webpage": ""
  },
  "location": {
	"address_line": "PASEO 141 BIS Y 4 4100",
	"zip_code": "",
	"neighborhood": {
  	"id": "",
  	"name": ""
	},
	"city": {
  	"id": "TUxBQ1ZJTGU4OGM3",
  	"name": "Villa Gesell"
	},
	"state": {
  	"id": "TUxBUENPU2ExMmFkMw",
  	"name": "Bs.as. Costa Atlántica"
	},
	"country": {
  	"id": "AR",
  	"name": "Argentina"
	},
	"latitude": -37.2598939,
	"longitude": -56.9714194,
	"open_hours": ""
  },
  "geolocation": {
	"latitude": -37.2598939,
    "longitude": -56.9714194
  },
  "coverage_areas": [
  ],
  "attributes": [
	{
  	"id": "CAPPERSO",
  	"name": "Capacidad de personas",
  	"value_id": "CAPPERSO-5",
  	"value_name": "5",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "CKECKIN",
  	"name": "Check in",
  	"value_id": "CKECKIN-11:00",
  	"value_name": "11:00",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
    {
  	"id": "CKECKOUT",
  	"name": "Check out",
  	"value_id": "CKECKOUT-09:00",
  	"value_name": "09:00",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "FECHADESDE",
  	"name": "Desde",
  	"value_id": "",
  	"value_name": "1 de nero",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "FECHAHASTA",
  	"name": "Hasta",
  	"value_id": "",
  	"value_name": "TODO EL AÑO",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "MLA50283-CUADRCENT",
  	"name": "A cuantas cuadras del centro",
  	"value_id": "MLA50283-CUADRCENT-1",
  	"value_name": "1",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "MLA50283-CUADRMAR",
  	"name": "A cuantas cuadras del mar",
  	"value_id": "MLA50283-CUADRMAR-4",
  	"value_name": "4",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "MLA50283-NUMVAJI",
  	"name": "Vajilla para # de personas",
  	"value_id": "MLA50283-NUMVAJI-6",
  	"value_name": "6",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "MLA50283-SEÑA",
  	"name": "% de seña",
  	"value_id": "MLA50283-SEÑA-MAS-DE-50%",
  	"value_name": "Más de 50%",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "NUMEROCAMA",
  	"name": "Número de camas",
  	"value_id": "NUMEROCAMA-6",
  	"value_name": "6",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "PERIOTEMPO",
  	"name": "Estadía Mínima",
  	"value_id": "PERIOTEMPO-15",
  	"value_name": "15",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "TIPOHABITA",
  	"name": "Tipo de habitación",
  	"value_id": "TIPOHABITA-HABPRIVA",
  	"value_name": "Habitación privada",
  	"attribute_group_id": "ADICIONALES",
  	"attribute_group_name": "Adicionales"
	},
	{
  	"id": "BALTERR",
	  "name": "Balcón",
  	"value_id": "BALTERR-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "COCI",
  	"name": "Cocina",
  	"value_id": "COCI-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "COME",
  	"name": "Comedor diario",
  	"value_id": "COME-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "DEPSERV",
  	"name": "Dependencia de servicio",
  	"value_id": "DEPSERV-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "DORMSUIT",
  	"name": "Dormitorio en suite",
  	"value_id": "DORMSUIT-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "ESCRITORIO",
  	"name": "Escritorio",
  	"value_id": "ESCRITORIO-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "ESTAR",
  	"name": "Estar",
  	"value_id": "ESTAR-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "LAVA",
  	"name": "Lavadero",
  	"value_id": "LAVA-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "LIVCOM",
  	"name": "Living comedor",
  	"value_id": "LIVCOM-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "LIVI",
  	"name": "Living",
  	"value_id": "LIVI-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "PAT",
  	"name": "Patio",
	  "value_id": "PAT-Y",
  	"value_name": "Si",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "PLAYROOM",
  	"name": "Playroom",
  	"value_id": "PLAYROOM-N",
  	"value_name": "No",
      "attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "TERRA",
  	"name": "Terraza",
  	"value_id": "TERRA-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "TOIL",
  	"name": "Toilette",
  	"value_id": "TOIL-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "VEST",
  	"name": "Vestidor",
  	"value_id": "VEST-N",
  	"value_name": "No",
  	"attribute_group_id": "AMBIENTES",
  	"attribute_group_name": "Ambientes"
	},
	{
  	"id": "AIRCEN",
  	"name": "Aire acondicionado",
  	"value_id": "AIRCEN-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "AMOBL",
  	"name": "Amoblado",
  	"value_id": "AMOBL-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "APTOFAMILY",
  	"name": "Apto para familias/niños",
  	"value_id": "APTOFAMILY-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "APTOFUMA",
  	"name": "Apto para fumadores",
  	"value_id": "APTOFUMA-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "BAR",
  	"name": "Bar",
  	"value_id": "BAR-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CAJASEG",
  	"name": "Caja de seguridad",
  	"value_id": "CAJASEG-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CALCEN",
  	"name": "Calefacción",
  	"value_id": "CALCEN-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CANCHAGOLF",
  	"name": "Cancha de golf",
  	"value_id": "CANCHAGOLF-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CANCHAPADD",
  	"name": "Cancha de paddle",
  	"value_id": "CANCHAPADD-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CANFUT",
  	"name": "Cancha de fútbol",
  	"value_id": "CANFUT-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "CONINT",
  	"name": "Conexión a internet",
  	"value_id": "CONINT-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "DESAYUNOINCLU",
  	"name": "Desayuno incluido",
  	"value_id": "DESAYUNOINCLU-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "ESTACIOINCLU",
  	"name": "Estacionamiento",
  	"value_id": "ESTACIOINCLU-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "HIDRO",
  	"name": "Hidromasaje",
  	"value_id": "HIDRO-N",
  	"value_name": "No",
	  "attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "JARD",
  	"name": "Jardín",
  	"value_id": "JARD-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "LAVASECA",
  	"name": "Lavarropa/Secarropa",
  	"value_id": "LAVASECA-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-CALE",
  	"name": "Calefón",
  	"value_id": "MLA50283-CALE-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-DEPOGA",
  	"name": "Depósito en garantía $",
  	"value_id": "",
  	"value_name": "3000",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-DVD",
  	"name": "DVD",
  	"value_id": "MLA50283-DVD-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-GASNAT",
  	"name": "Gas natural",
  	"value_id": "MLA50283-GASNAT-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-ROPABL",
  	"name": "Ropa blanca",
  	"value_id": "MLA50283-ROPABL-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-TERMO",
  	"name": "Termotanque",
  	"value_id": "MLA50283-TERMO-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA50283-VENTITE",
  	"name": "Ventilador de techo",
  	"value_id": "MLA50283-VENTITE-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "PARR",
  	"name": "Parrilla",
  	"value_id": "PARR-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "PERMIMASCO",
  	"name": "Permite mascotas",
  	"value_id": "PERMIMASCO-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "PHONETEPAN",
  	"name": "Linea telefónica",
  	"value_id": "PHONETEPAN-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "PILNAT",
  	"name": "Pileta",
  	"value_id": "PILNAT-N",
  	"value_name": "No",
	  "attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "QUINCHO",
  	"name": "Quincho",
  	"value_id": "QUINCHO-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "RESTAUR",
  	"name": "Restaurante",
  	"value_id": "RESTAUR-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
      "id": "SAUNA",
  	"name": "Sauna",
  	"value_id": "SAUNA-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "SOLARI",
  	"name": "Solarium",
  	"value_id": "SOLARI-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "SOM",
  	"name": "SUM",
  	"value_id": "SOM-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "SPA",
  	"name": "Spa",
  	"value_id": "SPA-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "TVXCABLE",
  	"name": "TV por cable",
  	"value_id": "TVXCABLE-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "VIGI",
 	 "name": "Seguridad",
  	"value_id": "VIGI-N",
  	"value_name": "No",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "WIFI",
  	"name": "Wifi",
  	"value_id": "WIFI-Y",
  	"value_name": "Si",
  	"attribute_group_id": "COMODIDADES",
  	"attribute_group_name": "Comodidades"
	},
	{
  	"id": "MLA1459-HORPREF",
  	"name": "Horario de contacto",
  	"value_id": "",
  	"value_name": "de 8 a 22",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1459-INMUEBLE",
  	"name": "Inmueble",
  	"value_id": "MLA1459-INMUEBLE-OTRO_INMUEBLE",
  	"value_name": "Otros Inmuebles",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1459-OPERACION",
  	"name": "Operación",
  	"value_id": "MLA1459-OPERACION-ALQUILER_DE_TEMPORADA",
  	"value_name": "Alquiler Temporario",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1892-ANTIG",
  	"name": "Antigüedad",
  	"value_id": "MLA1892-ANTIG-MAX_10_ANOS",
  	"value_name": "Max 10 años",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1892-ESTADO",
  	"name": "Estado",
  	"value_id": "MLA1892-ESTADO-MUY_BUENO",
  	"value_name": "Muy bueno",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1892-MTRS",
  	"name": "Superficie cubierta (m²)",
  	"value_id": "",
  	"value_name": "35",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1892-MTRSTOTAL",
  	"name": "Superficie total (m²)",
  	"value_id": "",
  	"value_name": "44",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	},
	{
  	"id": "MLA1892-TIPOINMUEB",
  	"name": "Tipo de inmueble",
  	"value_id": "",
  	"value_name": "petit hotel",
  	"attribute_group_id": "FIND",
  	"attribute_group_name": "Ficha técnica"
	}
  ],
  "warnings": [
  ],
  "listing_source": "",
  "variations": [
  ],
  "status": "active",
  "sub_status": [
  ],
  "tags": [
  ],
  "warranty": null,
  "catalog_product_id": null,
  "parent_item_id": null,
  "differential_pricing": null,
  "deal_ids": [
  ],
  "automatic_relist": false,
  "date_created": "2016-01-31T14:16:20.000Z",
  "last_updated": "2016-02-01T05:46:48.000Z"
}

Existe mucha información en la respuesta JSON. A continuación encontrarás algunas pautas importantes.

Definición de atributos

Debes saber que al crear un JSON para tu artículo algunos de los campos son obligatorios, mientras que otros se pueden omitir o los agregaremos automáticamente. Definirán cómo se muestra el artículo y la posición en los resultados de la búsqueda.

Título

Aunque puedas enviar un título que se mostrará en la página de Detalles del artículo, en los artículos clasificados los usuarios que buscan en los mismos verán un título en la lista generado por nosotros en base a los atributos que configuraste para el artículo.

Descripción

La información detallada mejorará tus posibilidades de vender un producto y te ahorrará tiempo al no tener que responder preguntas. Al trabajar con descripciones, existen algunas consideraciones; por ejemplo, no se permite publicar una descripción con información de contacto. Si te interesa conocer más sobre este tema, consulta nuestra guía Descripciones de Artículos.

Nota: Ten en cuenta que la descripción del producto deberá ser en texto sin formato.

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. Básicamente, deberías agregar un conjunto de hasta seis imágenes URL en el JSON.

{
 ....
 "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.

Categoría y atributos

Los vendedores deben definir una categoría en el site de MercadoLibre. 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.

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

Precio

El precio es obligatorio. Si estás abierto a negociar el precio de alquiler o venta con otros usuarios, puedes configurarlo como “a convenir”.

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 Categorías.

Seller custom field

Si bien el Seller custom field no es obligatorio, es muy útil porque no existen valores preestablecidos y puedes enviar lo que desees como una String [cadena]. La mayoría de los vendedores utilizan este campo para asociar sus propios SKU a sus productos y así identificar el producto vendido en el pedido.

Ejemplo para modificar este campo en un item:

curl -X PUT -d '{"seller_custom_field": "21000093"}' https://api.mercadolibre.com/items/MLA599074368?access_token=¢ACCESS_TOKEN

Tipos de publicación

Es otro caso de un atributo obligatorio que solo acepta valores predefinidos y es muy importante que lo entiendas.
Existen diferentes tipos de publicación 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.

Publica un inmueble

Estás listo para publicar tu primer artículo clasificado. Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor regresa al tutorial Iniciación [Getting Started]. 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, que es realmente fácil y rápido.
Puedes crear un JSON para tu artículo en base al ejemplo a continuación o simplemente envíalo y estarás publicando un producto de muestra en el site:

curl -X POST -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",
"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²"
}
],
"description": "This is the real estate property descritpion."
}
https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN

Modifica la localización de tu inmueble

curl -X PUT -d '{
	"location": {
		"address_line": "My property address NEW 111",
		"zip_code": "5000",
		"neighborhood": {
			"id": "TUxBQk9UUjI3MjVa",
			"name": "Otros Barrios"
		},
		"city": {
			"id": "TUxBQ0NBUGNiZGQx",
			"name": "Córdoba"
		}
	}
}' https://api.mercadolibre.com/items/{item_id}?access_token=$ACCESS_TOKEN

Siguiente:
Sincroniza publicaciones.

Please rate this

Localiza inmuebles

Para publicar un inmueble o servicio, deberás determinar de forma obligatoria la ciudad aunque también le podrás añadir de forma opcional estado y también barrio. Para hacerlo, lo mejor es familiarizarte con el recurso classified_locations.

Contenidos:

Al publicar un artículo, solo debes enviar el ID de ubicación de la hoja. Es decir, enviar solo el ID del Barrio es suficiente para que nuestra API complete con los ID de Estado y Ciudad correspondientes.
Si la ciudad elegida no tiene ningún barrio, entonces solo deberás enviar el ID de la Ciudad. Es obligatorio enviar el ID del barrio o el ID de la Ciudad. Si envías solo el ID del Estado, nuestra API no te permitirá publicar el artículo (de todos modos, nunca debes enviar el ID del Estado porque se completará automáticamente según el ID del Barrio o el ID de la Ciudad ingresados).
Este recurso te permitirá explorar las posibles ubicaciones por país, estado, ciudad y barrio.

Explorar todos los países

Ejemplo:

curl -X GET https://api.mercadolibre.com/classified_locations/countries

Respuesta:

[
  {
  "id": "AR",
  "name": "Argentina",
  "locale": "es_AR",
  "currency_id": "ARS"
  },
  {
  "id": "BR",
  "name": "Brasil",
  "locale": "pt_BR",
  "currency_id": "BRL"
  },
  {
  "id": "CO",
  "name": "Colombia",
  "locale": "es_CO",
  "currency_id": "COP"
  },
  {
  "id": "CR",
  "name": "Costa Rica",
  "locale": "es_CR",
  "currency_id": "CRC"
  },
  {
  "id": "CL",
  "name": "Chile",
  "locale": "es_CL",
  "currency_id": "CLP"
  },
  {
  "id": "EC",
  "name": "Ecuador",
  "locale": "es_EC",
  "currency_id": "USD"
  },
  {
  "id": "MX",
  "name": "Mexico",
  "locale": "es_MX",
  "currency_id": "MXN"
  },
  {
  "id": "PA",
  "name": "Panamá",
  "locale": "es_PA",
  "currency_id": "USD"
  },
  {
  "id": "PE",
  "name": "Peru",
  "locale": "es_PE",
  "currency_id": "PEN"
  },
  {
  "id": "PT",
  "name": "Portugal",
  "locale": "pt_PT",
  "currency_id": "EUR"
  },
  {
  "id": "DO",
  "name": "República Dominicana",
  "locale": "es_DO",
  "currency_id": "DOP"
  },
  {
  "id": "UY",
  "name": "Uruguay",
  "locale": "es_UY",
  "currency_id": "UYU"
  },
  {
  "id": "VE",
  "name": "Venezuela",
  "locale": "es_VE",
  "currency_id": "VEF"
  }
]

Explorar información del país

Recurso:

https://api.mercadolibre.com/classified_locations/countries/{Country_Id}

Ejemplo:

curl -X GET https://api.mercadolibre.com/classified_locations/countries/AR

Respuesta:

{
  "id": "AR",
  "name": "Argentina",
  "locale": "es_AR",
  "currency_id": "ARS",
  "decimal_separator": ",",
  "thousands_separator": ".",
  "time_zone": "GMT-03:00",
  "geo_information": {
  "location": {
    "latitude": -38.416097,
    "longitude": -63.616672
  }
  },
  "states": [
  {
    "id": "TUxBUEJSQWwyMzA1",
    "name": "Brasil"
  },
  {
    "id": "TUxBUENPU2ExMmFkMw",
    "name": "Bs.As. Costa Atlántica"
  },
  {
    "id": "TUxBUEdSQWU4ZDkz",
    "name": "Bs.As. G.B.A. Norte"
  },
  {
    "id": "TUxBUEdSQWVmNTVm",
    "name": "Bs.As. G.B.A. Oeste"
  },
  {
    "id": "TUxBUEdSQXJlMDNm",
    "name": "Bs.As. G.B.A. Sur"
  },
  {
    "id": "TUxBUFpPTmFpbnRl",
    "name": "Buenos Aires Interior"
  },
  {
    "id": "TUxBUENBUGw3M2E1",
    "name": "Capital Federal"
  },
  {
    "id": "TUxBUENBVGFiY2Fm",
    "name": "Catamarca"
  },
  {
    "id": "TUxBUENIQW8xMTNhOA",
    "name": "Chaco"
  },
  {
    "id": "TUxBUENIVXQxNDM1MQ",
    "name": "Chubut"
  },
  {
    "id": "TUxBUENPUnM5MjI0",
    "name": "Corrientes"
  },
  {
    "id": "TUxBUENPUmFkZGIw",
    "name": "Córdoba"
  },
  {
    "id": "TUxBUEVOVHMzNTdm",
    "name": "Entre Ríos"
    },
  {
    "id": "TUxBUEZPUmE1OTk5",
    "name": "Formosa"
  },
  {
    "id": "TUxBUEpVSnk3YmUz",
    "name": "Jujuy"
  },
  {
    "id": "TUxBUExBWmE1OWMy",
    "name": "La Pampa"
  },
  {
    "id": "TUxBUExBWmEyNzY0",
    "name": "La Rioja"
  },
  {
    "id": "TUxBUE1FTmE5OWQ4",
    "name": "Mendoza"
  },
  {
    "id": "TUxBUE1JU3MzNjIx",
    "name": "Misiones"
  },
  {
    "id": "TUxBUE5FVW4xMzMzNQ",
    "name": "Neuquén"
  },
  {
    "id": "TUxBUFJFUDQyMjQ4Ng",
    "name": "República Dominicana"
  },
  {
    "id": "TUxBUFLNT29iZmZm",
    "name": "Río Negro"
  },
  {
    "id": "TUxBUFNBTGFjMTJi",
    "name": "Salta"
  },
  {
    "id": "TUxBUFNBTm5lYjU4",
    "name": "San Juan"
  },
  {
    "id": "TUxBUFNBTnM0ZTcz",
    "name": "San Luis"
  },
  {
    "id": "TUxBUFNBTno3ZmY5",
    "name": "Santa Cruz"
  },
  {
    "id": "TUxBUFNBTmU5Nzk2",
    "name": "Santa Fe"
  },
  {
    "id": "TUxBUFNBTm9lOTlk",
    "name": "Santiago del Estero"
  },
  {
    "id": "TUxBUFRJRVoxM2M5YQ",
    "name": "Tierra del Fuego"
  },
  {
    "id": "TUxBUFRVQ244NmM3",
    "name": "Tucumán"
  },
  {
    "id": "TUxBUFVTQWl1cXdlMg",
    "name": "USA"
  },
  {
    "id": "TUxBUFVSVXllZDVl",
    "name": "Uruguay"
  }
  ]
}

Explorar información de estados

Recurso:

https://api.mercadolibre.com/classified_locations/states/{State_id}

Ejemplo:

curl -X GET  https://api.mercadolibre.com/classified_locations/states/TUxBUENBUGw3M2E1

Respuesta:

{
  "id": "TUxBUENBUGw3M2E1",
  "name": "Capital Federal",
  "country": {
    "id": "AR",
    "name": "Argentina"
  },
  "geo_information": {
    "location": {
      "latitude": -34.6143048,
      "longitude": -58.4401655
    }
  },
  "cities": [
    {
      "id": "TUxBQ0NBUGZlZG1sYQ",
      "name": "Capital Federal"
    }
  ]
}

Explorar información de la ciudad

Recurso:

https://api.mercadolibre.com/classified_locations/cities/{City_id}

Ejemplo:

curl -X GET https://api.mercadolibre.com/classified_locations/cities/TUxBQ0NBUGZlZG1sYQ

Respuesta:

{
  "id": "TUxBQ0NBUGZlZG1sYQ",
  "name": "Capital Federal",
  "state": {
  "id": "TUxBUENBUGw3M2E1",
  "name": "Capital Federal"
  },
  "country": {
  "id": "AR",
  "name": "Argentina"
  },
  "geo_information": {
  "location": {
    "latitude": -34.6084175,
    "longitude": -58.3731613
  }
  },
  "neighborhoods": [
  {
    "id": "TUxBQkFHUjk3NjJa",
    "name": "Agronomía"
  },
  {
    "id": "TUxBQkFMTTMwNTBa",
    "name": "Almagro"
  },
  {
    "id": "TUxBQkJBTDMxMDZa",
    "name": "Balvanera"
  },
  {
    "id": "TUxBQkJBUjM0MDha",
    "name": "Barracas"
  },
  {
    "id": "TUxBQkJBUjQwMDQ3MA",
    "name": "Barrio Norte"
  },
  {
    "id": "TUxBQkJFTDcyNTJa",
    "name": "Belgrano"
  },
  {
    "id": "TUxBQkJFTDkwNjNa",
    "name": "Belgrano Barrancas"
  },
  {
    "id": "TUxBQkJFTDk4MDRa",
    "name": "Belgrano C"
  },
  {
    "id": "TUxBQkJFTDU0ODda",
    "name": "Belgrano Chico"
  },
  {
    "id": "TUxBQkJFTDU5NzNa",
    "name": "Belgrano R"
  },
  {
    "id": "TUxBQkJPRTQ0OTRa",
    "name": "Boedo"
  },
  {
    "id": "TUxBQkJPVDQ2NTFa",
    "name": "Botánico"
  },
  {
    "id": "TUxBQkNBQjM4MDda",
    "name": "Caballito"
  },
  {
    "id": "TUxBQkNIQTM5NjBa",
    "name": "Chacarita"
  },
  {
    "id": "TUxBQkNPRzY5MTZa",
    "name": "Coghlan"
  },
  {
    "id": "TUxBQkNPTDI3NDNa",
    "name": "Colegiales"
    },
  {
    "id": "TUxBQkNPTjgyODY1Mg",
    "name": "Congreso"
  },
  {
    "id": "TUxBQkNPTjExMDBa",
    "name": "Constitución"
  },
  {
    "id": "TUxBQkZMTzMwNzRa",
    "name": "Flores"
  },
  {
    "id": "TUxBQkZMTzg5MjFa",
    "name": "Floresta"
  },
  {
    "id": "TUxBQkxBQjk1ODJa",
    "name": "La Boca"
  },
  {
    "id": "TUxBQkxBUzIxNTJa",
    "name": "Las Cañitas"
  },
  {
    "id": "TUxBQkxJTjEzNTha",
    "name": "Liniers"
  },
  {
    "id": "TUxBQk1BVDMwMDJa",
    "name": "Mataderos"
  },
  {
    "id": "TUxBQk1PTjUxOTJa",
    "name": "Monserrat"
  },
  {
    "id": "TUxBQk1PTjE2OTBa",
    "name": "Monte Castro"
  },
  {
    "id": "TUxBQk5VRTc3MTZa",
    "name": "Nueva Pompeya"
  },
  {
    "id": "TUxBQk7a0TcwOTRa",
    "name": "Núñez"
  },
  {
    "id": "TUxBQk9OQzM1Mjk5Ng",
    "name": "Once"
  },
  {
    "id": "TUxBQlBBTDI1MTVa",
    "name": "Palermo"
  },
  {
    "id": "TUxBQlBBTDg3OTha",
    "name": "Palermo Chico"
  },
  {
    "id": "TUxBQlBBTDg1NjJa",
    "name": "Palermo Hollywood"
  },
  {
    "id": "TUxBQlBBTDgwMjla",
    "name": "Palermo Nuevo"
  },
  {
    "id": "TUxBQlBBTDg3MDda",
    "name": "Palermo Soho"
  },
  {
    "id": "TUxBQlBBTDE5ODla",
    "name": "Palermo Viejo"
  },
  {
    "id": "TUxBQlBBUjQ1NDda",
    "name": "Parque Avellaneda"
  },
  {
    "id": "TUxBQlBBUjUyOTZa",
    "name": "Parque Chacabuco"
  },
  {
      "id": "TUxBQlBBUjYwMzZa",
    "name": "Parque Patricios"
  },
  {
    "id": "TUxBQlBBVDI0ODFa",
    "name": "Paternal"
  },
  {
    "id": "TUxBQlBVRTQ5NjBa",
    "name": "Puerto Madero"
  },
  {
    "id": "TUxBQlJFQzkyMTVa",
      "name": "Recoleta"
  },
  {
    "id": "TUxBQlJFVDgyMDVa",
    "name": "Retiro"
  },
  {
    "id": "TUxBQlNBQTM3Mzda",
    "name": "Saavedra"
  },
  {
    "id": "TUxBQlNBTjkwNTZa",
    "name": "San Cristóbal"
  },
  {
    "id": "TUxBQlNBTjgzMjRa",
    "name": "San Nicolás"
  },
  {
    "id": "TUxBQlNBTjgxMzNa",
    "name": "San Telmo"
  },
  {
    "id": "TUxBQlNBTjEyMjNa",
    "name": "Santa Rita"
  },
  {
    "id": "TUxBQlZFTDIwNDha",
    "name": "Velez Sarsfield"
  },
  {
    "id": "TUxBQlZFUjY3MDFa",
    "name": "Versailles"
  },
  {
    "id": "TUxBQlZJTDQyMjBa",
    "name": "Villa Crespo"
  },
  {
    "id": "TUxBQlZJTDYzNzZa",
    "name": "Villa Devoto"
  },
  {
    "id": "TUxBQlZJTDI1ODla",
    "name": "Villa Gral. Mitre"
  },
  {
    "id": "TUxBQlZJTDQ4MzBa",
    "name": "Villa Lugano"
  },
  {
    "id": "TUxBQlZJTDI3MDJa",
    "name": "Villa Luro"
  },
  {
    "id": "TUxBQlZJTDQyMjFa",
   "name": "Villa Ortúzar"
  },
  {
    "id": "TUxBQlZJTDE2MDBa",
    "name": "Villa Pueyrredón"
  },
  {
    "id": "TUxBQlZJTDM3Mzda",
    "name": "Villa Real"
  },
  {
    "id": "TUxBQlZJTDU5MTFa",
    "name": "Villa Riachuelo"
  },
  {
    "id": "TUxBQlZJTDM5MjZa",
    "name": "Villa Soldati"
  },
  {
    "id": "TUxBQlZJTDcwOTla",
    "name": "Villa Urquiza"
  },
  {
    "id": "TUxBQlZJTDc4MDda",
    "name": "Villa del Parque"
  }
  ]
}

Explorar información de barrios

Recurso:

https://api.mercadolibre.com/classified_locations/neighborhoods/{Neighborhood_Id}

Ejemplo:

curl -X GET https://api.mercadolibre.com/classified_locations/neighborhoods/TUxBQkNBQjM4MDda

Respuesta:

{
  "id": "TUxBQkNBQjM4MDda",
  "name": "Caballito",
  "city": {
  "id": "TUxBQ0NBUGZlZG1sYQ",
  "name": "Capital Federal"
  },
  "state": {
  "id": "TUxBUENBUGw3M2E1",
  "name": "Capital Federal"
  },
  "country": {
  "id": "AR",
  "name": "Argentina"
  },
  "geo_information": {
  "location": {
    "latitude": -34.6166667,
    "longitude": -58.45
  }
  },
  "subneighborhoods": [
  ]
}

Buscar un inmueble por ubicación

Una vez seleccionada la ubicación para tu inmueble, este recurso te permitirá buscar artículos por su ubicación entre un rango de latitud y longitud especificado.

Recurso:

https://api.mercadolibre.com/sites/MLA/search?item_location=lat:{latitude1_latitude2},lon:{longitude1_longitude2}&category={Category_Id}

Ejemplo:
Incluyo la categoría inmuebles en MLA, un rango de ubicación dentro de Buenos Aires, AR y un límite de 2 artículos en los resultados.

curl -X GET https://api.mercadolibre.com/sites/MLA/search?item_location=lat:-37.987148_-30.987148,lon:-57.5483864_-50.5483864&category=MLA1459&limit=2

Respuesta:

{
  "site_id": "MLA",
  "paging": {
  "total": 6246,
  "offset": 0,
  "limit": 2
  },
  "results": [
  {
    "id": "MLA532174177",
    "site_id": "MLA",
    "title": "Casa En Valeria Del Mar (gustavo)",
    "subtitle": null,
    "seller": {
      "id": 156627013,
      "power_seller_status": null,
      "car_dealer": false,
      "real_estate_agency": false
    },
    "price": 750,
    "currency_id": "ARS",
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "classified",
    "listing_type_id": "gold_premium",
    "stop_time": "2015-11-11T16:16:52.000Z",
    "condition": "new",
    "permalink": "http://casa.mercadolibre.com.ar/MLA-532174177-casa-en-valeria-del-mar-gustavo-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/19874-MLA20179087101_102014-I.jpg",
    "accepts_mercadopago": false,
    "installments": null,
    "address": {
      "state_id": "TUxBUENPU2ExMmFkMw",
      "state_name": "Bs.as. Costa Atlántica",
      "city_id": "TUxBQ1ZBTDM4MGFj",
      "city_name": "Valeria del Mar",
      "area_code": "02267",
      "phone1": "15538544"
    },
    "shipping": {
      "free_shipping": false,
      "mode": "not_specified"
    },
    "seller_address": {
      "id": 139563091,
      "comment": "",
      "address_line": "urthubey 1181",
      "zip_code": "7167",
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "state": {
        "id": "AR-B",
        "name": "Buenos Aires"
      },
      "city": {
        "id": "TUxBQ1ZBTDM4MGFj",
        "name": "Valeria del Mar"
      },
      "latitude": "",
      "longitude": ""
    },
    "seller_contact": {
      "contact": "",
      "other_info": "",
      "area_code": "02267",
      "phone": "15538544",
      "area_code2": "",
      "phone2": "",
      "email": "",
      "webpage": ""
    },
    "location": {
      "address_line": "urthubey 1100",
      "zip_code": "",
      "subneighborhood": null,
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxBQ1ZBTDM4MGFj",
        "name": "Valeria del Mar"
      },
      "state": {
        "id": "TUxBUENPU2ExMmFkMw",
        "name": "Bs.as. Costa Atlántica"
      },
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "latitude": -37.137337,
      "longitude": -56.89233
    },
    "attributes": [
      {
        "attribute_group_id": "FIND",
        "id": "MLA1459-INMUEBLE",
        "name": "Inmueble",
        "value_name": "Casa",
        "value_id": "MLA1459-INMUEBLE-CASA",
          "attribute_group_name": "Ficha técnica"
      },
      {
        "attribute_group_id": "FIND",
        "id": "MLA1459-OPERACION",
        "name": "Operación",
        "value_name": "Alquiler Temporario",
        "value_id": "MLA1459-OPERACION-ALQUILER_DE_TEMPORADA",
          "attribute_group_name": "Ficha técnica"
      },
      {
        "attribute_group_id": "FIND",
        "id": "MLA1466-AMBQTY",
        "name": "Ambientes",
        "value_name": "4",
        "value_id": "MLA1466-AMBQTY-4",
          "attribute_group_name": "Ficha tecnica"
      },
      {
          "attribute_group_id": "FIND",
        "id": "MLA1466-MTRS",
        "name": "Superficie cubierta (m²)",
        "value_name": "90",
        "value_id": "",
          "attribute_group_name": "Ficha técnica"
      }
    ],
    "original_price": null,
    "category_id": "MLA50278"
  },
  {
    "id": "MLA532037889",
    "site_id": "MLA",
    "title": "Alquilo Duplex 3 Amb Barrio San Rafael - Mar De Ajo",
    "subtitle": null,
    "seller": {
      "id": 62970704,
      "power_seller_status": null,
      "car_dealer": false,
      "real_estate_agency": false
    },
    "price": 400,
    "currency_id": "ARS",
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "classified",
    "listing_type_id": "gold_premium",
    "stop_time": "2015-11-11T15:49:46.000Z",
    "condition": "used",
    "permalink": "http://casa.mercadolibre.com.ar/MLA-532037889-alquilo-duplex-3-amb-barrio-san-rafael-mar-de-ajo-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/20590-MLA20193199450_112014-I.jpg",
    "accepts_mercadopago": false,
    "installments": null,
    "address": {
      "state_id": "TUxBUENPU2ExMmFkMw",
      "state_name": "Bs.as. Costa Atlántica",
      "city_id": "TUxBQ01BUjNmZDhl",
      "city_name": "Mar de Ajo",
      "area_code": "011",
      "phone1": "15-5919-9616"
    },
    "shipping": {
      "free_shipping": false,
      "mode": "not_specified"
    },
    "seller_address": {
      "id": 152837111,
      "comment": "Duplex 4",
      "address_line": "Daniel Rial 200",
      "zip_code": "7109",
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "state": {
        "id": "AR-B",
        "name": "Buenos Aires"
      },
      "city": {
        "id": "TUxBQ01BUjNmZDhl",
        "name": "Mar de Ajo"
      },
      "latitude": -36.715473,
      "longitude": -56.676258
    },
    "seller_contact": {
      "contact": "",
      "other_info": "",
      "area_code": "011",
      "phone": "15-5919-9616",
      "area_code2": "",
      "phone2": "",
      "email": "",
      "webpage": ""
    },
    "location": {
      "address_line": "Daniel Rial 200",
      "zip_code": "",
        "subneighborhood": null,
      "neighborhood": {
        "id": "",
        "name": ""
      },
      "city": {
        "id": "TUxBQ01BUjNmZDhl",
        "name": "Mar de Ajo"
      },
      "state": {
        "id": "TUxBUENPU2ExMmFkMw",
        "name": "Bs.as. Costa Atlántica"
      },
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "latitude": -36.715473,
      "longitude": -56.676258
    },
    "attributes": [
      {
       "attribute_group_id": "FIND",
        "id": "MLA1459-INMUEBLE",
        "name": "Inmueble",
        "value_name": "Casa",
        "value_id": "MLA1459-INMUEBLE-CASA",
          "attribute_group_name": "Ficha técnica"
      },
      {
       "attribute_group_id": "FIND",
        "id": "MLA1459-OPERACION",
        "name": "Operación",
        "value_name": "Alquiler Temporario",
        "value_id": "MLA1459-OPERACION-ALQUILER_DE_TEMPORADA",
          "attribute_group_name": "Ficha técnica"
      },
      {
        "attribute_group_id": "FIND",
        "id": "MLA1466-AMBQTY",
        "name": "Ambientes",
        "value_name": "3",
        "value_id": "MLA1466-AMBQTY-3",
          "attribute_group_name": "Ficha tecnica"
        },
      {
        "attribute_group_id": "FIND",
        "id": "MLA1466-MTRS",
        "name": "Superficie cubierta (m²)",
        "value_name": "95",
        "value_id": "",
          "attribute_group_name": "Ficha técnica"
      }
      ],
    "original_price": null,
    "category_id": "MLA50278"
  }
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
  "id": "relevance",
  "name": "More relevant"
  },
  "available_sorts": [
  {
    "id": "price_asc",
    "name": "Lower price"
  },
  {
    "id": "price_desc",
    "name": "Higher price"
  }
  ],
  "filters": [
  {
    "id": "category",
    "name": "Categories",
    "type": "text",
    "values": [
      {
        "id": "MLA1459",
        "name": "Inmuebles",
        "path_from_root": [
          {
            "id": "MLA1459",
            "name": "Inmuebles"
          }
        ]
      }
    ]
  }
  ],
  "available_filters": [
  {
    "id": "9991459-AMLA_1459_1",
    "name": "Inmueble",
    "type": "text",
    "values": [
      {
        "id": "9991459-AMLA_1459_1-MMLA12617",
        "name": "Departamentos",
        "results": 2624
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12616",
        "name": "Casas",
        "results": 2597
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12619",
        "name": "Terrenos y Lotes",
        "results": 263
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12777",
        "name": "Tiempo Compartido",
        "results": 184
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA32199",
        "name": "PH",
        "results": 82
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA23362",
        "name": "Locales",
        "results": 45
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12780",
        "name": "Fondo de Comercio",
        "results": 17
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12778",
        "name": "Cocheras",
        "results": 10
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12781",
        "name": "Quintas",
        "results": 8
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12782",
       "name": "Oficinas y Consultorios",
        "results": 4
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12615",
        "name": "Campos",
        "results": 3
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA28331",
          "name": "Depósitos y Galpones",
        "results": 2
      },
      {
        "id": "9991459-AMLA_1459_1-MMLA12618",
        "name": "Otros Inmuebles",
        "results": 407
      }
    ]
  },
  {
    "id": "9991459-AMLA_1459_2",
    "name": "Operación",
    "type": "text",
    "values": [
      {
        "id": "9991459-AMLA_1459_2-MMLA14069",
        "name": "Alquiler Temporario",
        "results": 4794
      },
      {
        "id": "9991459-AMLA_1459_2-MMLA12623",
        "name": "Venta",
        "results": 1199
      },
      {
        "id": "9991459-AMLA_1459_2-MMLA12620",
        "name": "Alquiler",
        "results": 253
      }
    ]
  },
  {
    "id": "state",
    "name": "Location",
    "type": "text",
    "values": [
      {
        "id": "TUxBUENPU2ExMmFkMw",
        "name": "Bs.As. Costa Atlántica",
        "results": 5666
      },
      {
        "id": "TUxBUFVSVXllZDVl",
        "name": "Uruguay",
        "results": 566
      },
      {
        "id": "TUxBUFpPTmFpbnRl",
        "name": "Buenos Aires Interior",
        "results": 14
      }
    ]
  },
  {
    "id": "price",
    "name": "Price range",
    "type": "range",
      "values": [
      {
        "id": "*-700.0",
        "name": "Up to $700",
        "results": 2043
      },
      {
        "id": "700.0-8000.0",
        "name": "$700 to $8.000",
        "results": 2013
      },
      {
        "id": "8000.0-*",
        "name": "More than $8.000",
        "results": 2190
      }
    ]
  },
  {
    "id": "159-MTRSTOTAL",
    "name": "Metros totales",
    "type": "range",
    "values": [
      {
        "id": "*-35.0",
       "name": "Up to 35 m²",
        "results": 1078
      },
      {
        "id": "35.0-65.0",
        "name": "35 to 65m²",
        "results": 1397
      },
      {
        "id": "65.0-100.0",
        "name": "65 to 100m²",
        "results": 1065
      },
      {
        "id": "100.0-300.0",
        "name": "100 to 300m²",
        "results": 1285
      },
      {
        "id": "300.0-*",
        "name": "More than 300m²",
        "results": 1421
      }
    ]
  },
  {
    "id": "159-AMBQTY",
    "name": "Cant. de ambientes",
    "type": "text",
    "values": [
      {
        "id": "159-AMBQTY-1",
        "name": "1 ambiente",
        "results": 381
      },
      {
        "id": "159-AMBQTY-2",
        "name": "2 ambientes",
        "results": 1425
      },
      {
        "id": "159-AMBQTY-3",
        "name": "3 ambientes",
        "results": 1820
      },
      {
        "id": "159-AMBQTY-4",
        "name": "4 ambientes",
        "results": 859
      }
    ]
  },
  {
    "id": "159-GARAGE",
    "name": "Cochera/s",
    "type": "text",
    "values": [
      {
        "id": "159-GARAGE-1",
        "name": "1 cochera",
        "results": 2250
      },
      {
        "id": "159-GARAGE-2",
        "name": "2 cocheras",
        "results": 351
      },
      {
        "id": "159-GARAGE-3",
        "name": "3 cocheras",
        "results": 74
      },
      {
        "id": "159-GARAGE-4_O_MAS",
        "name": "4 o más cocheras",
        "results": 150
      }
    ]
  },
  {
    "id": "159-AIRCEN",
    "name": "Aire acondicionado central",
    "type": "boolean",
    "values": [
      {
        "id": "159-AIRCEN-YES",
        "name": "Con aire acondicionado central",
        "results": 517
      }
    ]
  },
  {
    "id": "159-ALAR",
    "name": "Alarma",
    "type": "boolean",
    "values": [
      {
        "id": "159-ALAR-YES",
        "name": "Con Alarma",
        "results": 774
      }
    ]
  },
  {
    "id": "real_estate_agency",
    "name": "Real estate agency filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "Real estate agency",
        "results": 910
      }
    ]
  },
  {
    "id": "condition",
    "name": "Condition filter",
    "type": "text",
    "values": [
      {
        "id": "new",
        "name": "New",
        "results": 795
      },
      {
        "id": "used",
        "name": "Used",
        "results": 5124
      }
    ]
  },
  {
    "id": "power_seller",
    "name": "Seller quality filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "Best sellers",
        "results": 23
      }
    ]
  },
  {
    "id": "buying_mode",
    "name": "Buying mode filter",
    "type": "text",
    "values": [
      {
        "id": "buy_it_now",
        "name": "Buy it now",
        "results": 6246
      }
    ]
  },
  {
    "id": "since",
    "name": "Auction start date filter",
    "type": "text",
    "values": [
      {
        "id": "today",
        "name": "Starting today",
        "results": 117
      }
    ]
  },
  {
    "id": "until",
    "name": "Auction stop filter",
    "type": "text",
    "values": [
      {
        "id": "today",
        "name": "Ending today",
        "results": 22
      }
    ]
  },
  {
    "id": "has_video",
    "name": "Video publications filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "Publications with video",
        "results": 200
     }
    ]
  },
  {
    "id": "has_pictures",
    "name": "Items with images filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "With pictures",
        "results": 6177
      }
    ]
  }
  ]
}



Siguiente:
Gestiona paquetes.

Please rate this

Selección de tipo de operación y propiedad

Las categorías son un conjunto jerárquico de grupos en los cuales se enumeran los publicaciones de naturaleza similar, denominados “Árbol de Categorías”. Las categorías ayudan a los usuarios a buscar fácilmente el tipo de publicación que desean.
Cada sitio tiene su propio conjunto de categorías, es decir que Argentina tendrá un conjunto único de categorías, diferente de las que encontrarás en Brasil, porque cada país tiene sus propias particularidades en el mercado clasificados. https://api.mercadolibre.com/sites/MLB/categories
Antes de publicar un publicación, debes explorar la estructura de categorías y elegir en cuál deseas publicar. Para ayudarte, puedes descargar la jerarquía completa de categorías con ID y nombres fáciles desde nuestra API.
Para publicar un inmueble, deberás seleccionar el category_id según el tipo de operación y propiedad.

Contenidos:

Categorías por Site

El recurso Sites puede ofrecerte la estructura de categorías para un país en particular, en este caso Argentina.

https://api.mercadolibre.com/sites/MLA/categories
{
	"id": "MLA5725",
	"name": "Accesorios para Vehículos"
  },
  {
	"id": "MLA1071",
	"name": "Animales y Mascotas"
  },
  {
	"id": "MLA1367",
	"name": "Antigüedades"
  },
  {
	"id": "MLA1368",
	"name": "Arte y Artesanías"
  },
  {
	"id": "MLA1743",
	"name": "Autos, Motos y Otros"
  },
  {
	"id": "MLA1384",
	"name": "Bebés"
  },
  {
	"id": "MLA1051",
	"name": "Celulares y Teléfonos"
  },
  {
	"id": "MLA1798",
	"name": "Coleccionables y Hobbies"
  },
  {
	"id": "MLA1648",
	"name": "Computación"
  },
  {
	"id": "MLA1144",
	"name": "Consolas y Videojuegos"
  },
  {
	"id": "MLA1039",
	"name": "Cámaras y Accesorios"
  },
  {
	"id": "MLA1403",
	"name": "Delicatessen y Vinos"
  },
  {
	"id": "MLA1276",
	"name": "Deportes y Fitness"
  },
  {
	"id": "MLA5726",
	"name": "Electrodomésticos y Aires Ac."
  },
  {
	"id": "MLA1000",
	"name": "Electrónica, Audio y Video"
  },
  {
	"id": "MLA2547",
	"name": "Entradas para Eventos"
  },
  {
	"id": "MLA1574",
	"name": "Hogar, Muebles y Jardín"
  },
  {
	"id": "MLA1499",
	"name": "Industrias y Oficinas"
  },
  {
	"id": "MLA1459",
	"name": "Inmuebles"
  }

Para categorías de segundo nivel o información relacionada con categorías específicas, debes utilizar el recurso Categorías y enviar el ID de categoría como parámetro URL.
Veamos qué encontramos en la categoría “Inmuebles”:

https://api.mercadolibre.com/categories/MLA1459
{
  "id": "MLA1459",
  "name": "Inmuebles",
  "picture": "http://resources.mlstatic.com/category/images/cc0eed64-9cfb-4b78-9258-6266475f6427.png",
  "permalink": "http://www.mercadolibre.com.ar/inmuebles/",
  "total_items_in_this_category": 109788,
  "path_from_root": [
	{
  	"id": "MLA1459",
  	"name": "Inmuebles"
	}
  ],
  "children_categories": [
	{
  	"id": "MLA374730",
  	"name": "Camas Náuticas",
  	"total_items_in_this_category": 56
	},
	{
  	"id": "MLA1496",
  	"name": "Campos",
  	"total_items_in_this_category": 747
	},
	{
      "id": "MLA1466",
  	"name": "Casas",
  	"total_items_in_this_category": 29579
	},
	{
  	"id": "MLA50541",
  	"name": "Cocheras",
  	"total_items_in_this_category": 1659
	},
	{
  	"id": "MLA1472",
  	"name": "Departamentos",
  	"total_items_in_this_category": 43732
	},
	{
  	"id": "MLA1475",
  	"name": "Depósitos y Galpones",
  	"total_items_in_this_category": 1474
	},
	{
  	"id": "MLA50545",
  	"name": "Fondo de Comercio",
  	"total_items_in_this_category": 1925
	},
	{
  	"id": "MLA79242",
  	"name": "Locales",
  	"total_items_in_this_category": 2533
	},
	{
  	"id": "MLA50538",
  	"name": "Oficinas y Consultorios",
  	"total_items_in_this_category": 2711
	},
	{
  	"id": "MLA1892",
  	"name": "Otros Inmuebles",
  	"total_items_in_this_category": 2236
	},
	{
  	"id": "MLA105179",
  	"name": "PH",
  	"total_items_in_this_category": 3066
	},
	{
  	"id": "MLA50544",
  	"name": "Parcelas, Nichos y Bóvedas",
  	"total_items_in_this_category": 230
	},
	{
  	"id": "MLA50547",
  	"name": "Quintas",
  	"total_items_in_this_category": 1828
	},
	{
  	"id": "MLA1493",
  	"name": "Terrenos y Lotes",
  	"total_items_in_this_category": 17463
	},
	{
  	"id": "MLA50536",
  	"name": "Tiempo Compartido",
  	"total_items_in_this_category": 566
	}
  ],
  "attribute_types": "attributes",
  "settings": {
	"adult_content": false,
	"buying_allowed": false,
	"buying_modes": [
  	"classified"
    ],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"new",
  	"not_specified",
  	"used"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"custom",
  	"not_specified"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": false,
	"maximum_price": null,
	"minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": true
}

Obtienes los atributos “path_from_root” y children_categories. Utiliza estos atributos para explorar el árbol de categorías y encontrar la categoría específica para tu publicación.
Como puedes ver, las categorías se basan en tipos de propiedad seguidas, en primer lugar, por tipo de operación. Debes seleccionar la categoría hijo.

Ejemplo:

https://api.mercadolibre.com/categories/MLA79242

Respuesta:

{
  "id": "MLA79242",
  "name": "Locales",
  "picture": "http://resources.mlstatic.com/category/images/f1f2bbe1-b5d4-45b1-9b9c-ac142b6bc64f.png",
  "permalink": null,
  "total_items_in_this_category": 2533,
  "path_from_root": [
	{
  	"id": "MLA1459",
  	"name": "Inmuebles"
	},
	{
  	"id": "MLA79242",
  	"name": "Locales"
	}
  ],
  "children_categories": [
	{
  	"id": "MLA79243",
  	"name": "Alquiler",
  	"total_items_in_this_category": 1332
	},
	{
  	"id": "MLA79244",
  	"name": "Venta",
  	"total_items_in_this_category": 1197
	}
  ],
  "attribute_types": "attributes",
  "settings": {
	"adult_content": false,
	"buying_allowed": false,
	"buying_modes": [
  	"classified"
    ],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"not_specified",
  	"used",
  	"new"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"custom",
  	"not_specified"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": false,
	"maximum_price": null,
	"minimum_price": null
  },
  "meta_categ_id": 23362,
  "attributable": false
}

En este caso, las children_categories son “Venta” y “Alquiler”. Puedes publicar tu inmueble en la que más te convenga.

Categorías JSON

Realizar una llamada a una categoría en particular te permitirá conocer sus atributos. A continuación encontrarás una descripción de algunos de estos atributos. Al realizar una solicitud GET al category_id, encontrarás todos los atributos disponibles y puedes saber si son obligatorios u opcionales para publicar en la categoría.

Ejemplo:

https://api.mercadolibre.com/categories/MLA79243

Respuesta:

{
  "id": "MLA79243",
  "name": "Alquiler",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 1332,
  "path_from_root": [
	{
  	"id": "MLA1459",
  	"name": "Inmuebles"
	},
	{
  	"id": "MLA79242",
  	"name": "Locales"
	},
	{
  	"id": "MLA79243",
  	"name": "Alquiler"
	}
  ],
  "children_categories": [
  ],
  "attribute_types": "attributes",
  "settings": {
	"adult_content": false,
	"buying_allowed": false,
	"buying_modes": [
  	"classified"
	],
	"coverage_areas": "not_allowed",
	"currencies": [
  	"ARS",
  	"USD"
	],
	"fragile": false,
	"immediate_payment": "optional",
	"item_conditions": [
  	"new",
  	"not_specified",
  	"used"
	],
	"items_reviews_allowed": false,
	"max_description_length": 50000,
	"max_pictures_per_item": 15,
	"max_sub_title_length": 70,
	"max_title_length": 200,
	"price": "required",
	"restrictions": [
	],
	"rounded_address": true,
	"seller_contact": "optional",
	"shipping_modes": [
  	"not_specified",
  	"custom"
	],
	"shipping_options": [
	],
	"shipping_profile": "not_allowed",
	"show_contact_information": true,
	"simple_shipping": "not_allowed",
	"stock": "required",
	"tags": [
	],
	"vip_subdomain": "inmueble",
	"mirror_category": null,
	"listing_allowed": true,
	"maximum_price": 250000,
	"minimum_price": 100
  },
  "meta_categ_id": 12620,
  "attributable": false
}

Atributos específicos de las categorías

Para conocer los atributos específicos y valores posibles de las categorías que debes enviar para publicar un publicación, consulta el recurso atributos:

Ejemplo:

https://api.mercadolibre.com/categories/MLA79243/attributes
{
	"id": "MLA1459-INMUEBLE",
	"name": "Inmueble",
	"value_type": "list",
	"tags": {
  	"fixed": true,
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA1459-INMUEBLE-LOCALES",
    	"name": "Locales"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA1459-OPERACION",
	"name": "Operación",
    "value_type": "list",
	"tags": {
  	"fixed": true,
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA1459-OPERACION-ALQUILER",
    	"name": "Alquiler"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-ANTIG",
	"name": "Antigüedad",
	"value_type": "list",
	"tags": {
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA79242-ANTIG-A_ESTRENAR",
    	"name": "A estrenar"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_5_ANOS",
    	"name": "Max 5 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_10_ANOS",
    	"name": "Max 10 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_20_ANOS",
    	"name": "Max 20 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_30_ANOS",
    	"name": "Max 30 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAX_40_ANOS",
    	"name": "Max 40 años"
  	},
  	{
    	"id": "MLA79242-ANTIG-MAS_DE_40_ANOS",
        "name": "Más de 40 años"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-BATHQTY",
	"name": "Baños",
	"value_type": "list",
	"tags": {
  	"required": true
	},
    "values": [
  	{
    	"id": "MLA79242-BATHQTY-1",
    	"name": "1"
  	},
  	{
    	"id": "MLA79242-BATHQTY-2",
    	"name": "2"
  	},
  	{
    	"id": "MLA79242-BATHQTY-3",
    	"name": "3"
  	},
  	{
    	"id": "MLA79242-BATHQTY-4",
    	"name": "4"
  	},
  	{
    	"id": "MLA79242-BATHQTY-MAS_DE_4",
    	"name": "Más de 4"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-ESTADO",
	"name": "Estado",
	"value_type": "list",
	"tags": {
  	"required": true
	},
	"values": [
  	{
    	"id": "MLA79242-ESTADO-A_REFACCIONAR",
    	"name": "A refaccionar"
  	},
  	{
    	"id": "MLA79242-ESTADO-BUENO",
        "name": "Bueno"
  	},
  	{
    	"id": "MLA79242-ESTADO-EXCELENTE",
    	"name": "Excelente"
  	},
  	{
    	"id": "MLA79242-ESTADO-MUY_BUENO",
    	"name": "Muy bueno"
  	},
  	{
    	"id": "MLA79242-ESTADO-REGULAR",
    	"name": "Regular"
  	}
	],
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-SUPCONSCL",
	"name": "Superficie construida (m²)",
	"value_type": "number",
	"value_max_length": 60,
	"tags": {
  	"required": true
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-SUPTOTMX",
	"name": "Superficie total (m²)",
	"value_type": "number",
	"value_max_length": 60,
	"tags": {
  	"required": true
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA1459-HORPREF",
	"name": "Horario de contacto",
	"value_type": "string",
	"value_max_length": 60,
	"tags": {
	},
	"attribute_group_id": "FIND",
	"attribute_group_name": "Ficha técnica"
  },
  {
	"id": "MLA79242-PISOSQTY",
	"name": "Plantas",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-PISOSQTY-1",
    	"name": "1"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-2",
    	"name": "2"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-3",
    	"name": "3"
  	},
  	{
    	"id": "MLA79242-PISOSQTY-MAS_DE_3",
    	"name": "Más de 3"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-LOCALI",
	"name": "Localización",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LOCALI-A_LA_CALLE",
    	"name": "A la calle"
  	},
  	{
    	"id": "MLA79242-LOCALI-CENTRO_COMERCIAL",
    	"name": "Centro comercial"
  	},
  	{
    	"id": "MLA79242-LOCALI-GALERIA",
    	"name": "Galería"
  	},
  	{
    	"id": "MLA79242-LOCALI-SHOPPING",
    	"name": "Shopping"
  	},
  	{
    	"id": "MLA79242-LOCALI-OTRO_LUGAR",
    	"name": "Otro lugar"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-AGUACORR",
	"name": "Agua Corriente",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-AGUACORR-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-AGUACORR-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-AIRACON",
	"name": "Aire acondicionado",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-AIRACON-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-AIRACON-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ALARSEG",
	"name": "Alarma de seguridad",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ALARSEG-N",
    	"name": "No"
  	},
  	{
        "id": "MLA79242-ALARSEG-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ELEVATOR",
	"name": "Ascensor",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ELEVATOR-SI",
    	"name": "Sí"
  	},
  	{
    	"id": "MLA79242-ELEVATOR-NO",
    	"name": "No"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-CALEF",
	"name": "Calefacción",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-CALEF-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-CALEF-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "GARAGE",
	"name": "Cocheras",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "GARAGE-6a020b",
    	"name": "No tiene"
  	},
  	{
    	"id": "GARAGE-c4ca42",
    	"name": "1"
  	},
  	{
    	"id": "GARAGE-c81e72",
    	"name": "2"
  	},
  	{
    	"id": "GARAGE-eccbc8",
    	"name": "3"
  	},
  	{
    	"id": "GARAGE-a87ff6",
    	"name": "4"
  	},
  	{
    	"id": "GARAGE-caf5ad",
    	"name": "Más de 4"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-COCINA",
	"name": "Cocina",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-COCINA-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-COCINA-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-INTERNET",
	"name": "Conexión a Internet",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-INTERNET-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-INTERNET-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-DEPOSITO",
	"name": "Depósito",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-DEPOSITO-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-DEPOSITO-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-ENTREPISO",
	"name": "Entrepiso",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-ENTREPISO-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-ENTREPISO-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-EXPENCEM",
	"name": "Expensas ($)",
	"value_type": "string",
	"value_max_length": 60,
	"tags": {
	},
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-GRUPOELEC",
	"name": "Grupo eletrógeno",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-GRUPOELEC-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-GRUPOELEC-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-LUMINOS",
	"name": "Luminosidad",
	"value_type": "list",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LUMINOS-BUENA",
    	"name": "Buena"
  	},
  	{
    	"id": "MLA79242-LUMINOS-MUY_BUENA",
    	"name": "Muy buena"
  	},
  	{
    	"id": "MLA79242-LUMINOS-REGULAR",
	    "name": "Regular"
  	}
	],
	"attribute_group_id": "ADICIONALES",
	"attribute_group_name": "Adicionales"
  },
  {
	"id": "MLA79242-LINTELEF",
	"name": "Línea telefónica",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-LINTELEF-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-LINTELEF-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-SISTINCEN",
	"name": "Sistema contra incendio",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-SISTINCEN-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-SISTINCEN-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-TVCABLE",
	"name": "TV por cable",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-TVCABLE-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-TVCABLE-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  },
  {
	"id": "MLA79242-VESTU",
	"name": "Vestuario",
	"value_type": "boolean",
	"tags": {
	},
	"values": [
  	{
    	"id": "MLA79242-VESTU-N",
    	"name": "No"
  	},
  	{
    	"id": "MLA79242-VESTU-Y",
    	"name": "Sí"
  	}
	],
	"attribute_group_id": "CARACTERISTICAS",
	"attribute_group_name": "Caracteristicas Adicionales"
  }

Nombre

Este atributo muestra un nombre corto. Con solo leer el JSON anterior sabes que, por ejemplo, se trata de una categoría de clasificados que no permite incluir opciones de envío, existen 1332 publicaciones publicados en la misma y puedes incluir el precio en ARS o USD.

Atributos obligatorios

Los atributos obligatorios se configuran como “required” en el detalle de la categoría. En el ejemplo anterior, puedes ver que precio y stock son obligatorios; no se permiten las áreas de cobertura y el seller_contact es opcional. Además, atributos específicos de la categoría, como los atributos “Antigüedad” y “Estado”, que tienen el tag “required”: verdadero, se deben enviar con los valores posibles detallados en el JSON.

Descarga de categorías

El árbol de categorías no cambia con mucha frecuencia. Si prefieres, puedes solicitar el volcado de todo el árbol de categorías para el sitio de un país determinado destinado al procesamiento offline. La API devuelve el árbol de categorías en formato JSON dentro de una respuesta codificada con gzip.Para obtener las categorías de Brasil, utiliza este URL:

~$ curl  	https://api.mercadolibre.com/sites/MLB/categories/all

Para obtener las categorías de Argentina, utiliza este URL:

~$ curl  	https://api.mercadolibre.com/sites/MLA/categories/all

Este URL contiene 2 encabezados que se pueden utilizar para verificar cuándo se generó el último volcado.
● X-Content-Created [contenido X creado]: contiene la fecha de la última generación.
● X-Content-MD5: contiene la suma de comprobación MD5 de la última generación.

~$ curl -I  https://api.mercadolibre.com/sites/MLB/categories/all
HTTP/1.1 200 OK
Server: nginx/1.0.4
Date: Tue, 24 Jul 2012 15:14:58 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
X-MLAPI-Version: 1.9.5
Content-Encoding: gzip
X-Content-Created: 2012-07-24T14:00:59.716Z
X-Content-MD5: 943541196986770119b4af1e66bda2dc

Elige la categoría para tu propiedad

Elegir la categoría correcta para tu inmueble determinará la rapidez con que los compradores la encontrarán y mejorará tus posibilidades de venderla. Por este motivo, te recomendamos utilizar nuestra herramienta de predicción de Categorías antes de publicar un publicación.

Búsqueda por categoría

La operación de búsqueda devuelve publicaciones que pertenecen a una categoría de publicación de MercadoLibre; si bien pueden haber toneladas de publicaciones en ciertas categorías, no te preocupes: puedes paginar los resultados. Lee sobre paginación de los resultados de búsqueda.
Para acceder a todos los publicaciones en una categoría determinada, tienes que hacer lo siguiente:

curl -X GET https://api.mercadolibre.com/sites/MLA/search?category=MLA5726

La respuesta de búsqueda tiene gran cantidad de parámetros. Utiliza el método OPCIONES http para obtener una respuesta codificada con JSON que describirá la API, con todos los métodos y conexiones permitidos entre otra parte de la API. https://api.mercadolibre.com/sites/MLA/search/.

Paginación y dimensionamiento de resultados

Este tutorial te será útil de ahora en adelante porque te ayudará a trabajar con conjuntos específicos de resultados cada vez que realices una llamada a la API. La mayoría de los recursos presentan parámetros url comunes para paginar y dimensionar resultados: limit y offset.

limit

Valores por defecto

Los valores por defecto son offset=0 y limit=50.

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano

En la sección de paginación de la respuesta JSON, puedes ver la cantidad total de publicaciones que coinciden con la búsqueda y el valor de offset con el limit por defecto aplicado.

.....
  "paging": {
	"total": 285,
	"offset": 0,
	"limit": 50,
  }
  .....

Limit

Para reducir el tamaño de página, puedes cambiar el parámetro de limit. Por ejemplo, si estás interesado en recuperar solo los primeros 3 publicaciones:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&limit=3

Esta acción recupera un dato JSON con un conjunto de 3 publicaciones, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 284,
	"offset": 0,
	"limit": 3,
  },
  "results": [
	{...},
	{...},
	{...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Offset

Al utilizar el atributo offset, puedes mover el límite inferior del bloque de resultados. Por ejemplo, si te interesa recuperar los 50 publicaciones que siguen la respuesta por defecto:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=50
{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 285,
	"offset": 50,
	"limit": 50,
  },
  "results": [...],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}

Esta respuesta recupera 50 publicaciones a partir de los primeros cincuenta.

Definir un rango de resultados

Es posible combinar ambos parámetros. Puedes recuperar publicaciones desde el tercero al sexto en el resultado de búsqueda original:

curl https://api.mercadolibre.com/sites/MLA/search?q=ipod nano&offset=3&limit=3

Esta acción recupera un dato JSON con un conjunto de 5 publicaciones, como se ilustra a continuación:

{
  "site_id": "MLA",
  "query": "ipod nano",
  "paging": {
	"total": 285,
	"offset": 3,
	"limit": 3,
  },
  "results": [
	{...},
	{...},
	{...},
  ],
  "sort": {...},
  "available_sorts": [...],
  "filters": [...],
  "available_filters": [...],
}https://api.mercadolibre.com/sites/MLA/search/



Siguiente:
Localiza artículos.

Please rate this

Consulta usuarios

Si ya lograste registrar tu aplicación, autenticarte y generar un usuario de Test, el siguiente paso a seguir es aprender a trabajar con usuarios (vendedores y compradores):

Contenidos:

Registrarme como inmobiliaria (Opcional)

Si eres una inmobiliaria, puedes registrar tu usuario como tal para obtener acceso a nuestros paquetes promocionales para inmobiliarias. Para hacerlo, accede a la sección Ayuda > Configuración de mi cuenta > Registrarme como empresa, concesionaria e inmobiliaria.

Screenshot_4
Una vez allí, haz clic en la pestaña “Tus datos y registración” y luego, en el link “Registrarme como inmobiliaria”. A este paso no se puede acceder a través de la API, pero podrás verlo una vez que te registres como inmobiliaria.

Consultar mis datos personales

Si te encuentras logueado en MercadoLibre y tienes un token podrás hacer la siguiente llamada y conocer qué información se encuentra relacionada a tu usuario:

Ejemplo:

curl  - X GET https://api.mercadolibre.com/users/me?access_token=$ACCESS_TOKEN

Respuesta:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
  "type": "DNI",
  "number": "1111111"
  },
  "address": {
  "state": "AR-C",
  "city": "Palermo",
  "address": "Test Address 123",
  "zip_code": "1414"
  },
  "phone": {
  "area_code": "01",
  "number": "1111-1111",
  "extension": "",
  "verified": false
  },
  "alternative_phone": {
  "area_code": "",
  "number": "",
  "extension": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
  "real_estate_agency",
  "test_user",
  "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
  "custom",
  "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
  "level_id": null,
  "power_seller_status": null,
  "transactions": {
    "period": "historic",
    "total": 0,
    "completed": 0,
    "canceled": 0,
    "ratings": {
      "positive": 0,
      "negative": 0,
      "neutral": 0
    }
  }
  },
  "buyer_reputation": {
  "canceled_transactions": 0,
  "transactions": {
    "period": "historic",
    "total": null,
    "completed": null,
    "canceled": {
      "total": null,
      "paid": null
    },
    "unrated": {
      "total": null,
      "paid": null
    },
    "not_yet_rated": {
      "total": null,
      "paid": null,
      "units": null
    }
  },
  "tags": [
  ]
  },
  "status": {
  "site_status": "active",
  "list": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
      ]
    }
  },
  "buy": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
     ]
    }
  },
  "sell": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
      ]
    }
  },
  "billing": {
    "allow": true,
    "codes": [
    ]
  },
  "mercadopago_tc_accepted": true,
  "mercadopago_account_type": "personal",
  "mercadoenvios": "not_accepted",
  "immediate_payment": false,
  "confirmed_email": false,
  "user_type": "eventual",
  "required_action": ""
  },
  "credit": {
  "consumed": 100,
  "credit_level_id": "MLA1"
  }
}

Consultar datos de usuarios terceros

Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtenerlo con la siguiente búsqueda:

Llamada:

https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Ejemplo:

https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Respuesta:

{
  "site_id": "MLA",
  "seller": {
  "id": 202593498,
  "seller_reputation": {
    "power_seller_status": null
  },
  "real_estate_agency": false,
  "car_dealer": false,
  "tags": [
  ]
  }

Si deseas consultar los datos de usuarios terceros, podrás identificar dos niveles de información: los datos públicos, aquellos que puedes encontrar navegando el perfil en MercadoLibre de cualquier otro usuario y los datos privados, que no serán visibles a menos que tengas los permisos del usuario y un token válido para trabajar en su nombre.
En ambos casos, lo primero que deberás conocer es el id del usuario.

¿Cómo obtener el Id de un usuario?

Si no tienes el id, pero conoces el nickname y el site al que pertenece un usuario, podrás obtener su Id con la siguiente búsqueda:

Llamada:

https://api.mercadolibre.com/sites/{Site_id}/search?nickname={Nickname}

Ejemplo:

https://api.mercadolibre.com/sites/MLA/search?nickname=TETE2870021

Respuesta:

{
  "site_id": "MLA",
  "seller": {
  "id": 202593498,
  "seller_reputation": {
    "power_seller_status": null
  },
  "real_estate_agency": false,
  "car_dealer": false,
  "tags": [
  ]
  },
  "paging": {
  "total": 2,
  "offset": 0,
  "limit": 50
  },
  "results": [
  {
    "id": "MLA598903377",
    "site_id": "MLA",
    "title": "Test Item - Nao Ofertar",
    "subtitle": null,
    "seller": {
      "id": 202593498,
      "power_seller_status": null,
      "car_dealer": false,
      "real_estate_agency": false,
      "tags": [
      ]
    },
    "price": 200,
    "currency_id": "ARS",
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "buy_it_now",
    "listing_type_id": "bronze",
    "stop_time": "2016-03-06T17:16:49.000Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-598903377-test-item-nao-ofertar-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/546311-MLA20539702714_012016-I.jpg",
    "accepts_mercadopago": true,
    "installments": {
      "quantity": 6,
      "amount": 42.33,
      "currency_id": "ARS"
    },
    "address": {
      "state_id": "AR-C",
      "state_name": "Capital Federal",
      "city_id": "",
      "city_name": "Palermo"
    },
    "shipping": {
      "free_shipping": false,
      "mode": "not_specified"
    },
    "seller_address": {
      "id": 175597910,
      "comment": "",
      "address_line": "",
      "zip_code": "",
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "state": {
        "id": "AR-C",
        "name": "Capital Federal"
      },
      "city": {
        "id": "",
        "name": "Palermo"
     },
      "latitude": -34.571148,
      "longitude": -58.423298
    },
    "attributes": [
    ],
    "original_price": null,
    "category_id": "MLA374515",
    "official_store_id": null
  },
  {
    "id": "MLA599121050",
    "site_id": "MLA",
    "title": "Item De Test - No Ofertar",
    "subtitle": null,
    "seller": {
      "id": 202593498,
      "power_seller_status": null,
      "car_dealer": false,
      "real_estate_agency": false,
      "tags": [
      ]
    },
    "price": 1000,
    "currency_id": "ARS",
    "available_quantity": 1,
    "sold_quantity": 0,
    "buying_mode": "buy_it_now",
    "listing_type_id": "bronze",
    "stop_time": "2016-03-07T20:12:41.000Z",
    "condition": "new",
    "permalink": "http://articulo.mercadolibre.com.ar/MLA-599121050-item-de-test-no-ofertar-_JM",
    "thumbnail": "http://mla-s2-p.mlstatic.com/493311-MLA20538550251_012016-I.jpg",
    "accepts_mercadopago": true,
    "installments": {
      "quantity": 6,
        "amount": 211.65,
      "currency_id": "ARS"
    },
    "address": {
      "state_id": "AR-C",
      "state_name": "Capital Federal",
      "city_id": "",
      "city_name": "Palermo"
    },
    "shipping": {
      "free_shipping": false,
      "mode": "not_specified"
    },
    "seller_address": {
      "id": 175597910,
      "comment": "",
      "address_line": "",
      "zip_code": "",
      "country": {
        "id": "AR",
        "name": "Argentina"
      },
      "state": {
        "id": "AR-C",
        "name": "Capital Federal"
      },
      "city": {
        "id": "",
        "name": "Palermo"
      },
      "latitude": -34.571148,
      "longitude": -58.423298
    },
    "attributes": [
    ],
    "original_price": null,
    "category_id": "MLA90105",
    "official_store_id": null
  }
  ],
  "secondary_results": [
  ],
  "related_results": [
  ],
  "sort": {
  "id": "relevance",
  "name": "More relevant"
  },
  "available_sorts": [
  {
   "id": "price_asc",
    "name": "Lower price"
  },
  {
    "id": "price_desc",
    "name": "Higher price"
  }
  ],
  "filters": [
  ],
  "available_filters": [
  {
    "id": "category",
    "name": "Categories",
    "type": "text",
    "values": [
      {
        "id": "MLA1648",
        "name": "Computación",
        "results": 1
      },
      {
        "id": "MLA1430",
        "name": "Ropa y Accesorios",
        "results": 1
      }
    ]
  },
  {
    "id": "state",
    "name": "Location",
    "type": "text",
    "values": [
      {
        "id": "TUxBUENBUGw3M2E1",
        "name": "Capital Federal",
        "results": 2
      }
    ]
  },
  {
    "id": "accepts_mercadopago",
   "name": "MercadoPago filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "With MercadoPago",
        "results": 2
      }
    ]
  },
  {
    "id": "installments",
    "name": "Pago",
    "type": "text",
    "values": [
      {
        "id": "yes",
        "name": "Installments",
        "results": 2
      },
      {
        "id": "no_interest",
        "name": "Sin interés",
        "results": 0
      }
    ]
  },
  {
    "id": "condition",
    "name": "Condition filter",
    "type": "text",
    "values": [
      {
        "id": "new",
        "name": "New",
        "results": 2
      }
    ]
  },
  {
    "id": "buying_mode",
    "name": "Buying mode filter",
    "type": "text",
    "values": [
      {
        "id": "buy_it_now",
        "name": "Buy it now",
        "results": 2
      }
    ]
  },
  {
    "id": "has_pictures",
    "name": "Items with images filter",
    "type": "boolean",
    "values": [
      {
        "id": "yes",
        "name": "With pictures",
        "results": 2
      }
    ]
  }
  ]
}

Consultar información pública de un usuario

Muy bien, de ésta manera ya conoces el Id del usuario, por lo cual puedes realizar la llamada al recurso de users de la siguiente manera y obtener la información pública del usuario que deseas:

Llamada:

curl GET -X  https://api.mercadolibre.com/users/{User_id}

Ejemplo:

GET -X  https://api.mercadolibre.com/users/202593498

Respuesta:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "country_id": "AR",
  "address": {
    "state": "AR-C",
  "city": "Palermo"
  },
  "user_type": "normal",
  "tags": [
  "normal",
  "test_user",
  "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "seller_reputation": {
  "level_id": null,
  "power_seller_status": null,
  "transactions": {
    "period": "historic",
    "total": 0,
    "completed": 0,
    "canceled": 0,
    "ratings": {
      "positive": 0,
      "negative": 0,
      "neutral": 0
    }
  }
  },
  "buyer_reputation": {
  "tags": [
  ]
  },
  "status": {
  "site_status": "active"
  }
}

Consultar información privada de un usuario que ha aceptado el uso de mi aplicación

Para obtener los datos privados de un usuario, solo debes apendar el ACCESS_TOKEN del usuario al final de la llamada que realizaste anteriormente.

Llamada:

curl GET -X  https://api.mercadolibre.com/users/{User_id}?access_token=¢ACCESS_TOKEN

Ejemplo:

curl GET -X  https://api.mercadolibre.com/users/202593498?access_token=¢ACCESS_TOKEN

Respuesta:

{
  "id": 202593498,
  "nickname": "TETE2870021",
  "registration_date": "2016-01-06T11:31:42.000-04:00",
  "first_name": "Test",
  "last_name": "Test",
  "country_id": "AR",
  "email": "test_user_50698062@testuser.com",
  "identification": {
  "type": "DNI",
  "number": "1111111"
  },
  "address": {
  "state": "AR-C",
  "city": "Palermo",
  "address": "Test Address 123",
  "zip_code": "1414"
  },
  "phone": {
  "area_code": "01",
  "number": "1111-1111",
  "extension": "",
  "verified": false
  },
  "alternative_phone": {
  "area_code": "",
  "number": "",
  "extension": ""
  },
  "user_type": "real_estate_agency",
  "tags": [
  "real_estate_agency",
  "test_user",
  "user_info_verified"
  ],
  "logo": null,
  "points": 100,
  "site_id": "MLA",
  "permalink": "http://perfil.mercadolibre.com.ar/TETE2870021",
  "shipping_modes": [
  "custom",
  "not_specified"
  ],
  "seller_experience": "ADVANCED",
  "seller_reputation": {
  "level_id": null,
  "power_seller_status": null,
  "transactions": {
    "period": "historic",
    "total": 0,
    "completed": 0,
    "canceled": 0,
    "ratings": {
      "positive": 0,
      "negative": 0,
      "neutral": 0
    }
  }
  },
  "buyer_reputation": {
  "canceled_transactions": 0,
  "transactions": {
    "period": "historic",
    "total": null,
    "completed": null,
    "canceled": {
      "total": null,
      "paid": null
    },
    "unrated": {
      "total": null,
      "paid": null
    },
    "not_yet_rated": {
      "total": null,
      "paid": null,
      "units": null
    }
  },
  "tags": [
  ]
  },
  "status": {
  "site_status": "active",
  "list": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
      ]
    }
  },
  "buy": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
      ]
    }
  },
  "sell": {
    "allow": true,
    "codes": [
    ],
    "immediate_payment": {
      "required": false,
      "reasons": [
      ]
    }
  },
  "billing": {
    "allow": true,
    "codes": [
    ]
  },
  "mercadopago_tc_accepted": true,
  "mercadopago_account_type": "personal",
  "mercadoenvios": "not_accepted",
  "immediate_payment": false,
  "confirmed_email": false,
  "user_type": "eventual",
  "required_action": ""
  },
  "credit": {
  "consumed": 100,
  "credit_level_id": "MLA1"
  }
}

Puedes observar que esta vez obtuviste mayor cantidad de datos del usuario: Su nombre completo, email, teléfono, domicilio, etc. Te solicitamos que no reveles estos datos públicamente ya que pueden comprometer al usuario.

Actualizar datos de usuario

Puedes utilizar nuestros recursos para actualizar tu información de usuario después del registro. Es un tema común, porque en esta instancia no se te solicita que completes tu domicilio o identificación personal, pero debes tenerlos completos o no podrás publicar artículos en MercadoLibre.
Para actualizar tu información de usuario sigue el ejemplo:

curl -X PUT -H "Content-Type: application/json" -d
{
"identification_type": "DNI",
"identification_number": "33333333",
"address": "Triunvirato 5555",
"state":"AR-C",
"city":"Capital Federal",
"zip_dode": "1431",
"phone":{
        "area_code":"011",
        "number":"4444-4444",
        "extension":"001"
      },
"first_name":"Pedro",
"last_name": "Picapiedras",
"company":{
          "corporate_name":"Acme",
          "brand_name":"Acme Company"
        },
"mercadoenvios": "accepted"
}

https://api.mercadolibre.com/users/{User_id}?access_token=

¡Felicitaciones, actualizaste tu información de usuario! Recuerda enviar solamente los campos que deseas actualizar.

  • Usuario Vendedor S = P (sell equal pay)
  • Códigos de error comunes

    206 – Partial content: en algunos casos, el recurso de la API de Usuarios devolverá un código 206 – Partial content. Esto ocurrirá cuando falle la solicitud a algunos de los datos (por ejemplo, reputación del usuario) para informarte que recibirás una respuesta incompleta.



    Artículos relacionados:
    Direcciones del usuario.


    Siguiente:
    Selección de tipo de operación y propiedad.

    Please rate this

    Autenticación y Autorización

    La plataforma de Mercado Libre te permite trabajar con recursos públicos y privados de la API a través de llamadas HTTP con los verbos GET, PUT, POST, DELETE y OPTIONS.
    El acceso a los recursos públicos, tales como sites y categories disponibles, se puede hacer en forma anónima pero los recursos privados y las acciones propias de los usuarios como publicar un artículo, responder preguntas o ver la información de ventas/compras requieren autorización mediante una aplicación.
    Por tal motivo en la siguiente guía te explicaremos el significado de autenticación y el flujo de autorización que se debe seguir para obtener un access_token (llave de acceso a los recursos privados por cada usuario que autorice la aplicación- válida por 6 horas).
    Por ejemplo:
    Sin access_token (Recurso público)

    https://api.mercadolibre.com/users/226384143/
    
    {
      "id": 226384143,
      "nickname": "TETE9928972",
      "registration_date": "2016-08-25T11:36:00.000-04:00",
      "country_id": "AR",
      "address": {
        "state": "AR-C",
        "city": "Palermo"
      },
      "user_type": "normal",
      "tags": [
        "normal",
        "test_user",
        "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "period": "historic",
          "total": 1,
          "completed": 1,
          "canceled": 0,
          "ratings": {
            "positive": 0,
            "negative": 0,
            "neutral": 1
          }
        }
      },
      "buyer_reputation": {
        "tags": [
        ]
      },
      "status": {
        "site_status": "active"
      }
    }


    Con access_token (Recurso privado)

     
     https://api.mercadolibre.com/users/226384143?access_token=$ACCESS_TOKEN
    
    {
      "id": 226384143,
      "nickname": "TETE9928972",
      "registration_date": "2016-08-25T11:36:00.000-04:00",
      "first_name": "Test",
      "last_name": "Test",
      "country_id": "AR",
      "email": "test_user_38730994@testuser.com",
      "identification": {
        "type": "DNI",
        "number": "1111111"
      },
      "address": {
        "state": "AR-C",
        "city": "Palermo",
        "address": "Test Address 123",
        "zip_code": "1414"
      },
      "phone": {
        "area_code": "01",
        "number": "1111-1111",
        "extension": "",
        "verified": false
      },
      "alternative_phone": {
        "area_code": "",
        "number": "",
        "extension": ""
      },
      "user_type": "normal",
      "tags": [
        "normal",
        "test_user",
        "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE9928972",
      "shipping_modes": [
        "custom",
        "not_specified"
      ],
      "seller_experience": "ADVANCED",
      "bill_data": {
        "accept_credit_note": null
      },
      "seller_reputation": {
        "level_id": null,
        "power_seller_status": null,
        "transactions": {
          "period": "historic",
          "total": 1,
          "completed": 1,
          "canceled": 0,
          "ratings": {
            "positive": 0,
            "negative": 0,
            "neutral": 1
          }
        }
      },
      "buyer_reputation": {
        "canceled_transactions": 0,
        "transactions": {
          "period": "historic",
          "total": null,
          "completed": null,
          "canceled": {
            "total": null,
            "paid": null
          },
          "unrated": {
            "total": null,
            "paid": null
          },
          "not_yet_rated": {
            "total": null,
            "paid": null,
            "units": null
          }
        },
        "tags": [
        ]
      },
      "status": {
        "site_status": "active",
        "list": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "buy": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "sell": {
          "allow": true,
          "codes": [
          ],
          "immediate_payment": {
            "required": false,
            "reasons": [
            ]
          }
        },
        "billing": {
          "allow": true,
          "codes": [
          ]
        },
        "mercadopago_tc_accepted": true,
        "mercadopago_account_type": "personal",
        "mercadoenvios": "not_accepted",
        "immediate_payment": false,
        "confirmed_email": false,
        "user_type": "simple_registration",
        "required_action": ""
      },
      "credit": {
        "consumed": 101.1,
        "credit_level_id": "MLA1"
      }
    }

    Contenidos:

    Autenticación

    La autenticación es el acto o proceso para el establecimiento o confirmación de algo o alguien como real.
    En el caso de la autenticación de una persona consiste en verificar su identidad en función a uno o varios factores asegurando que los datos de quién los envió sean los correctos.

    Algunos métodos de autenticación son:

    • Biomédicas, por huellas dactilares, retina del ojo, etc.
    • Tarjetas inteligentes que guardan información de los certificados de un usuario.
    • Métodos clásicos basados en contraseña.
    • Por ejemplo, para ingresar a Mercado Libre nos autenticamos a través del login (usuario y contraseña).

    login

    Autorización

    La autorización es el proceso por el cual permitimos a alguien o a algo acceder a recursos privados.
    Dentro de la autorización se deberá definir qué recursos y qué operaciones se pueden realizar ya que no es lo mismo otorgar permisos de sólo lectura, que lectura y escritura.

    ¿Cómo logramos la autorización? A través del Protocolo OAuth 2.0, uno de los más utilizados en plataforma abiertas (Twitter, Facebook, etc.) y método seguro para trabajar con recursos privados.

    OAuth nos brinda:

    • Confidencialidad, el usuario no deberá revelar su clave en ningún momento.
    • Integridad, sólo podrán ver datos privados aquellas aplicaciones que tengan el permiso de hacerlo.
    • Disponibilidad, los datos siempre estarán disponibles en el momento que se necesiten.

    Dentro de este protocolo existen 4 modos de funcionamiento posibles denominados Grant Types:

    – The Authorization Code Grant Type (Server Side)
    – The Implicit Grant Type (Client Side)
    – The Password Credentials Grant Type
    – The Client Credentials Grant Type

    Si bien cada uno de ellos es utilizado para diferentes propósitos dependiendo del servicio que se está construyendo a continuación sólo explicaremos los dos primeros ya que son los que te permitirán trabajar con nuestros recursos y generar herramientas para todos los usuarios de Mercado Libre.

    Client-side

    El flujo de autorización Client side es el adecuado para las aplicaciones que ejecutan código del lado del cliente, por ejemplo aplicaciones desarrolladas en lenguaje javascript/ajax, Angular o aplicaciones mobile.
    Para conocer más detalles sobre este flujo te sugerimos ir al tutorial “Autorización Client-Side

    Server-side

    El flujo de autorización Server side es el más adecuado para las aplicaciones que ejecutan código del lado del servidor, por ejemplo aplicaciones desarrolladas en lenguaje como Java, Grails, Go, etc.

    Nota: Esta opción te será de utilidad para aplicaciones que ejecutan cron jobs para actualizar stock de productos u operar sin que un usuario esté interactuando directamente con la aplicación.
    Si deseas conocer más detalles sobre este flujo te sugerimos ir al tutorial “Autorización Server-Side

    ¡Obtén tu access_token!

    Introduzca el ID de la aplicación que acaba de crear:

    *Please enter a valid Application ID
    Información del usuarioJSON Response

    -

    Uso de nuestros SDK

    Mediante el uso de nuestros SDKs el proceso de autorización será más simple ya que te ahorrará la codificación de todo el protocolo OAuth de cero.
    ¡Nuestra comunidad ya los está utilizando!
    Ofrecemos SDK para:

    Si descubres una mejora o sugerencia puedes brindarla a la comunidad generando un Pull Request dentro de nuestro repositorio GitHub.

    Consideraciones

    Validez y expiración de tokens
    Cuando obtienes un access_token, será válido de inmediato y se podrá utilizar para realizar solicitudes a la API durante un período limitado de 6 horas.
    Existen eventos que pueden invalidar un access_token antes del tiempo de expiración. Por ejemplo: cambio de contraseña por parte del usuario, la actualización del App Secret por parte de una aplicación y, por supuesto, la revocación de permisos a tu aplicación por parte del usuario.

    Referencia de códigos de error

    Error Mensaje de error Posible solución
    invalid_client

    client_id o client_secret inválido.

    El client_id y/o client_secret provisto es inválido. Controla la información de tu aplicación y verifica los parámetros client_id y client_secret
    invalid_grant

    Para crear un access token el usuario {0} debe tener una sesión activa o tu aplicación debe solicitar autorización para el alcance offline_access.

    El otorgamiento de la autorización provista es inválido, expiró, fue revocado o no coincide con el URI de redireccionamiento utilizado en la solicitud de autorización. Verifica que el parámetro redirect_uri sea el mismo configurado en tu aplicación (Administrador de Aplicaciones); si esto no resuelve el problema, realiza una nueva solicitud para obtener un código nuevo.
    invalid_grant

    Error en la validación del otorgamiento. Es posible que tu código de autorización o refresh token haya expirado o que ya haya sido utilizado.

    Expiró o ya fue utilizado. Realiza una nueva solicitud para obtener un nuevo código o refresh_token.
    invalid_grant

    El client_id no coincide con el original.

    El ID de cliente no coincide. No se encontró el parámetro client_id; para obtener tu client_id, consulta tu aplicación (Administrador de Aplicaciones).
    invalid_grant

    El redirect_uri no coincide con el original.

    El URl de redireccionamiento no coincide con el original. El parámetro redirect_uri no es el mismo configurado en tu aplicación; para obtener un redirect_uri, consulta tu aplicación (Administrador de Aplicaciones)
    invalid_scope

    Alcance inválido.

    El alcance solicitado es inválido, desconocido o está mal formado. Los valores permitidos para el parámetro alcance son: “offline_access”,”write”,”read”.
    invalid_request

    Cantidad incorrecta de parámetros con valores duplicados.

    La solicitud no incluye un parámetro obligatorio, incluye un parámetro o valor de parámetro no soportado o está mal formada de otro modo. Verifica que los parámetros enviados sean válidos y no estén duplicados.
    unsupported_grant_type

    Tipo de otorgamiento no soportado: ${0}.

    El server de autorización no soporta el tipo de otorgamiento. Los valores permitidos para grant_type son “authorization_code” o “refresh_token”.
    forbidden

    La llamada no autorizada acceder a este recurso.

    La llamada no autoriza el acceso Se está utilizando el token de otro usuario.



    Artículos relacionados:
    Server side
    Client side


    Siguiente:
    Consulta usuarios.

    Please rate this

    Gestiona contactos y visitas

    Cuando los usuarios buscan en los artículos clasificados, pueden contactar al propietario del artículo a través de un formulario que se muestra en la publicación o pueden ver el teléfono del propietario.
    Existe una diferencia respecto del funcionamiento entre los usuarios que iniciaron sesión y los usuarios invitados. Cuando los usuarios invitados realizan una pregunta sobre tu artículo, el contacto se dirige directamente al buzón de entrada de tu correo electrónico y se mostrará en nuestro recurso de contacts, porque no sigue el flujo de preguntas habitual. Cuando un usuario que tiene cuenta en nuestro sitio e inició sesión realiza una pregunta, sigue el flujo de preguntas habitual y puedes utilizar el recurso de questions.

    Para ver cómo trabajar con preguntas de usuarios que iniciaron sesión, consulta nuestra guía de Administración de preguntas y respuestas.

    Guía de contactos clasificados

    Esta guía te ayudará a recolectar datos sobre preguntas y visualizaciones del teléfono en tus artículos clasificados. Se trata de una API de solo lectura, muy útil para llevar métricas de tus artículos clasificados. Puedes consultar datos sobre preguntas y llevar un registro de cuántas veces se hizo clic en la opción ‘Ver teléfono’. Puedes consultar por usuario, artículo, fechas y períodos de tiempo.

    Contenidos:

    Descripción de parámetros

    Tipo Parámetro Descripción
    Entero {userId} ID de usuario.
    Entero {itemId} ID de artículo.
    Fecha {dateFrom} Fecha, en formato ISO, que define el inicio de la consulta.
    Fecha {dateTo} Fecha, en formato ISO, que define el fin de la consulta.
    Entero {limit} Opcional. Cantidad máxima de artículos a devolver.
    Entero {offset} Opcional. Paginación.
    Entero {last} Opcional. Denota cuántas horas/días atrás cubrirá la muestra.
    Cadena {unit} Unidad de consulta, valores posibles: [“día”, “hora”].
    Fecha {ending} Opcional. Fecha, en formato ISO, que establece el tiempo de finalización de la muestra; por defecto es la fecha y hora actuales.
    Cadena {order} Opcional. Clasifica los resultados por fecha: [“desc”, “asc”] (por defecto es “asc”).

    Contactos totales

    Puedes acceder a las preguntas totales que tuvo un artículo o las preguntas totales que tuvo un vendedor en todos sus artículos en un rango de fechas.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions?date_from={Date_from}&date_to={Date_to}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/MLV421672596/contacts/questions?date_from=2014-08-01T00:00:00.000-03:00&date_to=2014-08-02T23:59:59.999

    Respuesta:

    {
    	"date_from": "2014-08-01T00:00:00.000-03:00",
    	"date_to": "2014-08-02T23:59:59.999",
    	"item_id": "MLV421672596",
    	"total": 9
    }

    Contactos con fecha

    Este recurso te permite acceder a las preguntas sobre un artículo específico o por vendedor para un período de tiempo específico. Además, accedes a detalles sobre contactos realizados en modo invitado (usuarios que no iniciaron sesión o que no están registrados) entre intervalos de tiempo, por hora o por día.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?last={Last}&unit={Unit}

    Si necesitas concatenar artículos, haz lo siguiente:

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/questions/time_window?ids={id1,id2}&last={Last}&unit={Unit}&ending={Ending_date}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/questions/time_window?last={Last}&unit={Unit}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/MLA510272257/contacts/questions/time_window?last=2&unit=hour

    Respuesta:

    {
    	"item_id": "MLA510272257",
    	"total": 0,
    	"date_from": "2014-08-06T12:00:00Z",
    	"date_to": "2014-08-06T14:00:00Z",
    	"last": 2,
    	"unit": "hour",
    	"results": [
        	{
            	"date": "2014-08-06T12:00:00Z",
            	"total": 0
        	},
        	{
          	  "date": "2014-08-06T13:00:00Z",
            	"total": 0
        	}
    	]
    }

    Clicks en teléfonos de contacto

    Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario en rangos de fechas.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views?date_from={Date_from}&date_to={Date_to}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/users/52366166/contacts/phone_views?date_from=2014-05-28T00:00:00.000-03:00&date_to=2014-05-29T23:59:59.999

    Respuesta:

    {
    	"date_from": "2014-05-28T00:00:00.000-03:00",
    	"date_to": "2014-05-29T23:59:59.999",
    	"total": 71,
    	"user_id": "52366166"
    }

    Click en teléfonos de contacto con fecha

    Puedes acceder a la cantidad total de veces que se hizo clic en la opción ‘Ver teléfono’ de un artículo o para cada artículo de un usuario durante cierto período de tiempo. Además de entregar las visitas totales, la información se detalla y agrupa por intervalo de tiempo.

    Por artículo

    curl -X GET https://api.mercadolibre.com/items/{Item_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

    Si necesitas concatenar artículos:

    curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids={Id1,Id2}&last={Last}&unit={Unit}&ending={Ending_date}

    Por usuario

    curl -X GET https://api.mercadolibre.com/users/{User_id}/contacts/phone_views/time_window?last={Last}&unit={Unit}

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/items/contacts/phone_views/time_window?ids=MLA510272257,MLA489747739&last=2&unit=hour&ending=2014-05-28T00:00:00.000-03:00

    Respuesta:

    [
    	{
        	"item_id": "MLA510272257",
        	"total": 0,
        	"date_from": "2014-05-28T02:00:00Z",
        	"date_to": "2014-05-28T04:00:00Z",
        	"last": 2,
        	"unit": "hour",
        	"results": [
            	{
                	"date": "2014-05-28T02:00:00Z",
                	"total": 0
            	},
            	{
                	"date": "2014-05-28T03:00:00Z",
                	"total": 0
            	}
        	]
    	},
    	{
        	"item_id": "MLA489747739",
        	"total": 0,
        	"date_from": "2014-05-28T02:00:00Z",
      	  "date_to": "2014-05-28T04:00:00Z",
        	"last": 2,
        	"unit": "hour",
        	"results": [
            	{
                	"date": "2014-05-28T02:00:00Z",
                	"total": 0
            	},
            	{
                	"date": "2014-05-28T03:00:00Z",
                	"total": 0
            	}
        	]
    	}
    ]



    Siguiente:
    Recibe notificaciones.

    Please rate this

    Consultas avanzadas

    Si tu intención es que vendedores usen la aplicación que desarrollaste para potenciar su negocio, ten en cuenta que hay muchísima información de mercado que puedes consumir y será fructífera para ayudar a que vendedores creen estrategias de venta y tomen decisiones acertadas a tiempo. También podrías desarrollar un sistema que compare precios y atributos entre distintos tipos de anuncios.

    ¡Sigue nuestras guías para aprender a sacarle provecho a cada recurso!

    Ayuda a tus anunciantes a estar siempre un paso adelante en sus negocios. En primer lugar debes saber que no podrás obtener datos privados sobre usuarios que no han dado permisos a tu aplicación. Sin embargo, hay datos públicos que puedes obtener sobre éstos usuarios como quienes publican en las mismas categorías que tu, la cantidad de anuncios publicados, qué precios y atributos manejan en sus anuncios, en qué categorías publican y cuántos contactos y visitas reciben por día.

    Con tu sistema, puedes sugerir a los vendedores cuál es mejor precio para vender sus productos y mantener tu competitividad al analizar el precio del mismo tipo de productos publicados en MercadoLibre. Para hacerlo, es conveniente aprender cómo buscar artículos por categoría, consultar el campo precio de esos artículos y calcular el promedio.

    También puedes desarrollar un sistema que analice los precios y atributos de los artículos del mercado clasificados para que los compradores puedan comparar, localizar y encontrar exactamente lo que están buscando.


    Para aprender a utilizar los recursos que te ayudarán a hacerlo sigue las siguientes guías:

    Please rate this

    Guía para Inmuebles

    Los inmuebles son publicaciones de clasificados donde los datos de contacto de los vendedores son públicos, lo que facilita a los compradores comunicarse con los vendedores directamente, y el pago y las condiciones de contratación se coordinan entre las contrapartes sin oferta de por medio.

    Puedes crear aplicaciones que publiquen inmuebles y tomen métricas de los contactos, realicen búsquedas por geolocalización, comparen precios y prestaciones, guarden favoritos, envíen recordatorios, sugieran similares, etc.



    Siguiente:
    Autorización para trabajar con nuestra API.

    Please rate this