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.


Siguiente:

Por favor califica del 1 al 5

Elige tipo de servicio

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 vehículo, deberás seleccionar el category_id según el tipo de operación y propiedad.

Contenidos:

  • Categorías por Site
  • Categorías JSON
  • Volcado de categorías
  • Selección de categorías
  • Búsqueda por Categoría
  • Paginación y dimensionamiento de resultados

Categorías por Site

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

curl -X GET https://api.mercadolibre.com/sites/MLA/categories

Respuesta:

"categories": [
{
"id": "MLA5725",
"name": "Accesorios para Vehiculos",
},
{
"id": "MLA1071",
"name": "Animales y Mascotas",
},
{
"id": "MLA1367",
"name": "Antigüedades",
},
{
"id": "MLA1743",
"name": "Autos, Motos y Otros",
},

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 “Servicios”:
Ejemplo:

curl -X GET https://api.mercadolibre.com/categories/MLA1071

Respuesta:

{
  "id": "MLA1540",
  "name": "Servicios",
  "picture": "http://resources.mlstatic.com/category/images/3b5619b2-cc62-4775-8e64-05a1e5585bba.png",
  "permalink": "http://www.mercadolibre.com.ar/servicios/",
  "total_items_in_this_category": 33783,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    }
  ],
  "children_categories": [
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine",
      "total_items_in_this_category": 1134
    },
    {
      "id": "MLA10514",
      "name": "Belleza y Cuidado Personal",
      "total_items_in_this_category": 1029
    },
    {
      "id": "MLA43986",
      "name": "Cursos y Clases",
      "total_items_in_this_category": 1188
    },
    {
      "id": "MLA91058",
      "name": "Delivery",
      "total_items_in_this_category": 338
    },
    {
      "id": "MLA1550",
      "name": "Fiestas y Eventos",
      "total_items_in_this_category": 6840
    },
    {
      "id": "MLA122258",
      "name": "Hogar",
      "total_items_in_this_category": 4067
    },
    {
      "id": "MLA56666",
      "name": "Imprenta",
      "total_items_in_this_category": 717
    },
    {
      "id": "MLA9007",
      "name": "Mantenimiento de Vehículos",
      "total_items_in_this_category": 1980
    },
    {
      "id": "MLA111029",
      "name": "Medicina y Salud",
      "total_items_in_this_category": 641
    },
    {
      "id": "MLA113657",
      "name": "Oficios",
      "total_items_in_this_category": 1994
    },
    {
      "id": "MLA1898",
      "name": "Otros Servicios",
      "total_items_in_this_category": 2842
    },
    {
      "id": "MLA1541",
      "name": "Profesionales",
      "total_items_in_this_category": 2106
    },
    {
      "id": "MLA91088",
      "name": "Ropa y Moda",
      "total_items_in_this_category": 515
    },
    {
      "id": "MLA11813",
      "name": "Servicio Técnico",
      "total_items_in_this_category": 3916
    },
    {
      "id": "MLA11798",
      "name": "Servicios para Mascotas",
      "total_items_in_this_category": 653
    },
    {
      "id": "MLA91083",
      "name": "Servicios para Oficinas",
      "total_items_in_this_category": 262
    },
    {
      "id": "MLA9038",
      "name": "Transporte",
      "total_items_in_this_category": 2316
    },
    {
      "id": "MLA1229",
      "name": "Viajes y Turismo",
      "total_items_in_this_category": 1218
    }
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": false,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

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.

