Conteúdos

→Buscar produtos
→Determinar o produto exato a ser vendido
→Produto por ID
→Produtos pai e filho
→Escolhendo o produto específico para o meu anúncio


Buscar produtos

Antes de publicar um produto em um catálogo, você deve confirmar, usando o search buscador de produtos, o produto correto que venderá, se estiver ativo e suas características. Este recurso permite identificar os produtos a serem publicados diretamente no catálogo e / ou através de publicações associadas. Os parâmetros da busca do produto podem ser o código universal ou um conjunto de palavras-chave, por exemplo, marca e modelo. Adicionando às opções, a possibilidade de realizar um POST com uma combinação de atributos do catálogo.


Parâmetros

site_id: string que representa o país. Obrigatório.
status: pode ser que, embora o produto esteja identificado dentro do nosso catálogo, ainda não seja elegível para ser associado a um anúncio.

  • status “active”: retorna os produtos que já podem ser escolhidos para associar a um anúncio.
  • status “inactive”: retorna os produtos que ainda não podem ser escolhidos para associar a um anúncio.
Nota:
Se este parâmetro não for enviado, por padrão, ele trará todos os resultados, tanto ativos quanto inativos.

q: string com palavras-chave de busca. Exemplo: “Celular Samsung Galaxy S8” Obrigatório, caso não seja enviado um product_identifier.
product_identifier: string com o código universal do produto. Exemplo: EAN, UPC, ISBN etc. Obrigatório, caso não seja enviada uma cadeia de palavras-chave.
domain_id: string com o domínio no qual se quer anunciar (opcional).
offset: posição da qual são retornados os resultados da busca (opcional).
limit: número de resultados retornados pela busca (opcional).


Chamada com parâmetro "q":

curl -X GET https://api.mercadolibre.com/products/search?status=$STATUS_ID&site_id=$SITE_ID&q={q}

Exemplo com parâmetro "q":

curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLB&q=Samsung%20Galaxy%20S8

Resposta com parâmetro "q":

{
    "keywords": "Samsung Galaxy S8",
    "paging": {
        "total": 5,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLB6408702",
            "status": "active",
            "domain_id": "MLB-CELLPHONES",
            "name": "Samsung Galaxy S8 64 GB Azul-coral",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "206",
                    "value_name": "Samsung"
                },
            ],
            "pictures": [
                {
                    "id": "907751-MLA31348023274_072019",
                    "url": "https://mla-s2-p.mlstatic.com/907751-MLA31348023274_072019-F.jpg"
                },
                {
                    "id": "972557-MLA31347859895_072019",
                    "url": "https://mla-s1-p.mlstatic.com/972557-MLA31347859895_072019-F.jpg"
                },
                {
                    "id": "727533-MLA31348023275_072019",
                    "url": "https://mla-s1-p.mlstatic.com/727533-MLA31348023275_072019-F.jpg"
                },
                {
                    "id": "779614-MLA31348110125_072019",
                    "url": "https://mla-s1-p.mlstatic.com/779614-MLA31348110125_072019-F.jpg"
                }
            ]
        }
    ]
}

Chamada com parâmetros "q" e "domain_id":

curl -X GET https://api.mercadolibre.com/products/search?status=$STATUS_ID&site_id=$SITE_ID&q={q}&domain_id=$DOMAIN_ID

Exemplo com parâmetros "q" e "domain_id":

curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLB&q=Samsung%20Galaxy%20S8&domain_id=MLA-CELLPHONES

Resposta com parâmetros "q" e "domain_id":

{
  "q": "Samsung Galaxy S8",
  "domain_id":"MLB-CELLPHONES",
  "paging": {
    "total": 10,
    "offset": 0,
    "limit": 10
  },
  "results": [
    {
      "id": "MLB6408699",
      "status": "active",
      "domain_id": "MLB-CELLPHONES",
      "name": "Samsung Galaxy S8 64 GB Gris orquídea",
      "description": "descripción",
      "attributes": [
        {
          "id": "BRAND",
          "name": "Marca",
          "value_id": "206",
          "value_name": "Samsung"
        }
      ],
      "pictures": [
        {
          "id": "924348-MLB31003000895_062019",
          "url": "https://mlb-s2-p.mlstatic.com/924348-MLB31003000895_062019-F.jpg"
        }
      ]
    }
  ]
}

Chamada com parâmetro "product_identifier":

curl -X GET https://api.mercadolibre.com/products/search?status=$STATUS_ID&site_id=$SITE_ID&product_identifier=$PRODUCT_IDENTIFIER

Exemplo com parâmetro "product_identifier":

curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLB&product_identifier=0123456789

