Seleção do tipo de operação e Imóvel

As categorias são um conjunto hierárquico de grupos nos quais são enumerados os produtos de natureza similar, denominados “árvore de categorias”. As categorias ajudam os usuários a buscar facilmente o tipo de produto desejado.
Cada site tem seu próprio conjunto de categorias, isto é, a Argentina terá um conjunto único de categorias diferentes das que você vai encontrar no Brasil, porque cada país tem suas características particulares classificadas no mercado. https://api.mercadolibre.com/sites/MLB/categories
Antes de publicar um produto, você deve explorar a estrutura de categorias e escolher em qual delas quer publicar. Como ajuda, você pode baixar a hierarquia completa das categorias com ID e nome simples, de nossa API.
Para fazer a publicação de um imóvel, você deverá selecionar a category_id dependendo do tipo de operação e imóvel.

Assuntos:

Categorias por site

O recurso Sites pode oferecer a estrutura de categorias de um país em particular, nesse caso, da Argentina.

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

Para categorias do segundo nível, ou informações relacionadas com categorias específicas, você deverá utilizar o recuso Categories e enviar o ID da categoria como parâmetro URL.
Veja o que podemos encontrar na categoria “Inmuebles” (Imóveis):

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

Você obtém os atributos “path_from_root” e children_categories. Utilize esses atributos na exploração da árvore de categorias para encontrar a categoria específica de seu produto.
Como você pode observar, as categorias são baseadas nos tipos de imóveis e elas vêm seguidas, em primeiro lugar, do tipo de operação. Você deve selecionar a categoria filho.

Exemplo:

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

Resposta:

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

Nesse caso, as children_categories são “Venta” (Vendas) e “Alquiler” (Aluguel). Você pode publicar seu imóvel na que achar mais conveniente.

Categorias JSON

Realizar uma chamada para uma categoria em particular permitirá conhecer seus atributos. A seguir, encontre uma descrição de alguns desses atributos. Ao realizar uma solicitação GET para a categoria category_id, você encontrará todos os atributos disponibilizados e poderá saber se eles são obrigatórios ou opcionais para publicar na categoria.

Exemplo:

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

Resposta:

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

Atributos específicos das categorias

Para conhecer os atributos específicos e valores possíveis das categorias que você deve encaminhar para publicar um produto, consulte o recurso atributos:

Exemplo:

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

Nome

Este atributo mostra uma etiqueta simples. Somente lendo o JSON anterior você sabe que, por exemplo, trata-se de uma categoria de classificados que não comporta a inclusão de opções de envio. Existem 1.332 produtos publicados. e você pode incluir o preço em ARS ou USD.

Atributos obrigatórios

Os atributos obrigatórios são configurados como “required” nos detalhes da categoria. No exemplo anterior, você pode observar que preço e estoque são obrigatórios; não são autorizadas áreas de cobertura e o seller_contact é opcional. Além disso, atributos específicos da categoria, como “Antiguidade” e “Estado”, que têm a tag “required”: verdadeiro, devem ser enviados com os valores possíveis detalhados no JSON.

Dump de categorias

A árvore de categorias não é alterada frequentemente. Se você preferir, pode solicitar o dump de toda a árvore de categorias para o site de um determinado país para processamento off-line. A API retorna a árvore de categorias no formato JSON em uma resposta codificada em gzip. Para obter as categorias do Brasil, utilize a URL abaixo:

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

Para obter as categorias da Argentina, utilize a URL abaixo:

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

Essa URL contém dois cabeçalhos que podem ser utilizados para verificar quando foi gerado o último dump.
● X-Content-Created : contêm a data da última geração.
● X-Content-MD5: contém a soma de verificação MD5 da última geração.

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

HTTP/1.1 200 OK

Server: nginx/1.0.4
Date: Tue, 24 Jul 2012 15:14:58 GMT
Content-Type: application/json;charset=UTF-8
Connection: keep-alive
X-MLAPI-Version: 1.9.5
Content-Encoding: gzip
X-Content-Created: 2012-07-24T14:00:59.716Z
X-Content-MD5: 943541196986770119b4af1e66bda2dc

Seleção de categorias

A escolha da categoria certa para seu imóvel determinará a rapidez com que ele será encontrado pelos compradores, melhorando suas chances de venda. Por isso, recomendamos utilizar a nossa ferramenta de predição de Categorias antes de publicar un produto.

Busca por categoria

Na operação de busca aparecem produtos pertencentes a uma categoria de produto do Mercado Livre. Apesar de existirem toneladas de produtos em algumas categorias, não se preocupe: você poderá paginar os resultados. Leia sobre paginação dos resultados de busca.
Para obter todos os produtos de uma determinada categoria, você precisa fazer o seguinte:

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

A resposta da busca tem uma enorme quantidade de parâmetros. Utilize o método http OPÇÕES para obter uma resposta codificada em JSON que descreverá a API com todos os métodos e conexões permitidos entre ele e a outra parte da API. https://api.mercadolibre.com/sites/MLA/search/.

Paginação e dimensionamento dos resultados

Daqui em diante, este tutorial será útil para trabalhar com conjuntos específicos de resultados toda vez que você fizer uma chamada à API. A maior parte dos recursos apresentam parâmetros URL normais para paginar e dimensionar resultados: limit y offset.

limit

Valores padrão

Os valores padrão são: deslocamento=0 e limite=50.

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

Na seção de paginação da resposta JSON, você pode visualizar a quantidade total de produtos que correspondem à busca e o valor de deslocamento com o limite padrão aplicado.

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

Limite

Para reduzir o tamanho da página, você pode alterar o parâmetro do limite. Por exemplo, caso esteja interessado em recuperar somente os três primeiros produtos:

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

Essa ação recupera dados do JSON com um conjunto de três produtos, conforme mostrado a seguir:

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

Deslocamento

Ao usar o atributo deslocamento, você pode mover o limite inferior do bloco de resultados. Por exemplo, se estiver interessado em recuperar os 50 produtos que seguem à resposta padrão:

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

A resposta acima recupera 50 produtos a partir dos primeiros cinquenta.

Definição de uma faixa de resultados

Ambos os parâmetros podem ser combinados. Você pode recuperar produtos do terceiro ao sexto no resultado da busca original:

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

Essa ação recupera um dado do JSON com um conjunto de cinco produtos, conforme mostrado a seguir:

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



Próximo:
Localização de produtos.

Please rate this