curl https://api.mercadolibre.com/categories/MLA58257
{
  "id": "MLA58257",
  "name": "Estudios de Grabación",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 37,
  "path_from_root": [
    {
      "id": "MLA1540",
      "name": "Servicios"
    },
    {
      "id": "MLA122264",
      "name": "Arte, Música y Cine"
    },
    {
      "id": "MLA94730",
      "name": "Música"
    },
    {
      "id": "MLA58257",
      "name": "Estudios de Grabación"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "none",
  "settings": {
    "adult_content": false,
    "buying_allowed": true,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "optional",
    "currencies": [
      "ARS",
      "USD"
    ],
    "fragile": false,
    "immediate_payment": "optional",
    "item_conditions": [
      "not_allowed"
    ],
    "items_reviews_allowed": true,
    "max_description_length": 50000,
    "max_pictures_per_item": 12,
    "max_sub_title_length": 70,
    "max_title_length": 60,
    "price": "optional",
    "restrictions": [
    ],
    "rounded_address": false,
    "seller_contact": "required",
    "shipping_modes": [
      "not_specified",
      "custom"
    ],
    "shipping_options": [
    ],
    "shipping_profile": "not_allowed",
    "show_contact_information": true,
    "simple_shipping": "not_allowed",
    "stock": "optional",
    "tags": [
    ],
    "vip_subdomain": "servicio",
    "mirror_category": null,
    "listing_allowed": true,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": null,
  "attributable": false
}

Ahora veamos la llamada de una categoría:

Ejemplo:

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

Respuesta:

{
  "id": "MLA24272",
  "name": "Ecosport",
  "picture": null,
  "permalink": null,
  "total_items_in_this_category": 2806,
  "path_from_root": [
    {
      "id": "MLA1743",
      "name": "Autos, Motos y Otros"
    },
    {
      "id": "MLA1744",
      "name": "Autos y Camionetas"
    },
    {
      "id": "MLA3180",
      "name": "Ford"
    },
    {
      "id": "MLA24272",
      "name": "Ecosport"
    }
  ],
  "children_categories": [
  ],
  "attribute_types": "attributes",
  "settings": {
    "adult_content": false,
    "buying_allowed": false,
    "buying_modes": [
      "classified"
    ],
    "coverage_areas": "not_allowed",
    "currencies": [
      "USD",
      "ARS"
    ],
    "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": 60,
    "price": "required",
    "restrictions": [
    ],
    "rounded_address": false,
    "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": "auto",
    "mirror_category": null,
    "listing_allowed": true,
    "maximum_price": null,
    "minimum_price": null
  },
  "meta_categ_id": 30745,
  "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/MLA24272/attributes

Respuesta:

 {
    "id": "MLA1744-MARC",
    "name": "Marca",
    "value_type": "list",
    "tags": {
      "fixed": true,
      "required": true
    },
    "values": [
      {
        "id": "MLA1744-MARC-FORD",
        "name": "Ford"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-MODL",
    "name": "Modelo",
    "value_type": "list",
    "tags": {
      "fixed": true,
      "required": true
    },
    "values": [
      {
        "id": "MLA1744-MODL-ECOSPORT",
        "name": "Ecosport"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-DOOR",
    "name": "Cant. de puertas",
    "value_type": "list",
    "tags": {
      "required": true
    },
    "values": [
      {
        "id": "MLA1744-DOOR-2",
        "name": "2"
      },
      {
        "id": "MLA1744-DOOR-3",
        "name": "3"
      },
      {
        "id": "MLA1744-DOOR-4",
        "name": "4"
      },
      {
        "id": "MLA1744-DOOR-5",
        "name": "5"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-COMBUS",
    "name": "Combustible",
    "value_type": "list",
    "tags": {
      "required": true
    },
    "values": [
      {
        "id": "MLA1744-COMBUS-DIESEL",
        "name": "Diesel"
      },
      {
        "id": "MLA1744-COMBUS-NAFTA",
        "name": "Nafta"
      },
      {
        "id": "MLA1744-COMBUS-NAFTAGNC",
        "name": "Nafta/Gnc"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-KMTS",
    "name": "Kilómetros",
    "value_type": "number",
    "value_max_length": 60,
    "tags": {
      "required": true
    },
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-YEAR",
    "name": "Año",
    "value_type": "list",
    "tags": {
      "required": true
    },
    "values": [
      {
        "id": "MLA1744-YEAR-95192c",
        "name": "2016"
      },
      {
        "id": "a9f0a06",
        "name": "2015"
      },
      {
        "id": "MLA1744-YEAR-2014",
        "name": "2014"
      },
      {
        "id": "MLA1744-YEAR-2013",
        "name": "2013"
      },
      {
        "id": "MLA1744-YEAR-2012",
        "name": "2012"
      },
      {
        "id": "MLA1744-YEAR-2011",
        "name": "2011"
      },
      {
        "id": "MLA1744-YEAR-2010",
        "name": "2010"
      },
      {
        "id": "MLA1744-YEAR-2009",
        "name": "2009"
      },
      {
        "id": "MLA1744-YEAR-2008",
        "name": "2008"
      },
      {
        "id": "MLA1744-YEAR-2007",
        "name": "2007"
      },
      {
        "id": "MLA1744-YEAR-2006",
        "name": "2006"
      },
      {
        "id": "MLA1744-YEAR-2005",
        "name": "2005"
      },
      {
        "id": "MLA1744-YEAR-2004",
        "name": "2004"
      },
      {
        "id": "MLA1744-YEAR-2003",
        "name": "2003"
      },
      {
        "id": "MLA1744-YEAR-2002",
        "name": "2002"
      },
      {
        "id": "MLA1744-YEAR-2001",
        "name": "2001"
      },
      {
        "id": "MLA1744-YEAR-2000",
        "name": "2000"
      },
      {
        "id": "MLA1744-YEAR-1999",
        "name": "1999"
      },
      {
        "id": "MLA1744-YEAR-1998",
        "name": "1998"
      },
      {
        "id": "MLA1744-YEAR-1997",
        "name": "1997"
      },
      {
        "id": "MLA1744-YEAR-1996",
        "name": "1996"
      },
      {
        "id": "MLA1744-YEAR-1995",
        "name": "1995"
      },
      {
        "id": "MLA1744-YEAR-1994",
        "name": "1994"
      },
      {
        "id": "MLA1744-YEAR-1993",
        "name": "1993"
      },
      {
        "id": "MLA1744-YEAR-1992",
        "name": "1992"
      },
      {
        "id": "MLA1744-YEAR-1991",
        "name": "1991"
      },
      {
        "id": "MLA1744-YEAR-1990",
        "name": "1990"
      },
      {
        "id": "MLA1744-YEAR-1989",
        "name": "1989"
      },
      {
        "id": "MLA1744-YEAR-1988",
        "name": "1988"
      },
      {
        "id": "MLA1744-YEAR-1987",
        "name": "1987"
      },
      {
        "id": "MLA1744-YEAR-1986",
        "name": "1986"
      },
      {
        "id": "MLA1744-YEAR-1985",
        "name": "1985"
      },
      {
        "id": "MLA1744-YEAR-1984",
        "name": "1984"
      },
      {
        "id": "MLA1744-YEAR-1983",
        "name": "1983"
      },
      {
        "id": "MLA1744-YEAR-1982",
        "name": "1982"
      },
      {
        "id": "MLA1744-YEAR-1981",
        "name": "1981"
      },
      {
        "id": "MLA1744-YEAR-1980",
        "name": "1980"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-CAJACD",
    "name": "Caja de CD",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CAJACD-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CAJACD-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA24272-VERS",
    "name": "Versión",
    "value_type": "list",
    "tags": {
    },
    "values": [
      {
        "id": "MLA0150027005-MLA24272",
        "name": "1.4 TDI XL Plus % MP3"
      },
      {
        "id": "MLA0150027033-MLA24272",
        "name": "1.4 TDI XL Plus MP3 (L08)"
      },
      {
        "id": "MLA0150027006-MLA24272",
        "name": "1.4 TDI XLS MP3"
      },
      {
        "id": "MLA0150027034-MLA24272",
        "name": "1.4 TDI XLS MP3 (L08)"
      },
      {
        "id": "d4de20c",
        "name": "1.6 Nafta S MT5 (110cv)"
      },
      {
        "id": "MLA0150027001-MLA24272",
        "name": "1.6 XL Plus % MP3"
      },
      {
        "id": "MLA0150027010-MLA24272",
        "name": "1.6 XL Plus 2ABG"
      },
      {
        "id": "MLA0150027009-MLA24272",
        "name": "1.6 XL Plus ABG"
      },
      {
        "id": "MLA0150027027-MLA24272",
        "name": "1.6 XL Plus MP3 (L08)"
      },
      {
        "id": "MLA0150027002-MLA24272",
        "name": "1.6 XLS % MP3"
      },
      {
        "id": "MLA0150027011-MLA24272",
        "name": "1.6 XLS ABG"
      },
      {
        "id": "MLA0150027028-MLA24272",
        "name": "1.6 XLS MP3 (L08)"
      },
      {
        "id": "MLA0150027014-MLA24272",
        "name": "1.6 XLS MP3 ABS"
      },
      {
        "id": "MLA0150027022-MLA24272",
        "name": "1.6 XLT"
      },
      {
        "id": "MLA0150027015-MLA24272",
        "name": "1.6 XLT Free Style"
      },
      {
        "id": "MLA0150027038-MLA24272",
        "name": "1.6 XLT Free Style (L08) DICONTINUO"
      },
      {
        "id": "MLA0150027037-MLA24272",
        "name": "1.6 XLT Plus MP3 (L08)"
      },
      {
        "id": "MLA0150027023-MLA24272",
        "name": "1.6 XLT SVP HE - Edic. Limitada"
      },
      {
        "id": "MLA0150027024-MLA24272",
        "name": "1.6 XLT SVP SHE - Edic. Limitada"
      },
      {
        "id": "MLA0150027029-MLA24272",
        "name": "2.0 XLS (L08)"
      },
      {
        "id": "MLA0150027004-MLA24272",
        "name": "2.0 XLT"
      },
      {
        "id": "MLA0150027035-MLA24272",
        "name": "2.0 XLT (L08)"
      },
      {
        "id": "MLA0150027013-MLA24272",
        "name": "2.0 XLT 2ABG"
      },
      {
        "id": "MLA0150027008-MLA24272",
        "name": "2.0 XLT 4X4"
      },
      {
        "id": "MLA0150027007-MLA24272",
        "name": "2.0 XLT 4X4 Plus Cuero"
      },
      {
        "id": "MLA0150027032-MLA24272",
        "name": "2.0 XLT 4X4 Plus Cuero (L08)"
      },
      {
        "id": "MLA0150027012-MLA24272",
        "name": "2.0 XLT ABG"
      },
      {
        "id": "MLA0150027025-MLA24272",
        "name": "2.0 XLT AT"
      },
      {
        "id": "MLA0150027026-MLA24272",
        "name": "2.0 XLT AT Plus Cuero"
      },
      {
        "id": "MLA0150027036-MLA24272",
        "name": "2.0 XLT Night Running (L08) - Edic. Limitada"
      },
      {
        "id": "MLA0150027031-MLA24272",
        "name": "2.0 XLT Plus AT Cuero (L08)"
      },
      {
        "id": "MLA0150027021-MLA24272",
        "name": "2.0 XLT Plus Cuero"
      },
      {
        "id": "MLA0150027030-MLA24272",
        "name": "2.0 XLT Plus Cuero (L08)"
      },
      {
        "id": "ca9d9bf",
        "name": "FreeStyle 1.6L Sigma"
      },
      {
        "id": "a54e5d5",
        "name": "FreeStyle 2.0L Duratec 4WD"
      },
      {
        "id": "07ebca7",
        "name": "S 1.5L Duratorq TDCi"
      },
      {
        "id": "3ad53d4",
        "name": "S 1.6L Sigma"
      },
      {
        "id": "30a9692",
        "name": "SE 1.5L Duratorq TDCi"
      },
      {
        "id": "f1b7b93",
        "name": "SE 1.6L Sigma"
      },
      {
        "id": "ab9e7ab",
        "name": "SE 2.0L Duratec"
      },
      {
        "id": "5d8133e",
        "name": "Titanium 1.6L Sigma"
      },
      {
        "id": "8d53516",
        "name": "Titanium 2.0L Duratec"
      },
      {
        "id": "41d7238",
        "name": "Titanium 2.0L Duratec AT"
      },
      {
        "id": "acb2185",
        "name": "Otras Versiones"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-AIR1",
    "name": "Airbag conductor",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AIR1-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AIR1-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-AIRBAGCORT",
    "name": "Airbag de cortina",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AIRBAGCORT-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AIRBAGCORT-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-AIR3",
    "name": "Airbag laterales",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AIR3-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AIR3-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-AIR2",
    "name": "Airbag pasajero",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AIR2-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AIR2-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-AIRACON",
    "name": "Aire acondicionado",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AIRACON-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AIRACON-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-ALAR",
    "name": "Alarma",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ALAR-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ALAR-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-ALARMLUC",
    "name": "Alarma de luces encendidas",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ALARMLUC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ALARMLUC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-AM_FM",
    "name": "AM/FM",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-AM/FM-N",
        "name": "No"
      },
      {
        "id": "MLA1744-AM/FM-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-APERBAUL",
    "name": "Apertura remota de baúl",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-APERBAUL-N",
        "name": "No"
      },
      {
        "id": "MLA1744-APERBAUL-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-APCABEZA",
    "name": "Apoya cabeza en asientos traseros",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-APCABEZA-N",
        "name": "No"
      },
      {
        "id": "MLA1744-APCABEZA-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-ASREGULA",
    "name": "Asiento conductor regulable en altura",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ASREGULA-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ASREGULA-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-ASREBAT",
    "name": "Asiento trasero rebatible",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ASREBAT-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ASREBAT-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-ASIENELEC",
    "name": "Asientos eléctricos",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ASIENELEC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ASIENELEC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-BLIND",
    "name": "Blindado",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-BLIND-N",
        "name": "No"
      },
      {
        "id": "MLA1744-BLIND-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-BLUETOOTH",
    "name": "Bluetooth",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-BLUETOOTH-N",
        "name": "No"
      },
      {
        "id": "MLA1744-BLUETOOTH-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-CARGADORCD",
    "name": "Cargador de CD",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CARGADORCD-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CARGADORCD-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-REPRODCD",
    "name": "CD",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-REPRODCD-N",
        "name": "No"
      },
      {
        "id": "MLA1744-REPRODCD-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-BLQCNTDOOR",
    "name": "Cierre centralizado de puertas",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-BLQCNTDOOR-N",
        "name": "No"
      },
      {
        "id": "MLA1744-BLQCNTDOOR-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-CLIMAUT",
    "name": "Climatizador automático",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CLIMAUT-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CLIMAUT-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-COLOREXT",
    "name": "Color",
    "value_type": "list",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-COLOREXT-AMARILLO",
        "name": "Amarillo"
      },
      {
        "id": "MLA1744-COLOREXT-AZUL",
        "name": "Azul"
      },
      {
        "id": "MLA1744-COLOREXT-BEIGE",
        "name": "Beige"
      },
      {
        "id": "MLA1744-COLOREXT-BLANCO",
        "name": "Blanco"
      },
      {
        "id": "MLA1744-COLOREXT-BORDO",
        "name": "Bordó"
      },
      {
        "id": "MLA1744-COLOREXT-CELESTE",
        "name": "Celeste"
      },
      {
        "id": "MLA1744-COLOREXT-CHAMPAGNE",
        "name": "Champagne"
      },
      {
        "id": "MLA1744-COLOREXT-GRIS",
        "name": "Gris"
      },
      {
        "id": "MLA1744-COLOREXT-MARRON",
        "name": "Marrón"
      },
      {
        "id": "MLA1744-COLOREXT-NEGRO",
        "name": "Negro"
      },
      {
        "id": "MLA1744-COLOREXT-ORO",
        "name": "Oro"
      },
      {
        "id": "MLA1744-COLOREXT-PLATA",
        "name": "Plata"
      },
      {
        "id": "MLA1744-COLOREXT-ROJO",
        "name": "Rojo"
      },
      {
        "id": "MLA1744-COLOREXT-ROSADO",
        "name": "Rosado"
      },
      {
        "id": "MLA1744-COLOREXT-VERDE",
        "name": "Verde"
      },
      {
        "id": "MLA1744-COLOREXT-OTRO",
        "name": "Otro"
      }
    ],
    "attribute_group_id": "ADICIONALES",
    "attribute_group_name": "Adicionales"
  },
  {
    "id": "MLA1744-COMANDOSAT",
    "name": "Comando satelital de stereo",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-COMANDOSAT-N",
        "name": "No"
      },
      {
        "id": "MLA1744-COMANDOSAT-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-COMPABO",
    "name": "Computadora de abordo",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-COMPABO-N",
        "name": "No"
      },
      {
        "id": "MLA1744-COMPABO-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-CONTR",
    "name": "Control de estabilidad",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CONTR-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CONTR-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-CNTTRACC",
    "name": "Control de tracción",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CNTTRACC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CNTTRACC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-CTRLVEL",
    "name": "Control de velocidad de crucero",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CTRLVEL-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CTRLVEL-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-VIDELEC",
    "name": "Cristales eléctricos",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-VIDELEC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-VIDELEC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-DIREC",
    "name": "Dirección",
    "value_type": "list",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-DIREC-ASISTIDA",
        "name": "Asistida"
      },
      {
        "id": "MLA1744-DIREC-HIDRAULICA",
        "name": "Hidráulica"
      },
      {
        "id": "MLA1744-DIREC-MECANICA",
        "name": "Mecánica"
      }
    ],
    "attribute_group_id": "ADICIONALES",
    "attribute_group_name": "Adicionales"
  },
  {
    "id": "MLA1744-DOBTRACC",
    "name": "Doble tracción",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-DOBTRACC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-DOBTRACC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-DVD",
    "name": "DVD",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-DVD-N",
        "name": "No"
      },
      {
        "id": "MLA1744-DVD-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-ENTAUXILIA",
    "name": "Entrada auxiliar",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ENTAUXILIA-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ENTAUXILIA-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-USB",
    "name": "Entrada USB",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-USB-N",
        "name": "No"
      },
      {
        "id": "MLA1744-USB-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-ESPELEC",
    "name": "Espejos eléctricos",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ESPELEC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ESPELEC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-FARANTI",
    "name": "Faros antinieblas delanteros",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-FARANTI-N",
        "name": "No"
      },
      {
        "id": "MLA1744-FARANTI-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-NEBLTRAS",
    "name": "Faros antinieblas traseros",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-NEBLTRAS-N",
        "name": "No"
      },
      {
        "id": "MLA1744-NEBLTRAS-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-FAROXEN",
    "name": "Faros de xenón",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-FAROXEN-N",
        "name": "No"
      },
      {
        "id": "MLA1744-FAROXEN-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-FAROREG",
    "name": "Faros regulables desde el interior",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-FAROREG-N",
        "name": "No"
      },
      {
        "id": "MLA1744-FAROREG-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-ABS",
    "name": "Frenos ABS",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ABS-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ABS-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-GPS",
    "name": "GPS",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-GPS-N",
        "name": "No"
      },
      {
        "id": "MLA1744-GPS-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1743-HORPREF",
    "name": "Horario de contacto",
    "value_type": "string",
    "value_max_length": 60,
    "tags": {
    },
    "attribute_group_id": "ADICIONALES",
    "attribute_group_name": "Adicionales"
  },
  {
    "id": "MLA1744-INMOVMOT",
    "name": "Inmovilizador de motor",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-INMOVMOT-N",
        "name": "No"
      },
      {
        "id": "MLA1744-INMOVMOT-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-ISOFIX",
    "name": "Isofix",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ISOFIX-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ISOFIX-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-LIMPIA_LAV",
    "name": "Limpia/lava luneta",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-LIMPIA/LAV-N",
        "name": "No"
      },
      {
        "id": "MLA1744-LIMPIA/LAV-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "EXTERIOR",
    "attribute_group_name": "Exterior"
  },
  {
    "id": "MLA1744-LLANALEAC",
    "name": "Llantas de aleación",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-LLANALEAC-N",
        "name": "No"
      },
      {
        "id": "MLA1744-LLANALEAC-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "EXTERIOR",
    "attribute_group_name": "Exterior"
  },
  {
    "id": "MLA1744-MP3",
    "name": "MP3",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-MP3-N",
        "name": "No"
      },
      {
        "id": "MLA1744-MP3-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-PARAGOLPES",
    "name": "Paragolpes pintados",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-PARAGOLPES-N",
        "name": "No"
      },
      {
        "id": "MLA1744-PARAGOLPES-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "EXTERIOR",
    "attribute_group_name": "Exterior"
  },
  {
    "id": "MLA1744-CASET",
    "name": "Pasacassette",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-CASET-N",
        "name": "No"
      },
      {
        "id": "MLA1744-CASET-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-REPFUERZA",
    "name": "Repartidor electrónico de fuerza de frenado",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-REPFUERZA-N",
        "name": "No"
      },
      {
        "id": "MLA1744-REPFUERZA-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-ESTACIONAM",
    "name": "Sensor de estacionamiento",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-ESTACIONAM-N",
        "name": "No"
      },
      {
        "id": "MLA1744-ESTACIONAM-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-SENSLL",
    "name": "Sensor de lluvia",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-SENSLL-N",
        "name": "No"
      },
      {
        "id": "MLA1744-SENSLL-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-SENSLUZ",
    "name": "Sensor de luz",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-SENSLUZ-N",
        "name": "No"
      },
      {
        "id": "MLA1744-SENSLUZ-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-TAPCUERO",
    "name": "Tapizado de cuero",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-TAPCUERO-N",
        "name": "No"
      },
      {
        "id": "MLA1744-TAPCUERO-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-TARJETASD",
    "name": "Tarjeta SD",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-TARJETASD-N",
        "name": "No"
      },
      {
        "id": "MLA1744-TARJETASD-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SONIDO",
    "attribute_group_name": "Sonido"
  },
  {
    "id": "MLA1744-TECHOCORR",
    "name": "Techo corredizo",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-TECHOCORR-N",
        "name": "No"
      },
      {
        "id": "MLA1744-TECHOCORR-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "CONFORT",
    "attribute_group_name": "Confort"
  },
  {
    "id": "MLA1744-3LUZSTOP",
    "name": "Tercer stop",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-3LUZSTOP-N",
        "name": "No"
      },
      {
        "id": "MLA1744-3LUZSTOP-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "SECURITY",
    "attribute_group_name": "Seguridad"
  },
  {
    "id": "MLA1744-TRANS",
    "name": "Transmisión",
    "value_type": "list",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-TRANS-AUTOMATICA",
        "name": "Automática"
      },
      {
        "id": "MLA1744-TRANS-MANUAL",
        "name": "Manual"
      },
      {
        "id": "MLA1744-TRANS-SECUENCIAL",
        "name": "Secuencial"
      }
    ],
    "attribute_group_id": "FIND",
    "attribute_group_name": "Ficha técnica"
  },
  {
    "id": "MLA1744-VIDPOLARIZ",
    "name": "Vidrios polarizados",
    "value_type": "boolean",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-VIDPOLARIZ-N",
        "name": "No"
      },
      {
        "id": "MLA1744-VIDPOLARIZ-Y",
        "name": "Sí"
      }
    ],
    "attribute_group_id": "EXTERIOR",
    "attribute_group_name": "Exterior"
  },
  {
    "id": "MLA1744-OWNER",
    "name": "Único dueño",
    "value_type": "list",
    "tags": {
    },
    "values": [
      {
        "id": "MLA1744-OWNER-SI",
        "name": "Sí"
      },
      {
        "id": "MLA1744-OWNER-NO",
        "name": "No"
      }
    ],
    "attribute_group_id": "ADICIONALES",
    "attribute_group_name": "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.

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

Path_from_root

Mira como utiliza MercadoLibre sus categorías:
Captura de pantalla 2016-03-23 a las 11.24.49

Elige la categoría para tu item

Elegir la categoría correcta para tu vehículo 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.


Siguiente:
Administra áreas de cobertura.

Por favor califica del 1 al 5

Guía para Servicios

Los servicios son publicaciones de clasificados donde los datos de contacto de los prestadores son públicos, lo que facilita el contacto directo entre un usuario y el prestador del servicio, y el pago y las condiciones de contratación se coordinan entre las contrapartes.

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

Siguiente:
Autenticación y Autorización.

Por favor califica del 1 al 5

Consulta Usuarios Avanzados

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

Contenidos:

Por favor califica del 1 al 5

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.

Por favor califica del 1 al 5

Publica Servicios

Ahora que ya analizamos autenticación, usuarios y categorías, creemos que estás listo para realizar tu primera publicación. Sigue este tutorial para aprender cómo hacerlo.

Contenidos:

Puntos básicos

En la API de MercadoLibre, las publicaciones son artículos que contienen productos y otros atributos que puedes vender o comprar. Los usuarios no pueden intercambiar información de contacto de inmediato. Por eso, cada vez que existe la intención de comprar un producto, los compradores potenciales pueden formular tantas preguntas como deseen sobre el artículo y, cuando están listos, deben hacer una oferta por el producto del vendedor para que se cree un pedido tanto para el comprador como para el vendedor con el detalle de la transacción como venta o compra para cada uno. En ese momento la información de contacto se hace automáticamente visible entre esos usuarios.

Resultados de publicaciones

Cada artículo que publicas aparecerá en los resultados de publicaciones de la búsqueda de un producto determinado. Por ejemplo, cuando un usuario busca la consulta “peluquería”, obtendrá como resultado una lista de todos los artículos relacionados. Tu artículo puede estar en esa 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

Cuando un usuario selecciona un artículo del resultado, 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
  • Reputación del vendedor
  • Campos del artículo

    Veamos un artículo común en detalle. Esto es fácil, porque solo debes conocer el item_id asociado al producto y, como es público, puedes obtenerlo en la página Detalles del artículo en la parte superior de la página, como en la imagen del ejemplo. Debes agregar el site_id antes del número y listo. Ahora puedes llamar al recurso Artículos para obtener toda la información relacionada:

    Llamada:

    curl - X GET https://api.mercadolibre.com/items/{Item_id}

    Ejemplo:

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

    Respuesta:

    {
      "id": "MLA612001263",
      "site_id": "MLA",
      "title": "Okm Amarok Highline Pack Automatic Cuero Navegador Esp.rebat",
      "subtitle": null,
      "seller_id": 171413284,
      "category_id": "MLA92242",
      "official_store_id": null,
      "price": 694000,
      "base_price": 694000,
      "original_price": null,
      "currency_id": "ARS",
      "initial_quantity": 1,
      "available_quantity": 1,
      "sold_quantity": 0,
      "buying_mode": "classified",
      "listing_type_id": "gold",
      "start_time": "2016-03-17T12:52:07.000Z",
      "stop_time": "2016-04-23T17:06:37.707Z",
      "condition": "not_specified",
      "permalink": "http://auto.mercadolibre.com.ar/MLA-612001263-okm-amarok-highline-pack-automatic-cuero-navegador-esprebat-_JM",
      "thumbnail": "http://mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-I.jpg",
      "secure_thumbnail": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-I.jpg",
      "pictures": [
        {
          "id": "624411-MLA20545255891_012016",
          "url": "http://mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/624411-MLA20545255891_012016-O.jpg",
          "size": "500x428",
          "max_size": "1200x1028",
          "quality": ""
        },
        {
          "id": "366311-MLA20544374183_012016",
          "url": "http://mla-s1-p.mlstatic.com/366311-MLA20544374183_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/366311-MLA20544374183_012016-O.jpg",
          "size": "499x272",
          "max_size": "995x543",
          "quality": ""
        },
        {
          "id": "636311-MLA20545255955_012016",
          "url": "http://mla-s1-p.mlstatic.com/636311-MLA20545255955_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/636311-MLA20545255955_012016-O.jpg",
          "size": "500x383",
          "max_size": "1200x921",
          "quality": ""
        },
        {
          "id": "134311-MLA20545256000_012016",
          "url": "http://mla-s1-p.mlstatic.com/134311-MLA20545256000_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/134311-MLA20545256000_012016-O.jpg",
          "size": "500x357",
          "max_size": "1200x858",
          "quality": ""
        },
        {
          "id": "661411-MLA20545258607_012016",
          "url": "http://mla-s2-p.mlstatic.com/661411-MLA20545258607_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/661411-MLA20545258607_012016-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "820411-MLA20545256923_012016",
          "url": "http://mla-s1-p.mlstatic.com/820411-MLA20545256923_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/820411-MLA20545256923_012016-O.jpg",
          "size": "375x500",
          "max_size": "900x1200",
          "quality": ""
        },
        {
          "id": "757311-MLA20545256948_012016",
          "url": "http://mla-s2-p.mlstatic.com/757311-MLA20545256948_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/757311-MLA20545256948_012016-O.jpg",
          "size": "375x500",
          "max_size": "900x1200",
          "quality": ""
        },
        {
          "id": "843311-MLA20545256985_012016",
          "url": "http://mla-s1-p.mlstatic.com/843311-MLA20545256985_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/843311-MLA20545256985_012016-O.jpg",
          "size": "375x500",
          "max_size": "900x1200",
          "quality": ""
        },
        {
          "id": "952411-MLA20545259213_012016",
          "url": "http://mla-s2-p.mlstatic.com/952411-MLA20545259213_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/952411-MLA20545259213_012016-O.jpg",
          "size": "375x500",
          "max_size": "900x1200",
          "quality": ""
        },
        {
          "id": "658311-MLA20545259279_012016",
          "url": "http://mla-s2-p.mlstatic.com/658311-MLA20545259279_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/658311-MLA20545259279_012016-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "281411-MLA20545257928_012016",
          "url": "http://mla-s1-p.mlstatic.com/281411-MLA20545257928_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/281411-MLA20545257928_012016-O.jpg",
          "size": "500x375",
          "max_size": "1200x900",
          "quality": ""
        },
        {
          "id": "846311-MLA20545257964_012016",
          "url": "http://mla-s1-p.mlstatic.com/846311-MLA20545257964_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/846311-MLA20545257964_012016-O.jpg",
          "size": "375x500",
          "max_size": "900x1200",
          "quality": ""
        },
        {
          "id": "816311-MLA20545261007_012016",
          "url": "http://mla-s2-p.mlstatic.com/816311-MLA20545261007_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s2-p.mlstatic.com/816311-MLA20545261007_012016-O.jpg",
          "size": "489x500",
          "max_size": "1174x1200",
          "quality": ""
        },
        {
          "id": "793311-MLA20545258000_012016",
          "url": "http://mla-s1-p.mlstatic.com/793311-MLA20545258000_012016-O.jpg",
          "secure_url": "https://a248.e.akamai.net/mla-s1-p.mlstatic.com/793311-MLA20545258000_012016-O.jpg",
          "size": "500x254",
          "max_size": "1200x610",
          "quality": ""
        }
      ],
      "video_id": "XVYGawQRnlo",
      "descriptions": [
        {
          "id": "MLA612001263-1056189973"
        }
      ],
      "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": 153496278,
        "comment": "",
        "address_line": "av Gaona 4460",
        "zip_code": "",
        "city": {
          "id": "TUxBQkZMTzg5MjFa",
          "name": "Floresta"
        },
        "state": {
          "id": "AR-C",
          "name": "Capital Federal"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "search_location": {
          "neighborhood": {
            "id": "TUxBQkZMTzg5MjFa",
            "name": "Floresta"
          },
          "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": "",
        "zip_code": "",
        "neighborhood": {
          "id": "TUxBQlNBTjEyMjNa",
          "name": "Santa Rita"
        },
        "city": {
          "id": "TUxBQ0NBUGZlZG1sYQ",
          "name": "Capital Federal"
        },
        "state": {
          "id": "TUxBUENBUGw3M2E1",
          "name": "Capital Federal"
        },
        "country": {
          "id": "AR",
          "name": "Argentina"
        },
        "latitude": "",
        "longitude": "",
        "open_hours": ""
      },
      "geolocation": {
        "latitude": "",
        "longitude": ""
      },
      "coverage_areas": [
      ],
      "attributes": [
        {
          "id": "MLA1743-HORPREF",
          "name": "Horario de contacto",
          "value_id": "",
          "value_name": "08.30 a 20 ",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-COLOREXT",
          "name": "Color",
          "value_id": "",
          "value_name": "",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-DIREC",
          "name": "Dirección",
          "value_id": "",
          "value_name": "",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-OWNER",
          "name": "Único dueño",
          "value_id": "",
          "value_name": "",
          "attribute_group_id": "ADICIONALES",
          "attribute_group_name": "Adicionales"
        },
        {
          "id": "MLA1744-AIRACON",
          "name": "Aire acondicionado",
          "value_id": "MLA1744-AIRACON-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ALARMLUC",
          "name": "Alarma de luces encendidas",
          "value_id": "MLA1744-ALARMLUC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-APERBAUL",
          "name": "Apertura remota de baúl",
          "value_id": "MLA1744-APERBAUL-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASIENELEC",
          "name": "Asientos eléctricos",
          "value_id": "MLA1744-ASIENELEC-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASREBAT",
          "name": "Asiento trasero rebatible",
          "value_id": "MLA1744-ASREBAT-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ASREGULA",
          "name": "Asiento conductor regulable en altura",
          "value_id": "MLA1744-ASREGULA-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-BLQCNTDOOR",
          "name": "Cierre centralizado de puertas",
          "value_id": "MLA1744-BLQCNTDOOR-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-CLIMAUT",
          "name": "Climatizador automático",
          "value_id": "MLA1744-CLIMAUT-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-COMPABO",
          "name": "Computadora de abordo",
          "value_id": "MLA1744-COMPABO-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-CTRLVEL",
          "name": "Control de velocidad de crucero",
          "value_id": "MLA1744-CTRLVEL-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ESPELEC",
          "name": "Espejos eléctricos",
          "value_id": "MLA1744-ESPELEC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-ESTACIONAM",
          "name": "Sensor de estacionamiento",
          "value_id": "MLA1744-ESTACIONAM-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-FAROREG",
          "name": "Faros regulables desde el interior",
          "value_id": "MLA1744-FAROREG-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-GPS",
          "name": "GPS",
          "value_id": "MLA1744-GPS-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-SENSLL",
          "name": "Sensor de lluvia",
          "value_id": "MLA1744-SENSLL-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-SENSLUZ",
          "name": "Sensor de luz",
          "value_id": "MLA1744-SENSLUZ-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-TAPCUERO",
          "name": "Tapizado de cuero",
          "value_id": "MLA1744-TAPCUERO-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-TECHOCORR",
          "name": "Techo corredizo",
          "value_id": "MLA1744-TECHOCORR-N",
          "value_name": "No",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-VIDELEC",
          "name": "Cristales eléctricos",
          "value_id": "MLA1744-VIDELEC-Y",
          "value_name": "Sí",
          "attribute_group_id": "CONFORT",
          "attribute_group_name": "Confort"
        },
        {
          "id": "MLA1744-LIMPIA_LAV",
          "name": "Limpia/lava luneta",
          "value_id": "MLA1744-LIMPIA/LAV-N",
          "value_name": "No",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-LLANALEAC",
          "name": "Llantas de aleación",
          "value_id": "MLA1744-LLANALEAC-Y",
          "value_name": "Sí",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-PARAGOLPES",
          "name": "Paragolpes pintados",
          "value_id": "MLA1744-PARAGOLPES-Y",
          "value_name": "Sí",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-VIDPOLARIZ",
          "name": "Vidrios polarizados",
          "value_id": "MLA1744-VIDPOLARIZ-N",
          "value_name": "No",
          "attribute_group_id": "EXTERIOR",
          "attribute_group_name": "Exterior"
        },
        {
          "id": "MLA1744-COMBUS",
          "name": "Combustible",
          "value_id": "MLA1744-COMBUS-DIESEL",
          "value_name": "Diesel",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-DOOR",
          "name": "Cant. de puertas",
          "value_id": "MLA1744-DOOR-4",
          "value_name": "4",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-KMTS",
          "name": "Kilómetros",
          "value_id": "",
          "value_name": "0",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-MARC",
          "name": "Marca",
          "value_id": "MLA1744-MARC-VOLKSWAGEN",
          "value_name": "Volkswagen",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-MODL",
          "name": "Modelo",
          "value_id": "MLA1744-MODL-AMAROK",
          "value_name": "Amarok",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-TRANS",
          "name": "Transmisión",
          "value_id": "",
          "value_name": "",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-YEAR",
          "name": "Año",
          "value_id": "MLA1744-YEAR-95192c",
          "value_name": "2016",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA92242-VERS",
          "name": "Versión",
          "value_id": "",
          "value_name": "",
          "attribute_group_id": "FIND",
          "attribute_group_name": "Ficha técnica"
        },
        {
          "id": "MLA1744-3LUZSTOP",
          "name": "Tercer stop",
          "value_id": "MLA1744-3LUZSTOP-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ABS",
          "name": "Frenos ABS",
          "value_id": "MLA1744-ABS-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR1",
          "name": "Airbag conductor",
          "value_id": "MLA1744-AIR1-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR2",
          "name": "Airbag pasajero",
          "value_id": "MLA1744-AIR2-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIR3",
          "name": "Airbag laterales",
          "value_id": "MLA1744-AIR3-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AIRBAGCORT",
          "name": "Airbag de cortina",
          "value_id": "MLA1744-AIRBAGCORT-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ALAR",
          "name": "Alarma",
          "value_id": "MLA1744-ALAR-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-APCABEZA",
          "name": "Apoya cabeza en asientos traseros",
          "value_id": "MLA1744-APCABEZA-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-BLIND",
          "name": "Blindado",
          "value_id": "MLA1744-BLIND-N",
          "value_name": "No",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-CNTTRACC",
          "name": "Control de tracción",
          "value_id": "MLA1744-CNTTRACC-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-CONTR",
          "name": "Control de estabilidad",
          "value_id": "MLA1744-CONTR-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-DOBTRACC",
          "name": "Doble tracción",
          "value_id": "MLA1744-DOBTRACC-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-FARANTI",
          "name": "Faros antinieblas delanteros",
          "value_id": "MLA1744-FARANTI-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-FAROXEN",
          "name": "Faros de xenón",
          "value_id": "MLA1744-FAROXEN-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-INMOVMOT",
          "name": "Inmovilizador de motor",
          "value_id": "MLA1744-INMOVMOT-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-ISOFIX",
          "name": "Isofix",
          "value_id": "MLA1744-ISOFIX-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-NEBLTRAS",
          "name": "Faros antinieblas traseros",
          "value_id": "MLA1744-NEBLTRAS-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-REPFUERZA",
          "name": "Repartidor electrónico de fuerza de frenado",
          "value_id": "MLA1744-REPFUERZA-Y",
          "value_name": "Sí",
          "attribute_group_id": "SECURITY",
          "attribute_group_name": "Seguridad"
        },
        {
          "id": "MLA1744-AM_FM",
          "name": "AM/FM",
          "value_id": "MLA1744-AM/FM-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-BLUETOOTH",
          "name": "Bluetooth",
          "value_id": "MLA1744-BLUETOOTH-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CAJACD",
          "name": "Caja de CD",
          "value_id": "MLA1744-CAJACD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CARGADORCD",
          "name": "Cargador de CD",
          "value_id": "MLA1744-CARGADORCD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-CASET",
          "name": "Pasacassette",
          "value_id": "MLA1744-CASET-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-COMANDOSAT",
          "name": "Comando satelital de stereo",
          "value_id": "MLA1744-COMANDOSAT-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-DVD",
          "name": "DVD",
          "value_id": "MLA1744-DVD-N",
          "value_name": "No",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-ENTAUXILIA",
          "name": "Entrada auxiliar",
          "value_id": "MLA1744-ENTAUXILIA-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-MP3",
          "name": "MP3",
          "value_id": "MLA1744-MP3-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-REPRODCD",
          "name": "CD",
          "value_id": "MLA1744-REPRODCD-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-TARJETASD",
          "name": "Tarjeta SD",
          "value_id": "MLA1744-TARJETASD-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        },
        {
          "id": "MLA1744-USB",
          "name": "Entrada USB",
          "value_id": "MLA1744-USB-Y",
          "value_name": "Sí",
          "attribute_group_id": "SONIDO",
          "attribute_group_name": "Sonido"
        }
      ],
      "warnings": [
      ],
      "listing_source": "",
      "variations": [
      ],
      "status": "active",
      "sub_status": [
      ],
      "tags": [
        "dragged_visits"
      ],
      "warranty": null,
      "catalog_product_id": null,
      "parent_item_id": "MLA599924359",
      "differential_pricing": null,
      "deal_ids": [
      ],
      "automatic_relist": false,
      "date_created": "2016-03-17T12:52:08.000Z",
      "last_updated": "2016-03-22T17:07:24.286Z"
    }

    Definición de atributos

    Cuando creas un 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, cómo pueden comprarlo los compradores y la posición en los resultados de la búsqueda, entre otras variables.

    Título

    El título es un atributo obligatorio y la clave para que los compradores encuentren tu producto; por eso, debes ser lo más específico posible.
    La mejor forma de armar un título es nombre + marca + modelo + especificaciones técnicas y características + servicios adicionales. Separa las palabras con espacios y no utilices símbolos ni signos de puntuación. Controla para evitar palabras con errores de ortografía. Por ejemplo: Ipod Touch Apple 16gb 5 Geração.

    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 un artículo sea más atractivo y ofrecer a los compradores una idea más certera de su aspecto. 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 aquí más adelante. Por favor, lee más sobre este tema para conocer qué tipo de imágenes se permiten y cómo trabajar con ellas.

    Categoría

    Los vendedores deben definir una categoría en el site de MercadoLibre. Este atributo es obligatorio y solo acepta ID preestablecidos. Para más información, lee la guía de categorías. Para acceder a una sugerencia de categorías, lee este artículo.

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

    Precio

    Éste es un atributo obligatorio: cuando defines un nuevo artículo, debe tener precio. Te sugerimos que busques artículos similares en nuestro mercado para conocer el mejor precio para tus productos y aumentar tu competitividad. Si definiste un precio, pero no estás contento con el mismo, puedes cambiarlo más tarde; aprende cómo modificar artículos.

    Moneda

    Además del precio, debes definir una moneda. Este atributo también es obligatorio. Debes definirla utilizando un ID preestablecido. Sabrás qué ID enviar llamando a nuestro recurso Monedas.

    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

    Publica un servicio

    Estás listo para publicar tu primer artículo. Recuerda que necesitarás un access_token para hacerlo. Si tienes preguntas sobre cómo obtener tu access token, por favor regresa al tutorial de autenticación. También te recomendamos utilizar usuarios de test para publicar artículos de prueba. Si no estás familiarizado con los mismos, por favor consulta la sección generar usuarios de test aquí. 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 fácil y rápido.
    Puedes crear un JSON para tu artículo en base al ejemplo a continuación o simplemente envíalo así y estarás publicando un producto de muestra en el site:

    curl -X POST ‘{
        "site_id": "MLA",
        "title": "Alquiler De Luces Y Sonido Efectos Maquina De Humo Fiestas",
        "category_id": "MLA43985",
        "price": 100,
        "currency_id": "ARS",
        "available_quantity": 1,
        "buying_mode": "classified",
        "listing_type_id": "gold_premium",
        "pictures": [],
        "video_id": null,
        "accepts_mercadopago": false,
        "non_mercado_pago_payment_methods": [],
        "shipping": {
            "profile_id": null,
            "mode": "not_specified",
            "local_pick_up": false,
            "free_shipping": false,
            "methods": [],
            "dimensions": null
        },
        "seller_contact": {
            "contact": "",
            "other_info": "",
            "area_code": "",
            "phone": "(01143333423)",
            "area_code2": "",
            "phone2": "",
            "email": "viedusabores@hotmail.com",
            "webpage": ""
        },
        "location": {
            "address_line": "",
            "zip_code": "",
            "neighborhood": {
                "id": "",
                "name": ""
            },
            "city": {
                "id": "",
                "name": "Flores-Villa Crespo"
            },
            "state": {
                "id": "TUxBUENBUGw3M2E1",
                "name": "Capital Federal"
            },
            "country": {
                "id": "AR",
                "name": "Argentina"
            },
            "latitude": "",
            "longitude": ""
        },
        "coverage_areas": [],
        "attributes": [],
        "variations": []
    }



    Siguiente:
    Sincroniza publicaciones

    Por favor califica del 1 al 5

    Gestiona contactos y visitas

    Introducción

    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

    TipoParámetroDescripció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”).

    Preguntas 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
    }

    Preguntas 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"
    }

    Clicks 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.

    Por favor califica del 1 al 5

    Consultas sobre el usuario

    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:

    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",
      "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 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": 205159033,
      "nickname": "TETE4358231",
      "registration_date": "2016-02-04T13:49:09.000-04:00",
      "country_id": "AR",
      "address": {
      "state": "AR-C",
      "city": "Palermo"
      },
      "user_type": "car_dealer",
      "tags": [
      "car_dealer",
      "test_user",
      "user_info_verified"
      ],
      "logo": null,
      "points": 100,
      "site_id": "MLA",
      "permalink": "http://perfil.mercadolibre.com.ar/TETE4358231",
      "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.

    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.

    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.



    Siguiente:
    Elige el tipo de servicio.

    Por favor califica del 1 al 5

    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

    ErrorMensaje de errorPosible 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 accesoSe está utilizando el token de otro usuario.



    Artículos relacionados:
    Server side
    Client side


    Siguiente:
    Consulta usuarios.

    Por favor califica del 1 al 5

    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.

    Por favor califica del 1 al 5

    Administra áreas de cobertura

    Las áreas de cobertura permitirán saber a los usuarios si el servicio que estás ofreciendo llega a las áreas donde se encuentran. Debes enviar cada área con los ID preestablecidos que encontrarás en nuestra API.

    Contenidos:

    Áreas de cobertura por país

    Para conocer los ID pertenecientes a las áreas de tu país, realiza una llamada mixta entre sites y agrega recursos de áreas de cobertura.

    Ejemplo:

    https://api.mercadolibre.com/sites/MLA/coverage_areas

    Respuesta:

    {
      "id": "TUxBUENBUGw3M2E1",
      "description": "Bs.As. Cap. Federal",
      "zone": "Capital Federal",
      "type": "state"
      },
      {
      "id": "TUxBUEdSQWU4ZDkz",
      "description": "Bs.As. G.B.A. Norte",
      "zone": "Gba Norte",
      "type": "state"
      },
      {
      "id": "TUxBUEdSQWVmNTVm",
      "description": "Bs.As. G.B.A. Oeste",
      "zone": "Gba Oeste",
      "type": "state"
      },
      {
      "id": "TUxBUEdSQXJlMDNm",
      "description": "Bs.As. G.B.A. Sur",
      "zone": "Gba Sur",
      "type": "state"
      },
      {
      "id": "TUxBUENPU2ExMmFkMw",
      "description": "Bs.As. Costa Atlántica",
      "zone": "Gba Costa Atlántica",
      "type": "state"
      },
      {
      "id": "TUxBUFpPTmFpbnRl",
      "description": "Bs.As. Zona Interior",
      "zone": "Buenos Aires",
      "type": "state"
      },
      {
      "id": "TUxBUENBVGFiY2Fm",
      "description": "Catamarca",
      "zone": "Catamarca",
      "type": "state"
      },
      {
      "id": "TUxBUENIQW8xMTNhOA",
      "description": "Chaco",
      "zone": "Chaco",
      "type": "state"
      },
      {
      "id": "TUxBUENIVXQxNDM1MQ",
      "description": "Chubut",
      "zone": "Chubut",
      "type": "state"
      },
      {
      "id": "TUxBUENPUmFkZGIw",
      "description": "Córdoba",
      "zone": "Córdoba",
      "type": "state"
      },
      {
      "id": "TUxBUENPUnM5MjI0",
      "description": "Corrientes",
      "zone": "Corrientes",
      "type": "state"
      },
      {
      "id": "TUxBUEVOVHMzNTdm",
      "description": "Entre Ríos",
      "zone": "Entre Ríos",
      "type": "state"
      },
      {
      "id": "TUxBUEZPUmE1OTk5",
      "description": "Formosa",
      "zone": "Formosa",
      "type": "state"
      },
      {
      "id": "TUxBUEpVSnk3YmUz",
      "description": "Jujuy",
      "zone": "Jujuy",
      "type": "state"
      },
      {
      "id": "TUxBUExBWmE1OWMy",
      "description": "La Pampa",
      "zone": "La Pampa",
      "type": "state"
      },
      {
      "id": "TUxBUExBWmEyNzY0",
      "description": "La Rioja",
      "zone": "La Rioja",
      "type": "state"
      },
      {
      "id": "TUxBUE1FTmE5OWQ4",
      "description": "Mendoza",
      "zone": "Mendoza",
      "type": "state"
      },
      {
      "id": "TUxBUE1JU3MzNjIx",
      "description": "Misiones",
      "zone": "Misiones",
      "type": "state"
      },
      {
      "id": "TUxBUE5FVW4xMzMzNQ",
      "description": "Neuquén",
      "zone": "Neuquén",
      "type": "state"
      },
      {
      "id": "TUxBUFLNT29iZmZm",
      "description": "Río Negro",
      "zone": "Río Negro",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTGFjMTJi",
      "description": "Salta",
      "zone": "Salta",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTm5lYjU4",
      "description": "San Juan",
      "zone": "San Juan",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTnM0ZTcz",
      "description": "San Luis",
      "zone": "San Luis",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTno3ZmY5",
      "description": "Santa Cruz",
      "zone": "Santa Cruz",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTmU5Nzk2",
      "description": "Santa Fe",
      "zone": "Santa Fe",
      "type": "state"
      },
      {
      "id": "TUxBUFNBTm9lOTlk",
      "description": "Santiago del Estero",
      "zone": "Santiago Del Estero",
      "type": "state"
      },
      {
      "id": "TUxBUFRJRVoxM2M5YQ",
      "description": "Tierra del Fuego ",
      "zone": "Tierra Del Fuego",
      "type": "state"
      },
      {
      "id": "TUxBUFRVQ244NmM3",
      "description": "Tucumán",
      "zone": "Tucumán",
      "type": "state"
      },
      {
      "id": "AR",
      "description": "Argentina",
      "zone": "Todo el País",
      "type": "country"
      }

    Áreas de cobertura por ID

    Accede a los detalles sobre un área específica.

    Ejemplo:

    https://api.mercadolibre.com/coverage_areas/TUxBUEpVSnk3YmUz

    Respuesta:

    {
      "id": "TUxBUEpVSnk3YmUz",
      "description": "Jujuy",
      "zone": "Jujuy",
      "type": "state"
    }

    Agrega áreas de cobertura

    Para agregar áreas de cobertura a una publicación existente, simplemente realiza una solicitud PUT a la API de artículos con el siguiente JSON.

    Ejemplo:

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    {
    coverage_areas: ["TUxBUExBWmEyNzY0","TUxBUEpVSnk3YmUz"]
    }
    https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN



    Siguiente:
    Publica servicios.

    Por favor califica del 1 al 5