Resposta com parâmetro "product_identifier":

{ 
  "product_identifier": "0123456789", 
  "paging": {
      "total": 10, 
      "offset": 0, 
      "limit": 10 
   }, 
   "results": [ 
        { 
          "id": "MLB6408699", 
          "status": "active", 
          "domain_id": "MLB-CELLPHONES", 
          "name": "Samsung Galaxy S8 64 GB Gris orquídea", 
          "description": "descripción", 
          "attributes": [
                { 
                   "id": "BRAND", 
                  "name": "Marca", 
                  "value_id": "206", 
                  "value_name": "Samsung" 
                } 
           ], 
         "pictures": [ 
              { 
                 "id": "924348-MLB31003000895_062019", 
                 "url": "https://mla-s2-p.mlstatic.com/924348-MLB31003000895_062019-F.jpg" 
              } 
           ] 
        } 
     ] 
  }

Exemplo com atributos de catálogo:

curl -X POST https://api.mercadolibre.com/products/search?access_token=$ACCESS_TOKEN
{
   "domain_id":"MLA-CELLPHONES",
   "site_id":"MLA",
   "status":"active",
   "attributes":  [
        {
         "id": "BRAND",
         "value_id": "206"
        },
        {
         "id": "LINE",
         "value_name": "Galaxy"
        },
        {
         "id": "IS_DUAL_SIM",
         "value_name": "Si"
        }
   ]
}

Resposta resumida com atributos de catálogo:

{
    "domain_id": "MLA-CELLPHONES",
    "paging": {
        "total": 9,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA13316403",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "settings": {
                "listing_strategy": "open"
            },
            "name": "Samsung Galaxy Folder 2 Dual SIM 16 GB Negro 2 GB RAM",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "206",
                    "value_name": "Samsung"
                },
                {
                    "id": "LINE",
                    "name": "Línea",
                    "value_id": "43675",
                    "value_name": "Galaxy"
                },
                {
                    "id": "MODEL",
                    "name": "Modelo",
                    "value_id": "8212554",
                    "value_name": "Folder 2 Duos"
                },
                {
                    "id": "IS_DUAL_SIM",
                    "name": "Es Dual SIM",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "COLOR",
                    "name": "Color",
                    "value_id": "52049",
                    "value_name": "Negro"
                },
                {
                    "id": "INTERNAL_MEMORY",
                    "name": "Memoria interna",
                    "value_id": "59561",
                    "value_name": "16 GB"
                },
                {
                    "id": "RAM",
                    "name": "Memoria RAM",
                    "value_id": "445970",
                    "value_name": "2 GB"
                },
                {
                    "id": "MAIN_COLOR",
                    "name": "Color principal",
                    "value_id": "2450295",
                    "value_name": "Negro"
                },
                {
                    "id": "OPERATING_SYSTEM_NAME",
                    "name": "Nombre del sistema operativo",
                    "value_id": "7403813",
                    "value_name": "Android"
                },
                {
                    "id": "OPERATING_SYSTEM_VERSION",
                    "name": "Versión del sistema operativo",
                    "value_id": "7206970",
                    "value_name": "6.0 Marshmallow"
                },
                {
                    "id": "DISPLAY_SIZE",
                    "name": "Tamaño de la pantalla",
                    "value_id": "7762087",
                    "value_name": "3.8 \""
                },
                {
                    "id": "DISPLAY_RESOLUTION",
                    "name": "Resolución de la pantalla",
                    "value_id": "7222488",
                    "value_name": "480 px x 800 px"
                },
                {
                    "id": "MAIN_REAR_CAMERA_RESOLUTION",
                    "name": "Resolución de la cámara trasera principal",
                    "value_id": "7199614",
                    "value_name": "8 Mpx"
                },
                {
                    "id": "REAR_CAMERA_RECORDING_RESOLUTION",
                    "name": "Resolución de video de la cámara trasera",
                    "value_id": "7199621",
                    "value_name": "1920 px x 1080 px"
                },
                {
                    "id": "MAIN_FRONT_CAMERA_RESOLUTION",
                    "name": "Resolución de la cámara frontal principal",
                    "value_id": "7199627",
                    "value_name": "5 Mpx"
                },
                {
                    "id": "WITH_FINGERPRINT_READER",
                    "name": "Con lector de huella digital",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "BATTERY_CAPACITY",
                    "name": "Capacidad de la batería",
                    "value_id": "8212557",
                    "value_name": "1950 mAh"
                },
                {
                    "id": "NUMBER_OF_SIM_CARD_SLOTS",
                    "name": "Cantidad de ranuras para tarjeta SIM",
                    "value_id": "2087802",
                    "value_name": "2"
                },
                {
                    "id": "SIM_SIZES",
                    "name": "Tamaños de tarjeta SIM compatibles",
                    "value_id": "80453",
                    "value_name": "Nano-SIM"
                },
                {
                    "id": "WITH_ESIM",
                    "name": "Con eSIM",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "WEIGHT",
                    "name": "Peso",
                    "value_id": "2087854",
                    "value_name": "165 g"
                },
                {
                    "id": "HEIGHT",
                    "name": "Altura",
                    "value_id": "4369069",
                    "value_name": "122 mm"
                },
                {
                    "id": "WIDTH",
                    "name": "Ancho",
                    "value_id": "7936922",
                    "value_name": "60.2 mm"
                },
                {
                    "id": "DEPTH",
                    "name": "Profundidad",
                    "value_id": "8212558",
                    "value_name": "16.1 mm"
                },
                {
                    "id": "PIXELS_PER_INCH",
                    "name": "Píxeles por pulgada",
                    "value_id": "8212555",
                    "value_name": "246 ppi"
                },
                {
                    "id": "SCREEN_TECHNOLOGY",
                    "name": "Tecnología de pantalla",
                    "value_id": "80489",
                    "value_name": "TFT"
                },
                {
                    "id": "WITH_TOUCH_SCREEN",
                    "name": "Con pantalla táctil",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_PHYSICAL_QWERTY_KEYBOARD",
                    "name": "Con teclado QWERTY físico",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "WITH_CAMERA",
                    "name": "Con cámara",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "REAR_CAMERAS_NUMBER",
                    "name": "Cantidad de cámaras traseras",
                    "value_id": "7477198",
                    "value_name": "1"
                },
                {
                    "id": "REAR_CAMERA_APERTURE",
                    "name": "Apertura del diafragma de la cámara trasera",
                    "value_id": "7441410",
                    "value_name": "f 1.9"
                },
                {
                    "id": "FRONT_CAMERAS_NUMBER",
                    "name": "Cantidad de cámaras frontales",
                    "value_id": "7477216",
                    "value_name": "1"
                },
                {
                    "id": "FRONT_CAMERA_RECORDING_RESOLUTION",
                    "name": "Resolución de video de la cámara frontal",
                    "value_id": "7180687",
                    "value_name": "1280 px x 720 px"
                },
                {
                    "id": "FRONT_CAMERA_APERTURE",
                    "name": "Apertura del diafragma de la cámara frontal",
                    "value_id": "7439050",
                    "value_name": "f 1.9"
                },
                {
                    "id": "WITH_FRONT_CAMERA_FLASH",
                    "name": "Con flash en la cámara frontal",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "MOBILE_NETWORK",
                    "name": "Red",
                    "value_id": "367876",
                    "value_name": "4G/LTE"
                },
                {
                    "id": "MEMORY_CARD_TYPES",
                    "name": "Tipos de tarjeta de memoria",
                    "value_id": "7199655",
                    "value_name": "MicroSD"
                },
                {
                    "id": "MAX_MEMORY_CARD_CAPACITY",
                    "name": "Capacidad máxima de la tarjeta de memoria",
                    "value_id": "2087792",
                    "value_name": "256 GB"
                },
                {
                    "id": "PROCESSOR_MODEL",
                    "name": "Modelo del procesador",
                    "value_id": "2087879",
                    "value_name": "Snapdragon 425"
                },
                {
                    "id": "CPU_MODELS",
                    "name": "Modelos de CPU",
                    "value_id": "7657686",
                    "value_name": "4x1.4 GHz Cortex-A53"
                },
                {
                    "id": "PROCESSOR_CORES_NUMBER",
                    "name": "Cantidad de núcleos del procesador",
                    "value_id": "7206949",
                    "value_name": "4"
                },
                {
                    "id": "PROCESSOR_SPEED",
                    "name": "Velocidad del procesador",
                    "value_id": "1151166",
                    "value_name": "1.4 GHz"
                },
                {
                    "id": "GPU_MODEL",
                    "name": "Modelo de GPU",
                    "value_id": "7531831",
                    "value_name": "Adreno 308"
                },
                {
                    "id": "WITH_USB_CONNECTOR",
                    "name": "Con conector USB",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_WIFI",
                    "name": "Con Wi-Fi",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_GPS",
                    "name": "Con GPS",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_BLUETOOTH",
                    "name": "Con Bluetooth",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_MINI_HDMI",
                    "name": "Con mini HDMI",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "WITH_RADIO",
                    "name": "Con radio",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "WITH_TV_TUNER",
                    "name": "Con sintonizador de TV",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "WITH_ACCELEROMETER",
                    "name": "Con acelerómetro",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_PROXIMITY_SENSOR",
                    "name": "Con sensor de proximidad",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "WITH_GYROSCOPE",
                    "name": "Con giroscopio",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "IS_SPLASH_RESISTANT",
                    "name": "Es resistente a salpicaduras",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "IS_WATER_RESISTANT",
                    "name": "Es resistente al agua",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "IS_WATERPROOF",
                    "name": "Es a prueba de agua",
                    "value_id": "242084",
                    "value_name": "No"
                },
                {
                    "id": "BATTERY_TYPE",
                    "name": "Tipo de batería",
                    "value_id": "95013",
                    "value_name": "Ion de litio"
                },
                {
                    "id": "WITH_REMOVABLE_BATTERY",
                    "name": "Con batería removible",
                    "value_id": "242085",
                    "value_name": "Sí"
                },
                {
                    "id": "STANDBY_TIME",
                    "name": "Duración de la batería en espera",
                    "value_id": "7835954",
                    "value_name": "318 h"
                }
            ],
            "pictures": [
                {
                    "id": "636253-MLA41570339037_042020",
                    "url": "https://mla-s2-p.mlstatic.com/636253-MLA41570339037_042020-F.jpg"
                },
                {
                    "id": "819635-MLA41570339038_042020",
                    "url": "https://mla-s2-p.mlstatic.com/819635-MLA41570339038_042020-F.jpg"
                },
                {
                    "id": "690923-MLA41569811814_042020",
                    "url": "https://mla-s2-p.mlstatic.com/690923-MLA41569811814_042020-F.jpg"
                },
                {
                    "id": "976286-MLA41569811805_042020",
                    "url": "https://mla-s1-p.mlstatic.com/976286-MLA41569811805_042020-F.jpg"
                }
            ]
        }
}
Notas:
- Os parâmetros domain_id, site_id e attributes são obrigatórios.
- Dependendo dos parâmetros usados na busca, haverá como resultado um ou vários produtos como sugestão.
- Se um product_identifier for usado como parâmetro, só será obtido um produto.
- Se uma palavra-chave for usada como parâmetro, com ou sem domínio, poderá ser obtido um ou vários produtos relacionados aos valores informados.
- Se for utilizado um POST com atributos, a pesquisa é mais específica e pode trazer vários resultados, porém específicos, sobre os atributos enviados no POST.
* Pelo menos 3 atributos diferentes devem ser adicionados no campo attributes.
* Todos os atributos na lista de atributos devem ter um "id" (id do atributo) e um value_id (id do valor do atributo) ou value_name (valor do atributo)

Determinar o produto exato a ser vendido

Para que um item possa ser anunciado no catálogo e ser comprado, ele deve estar associado a um produto específico o bastante, para que o comprador possa saber exatamente o que está comprando, e para o qual o Mercado Livre tenha criado o conteúdo (produtos com status ”active” no recurso /products/{product_id})


Produto por ID

Uma vez identificado o produto dentro do domínio, você pode conhecer suas características principais com o recurso /catalog_products/<product_id>. Assim, você poderá criar um item de melhor qualidade, com todas as características possíveis.
Chamada:

curl -X GET https://api.mercadolibre.com/catalog_products/$PRODUCT_ID

Exemplo:

curl -X GET https://api.mercadolibre.com/catalog_products/MLA824561

Resposta:

{
  "id": "MLA824561",
  "domain_id": "MLA-MICROWAVES",
  "name": "LG MB-4344B",
  "children_ids": [
    "MLA10821363"
  ],
  "attributes": [
    {
      "id": "BRAND",
      "name": "Marca",
      "value_id": "215",
      "value_name": "LG"
    },
    {
      "id": "MODEL",
      "name": "Modelo",
      "value_id": "3916190",
      "value_name": "MB-4344B"
    }
  ],
  "images": [
  ],
  "last_updated": "2019-06-11T18:28:04Z"
}

Comportamientos especiales

  • Quando o produto tiver "status": "inactive" os campos "pictures", "pickers" e "main_features" virão com null. E os campos dentro de "short_description" estão vazios.
  • O campo "buy_box_winner" indica o item do catálogo que atualmente possui a buybox "ganha". Quando não há itens do catálogo competindo pela buybox para este produto, este campo é nulo.
Importante:
O conteúdo do anúncio de catálogo é fornecido pelo Mercado Livre. Portanto, o vendedor é responsável por conferir que o produto a ser associado coincida com as características específicas mostradas na plataforma.
Se houver alguma diferença entre o que o usuário comprar e o produto associado, é possível que existam reclamações e/ou cancelamentos que vão impactar negativamente na sua reputação e, por conseguinte, será inabilitado para anunciar em catálogo, levando, eventualmente, ao cancelamento da conta.

Produtos pai e filho

Em muitos domínios (não em todos), existem dois níveis de produtos:

Produtos pai ("parents"), que reúnem produtos específicos e que não podem ser comprados. Por exemplo: Motorola Moto G6 ⇐ Não tem a capacidade nem a cor especificadas!

Produtos filho ("children") suficientemente especificados para sua compra. Por exemplo: Motorola Moto G6 32GB Índigo escuro.


Exemplo de produto parent (não é específico e não pode ser comprado):

curl -X GET https://api.mercadolibre.com/products/MLB9652753

Resposta:

{
  "id": "MLB9652753",
  "status": "inactive",
  "domain_id": "MLB-CELLPHONES",
  "permalink": "https://www.mercadolivre.com.br/p/MLB9652753",
  "name": "Motorola Moto G6",
  "buy_box_winner": null,
  "pickers": null,
  "pictures": null,
  "main_features": null,
  "attributes": [],
  "short_description": {},
  "parent_id": "",
  "children_ids": [
    "MLB9652754",
    "MLB9652755",
    "MLB9652756",
    "MLB9652757",
    "MLB9707910",
    "MLB9707911",
    "MLB9707912",
    "MLB9707913"
  ]
}

Exemplo de produto children (específico e pode ser usado para anunciar e comprar, se estiver ativo):

curl -X GET https://api.mercadolibre.com/products/MLB9652754

Resposta:

{
  "id": "MLA9652754",
  "status": "active",
  "domain_id": "MLA-CELLPHONES",
  "permalink": "https://www.mercadolibre.com.ar/p/MLA9652754",
  "name": "Motorola G6 32 GB Índigo oscuro",
  "buy_box_winner": {},
  "pickers": [],
  "pictures": [],
  "main_features": [],
  "attributes": [],
  "short_description": {},
  "parent_id": "MLA9652753",
  "children_ids": [
  ]
}

O que nos interessa em relação ao anúncio é:

children_ids

  • Se o campo estiver vazio, trata-se de um produto filho e é específico o bastante para ser anunciado.
  • Se contém IDs de outros produtos, isso quer dizer que o catalog_product_id atual corresponde a um produto pai (não completamente especificado). Para anunciar no catálogo, devemos buscar o produto específico entre seus children_ids.

status

  • Para poder criar um anúncio de catálogo, é necessário que o produto tenha status ”active”.
  • Os produtos "parent" nunca terão status ”active”, pois não podem ser comprados.

Escolhendo o produto específico para o meu anúncio

Seu anúncio e/ou suas variações elegíveis para catálogo terão um catalog_product_id onde você deverá conferir se é adequado para ser anunciado usando o recurso /products/{catalog_product_id}

Exemplo de “catalog_product_id” em um item:

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

Resposta resumida:

{
    "id": "MLB123456789",
    "site_id": "MLB",
    "title": "ITEM DE TESTE",
    "subtitle": null,
    "seller_id": 337011113,
    "category_id": "MLB22195",
    "price": 14330,
    "available_quantity": 50,
    "catalog_product_id": "MLB14793781",
    "domain_id": "MLB-AUTOMOTIVE_TIRES"
}

Na hora de criar um anúncio de catálogo a partir de um anúncio existente elegível, você deve conferir com nosso recurso de Produtos:

  • Se o catalog_product_id corresponder a um produto com status “active”, você pode anunciar no catálogo usando esse catalog_product_id
  • Se o catalog_product_id corresponder a um produto que está com status “inactive”.
  • Se o array children_ids estiver vazio, isso quer dizer que o anúncio ou variação já foi associada ao produto mais específico que temos e este ainda não está pronto para ser anunciado no catálogo, portanto, você não pode criar o anúncio de catálogo até que o produto tenha sido editado pelo Mercado Livre.
  • Se o array children_ids não estiver vazio, você deve procurar entre os produtos filho aquele que corresponder exatamente ao que você estiver vendendo.
  • Se você encontrar um catalog_product_id filho ativo que corresponder exatamente ao que você quer vender, pode usá-lo na etapa seguinte para criar seu anúncio de catálogo.
  • Se você não encontrar seu produto exato entre os catalog_product_id filho, ou se encontrar mas não estiver ativo, você não pode anunciar esse produto no catálogo e deve esperar até que o Mercado Livre crie e edite o produto.

Seguinte: Publicação no catálogo.

ou registre-se para receber as últimas notícias sobre nossa API