Conteúdos
Buscar produtos
Antes de efetura uma publicação em um catálogo, você deve confirmar, usando o search buscador de produtos, o produto correto que venderá, se está ativo e suas características. Este recurso permite identificar os produtos a serem publicados diretamente em 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.
Parâmetros
site_id: string que representa o país. (Campo Obrigatório). status: existente casos onde produto está identificado dentro do nosso catálogo, mas ainda não está 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.
q: string com palavras-chave de busca. Exemplo: “Celular Samsung Galaxy S8”(Campo 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. (Campo 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/products/search?status=$STATUS_ID&site_id=$SITE_ID&q={q}
Exemplo com parâmetro "q":
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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
{
"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"
}
]
}
}
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 evitando assim reclamacão. Para isso, valide o conteúdo seu produto em (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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/catalog_products/$PRODUCT_ID
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 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"
}
Comportamentos especias
- Quando o produto tiver "status": "inactive" os campos "pictures", "pickers" e "main_features" retornarão com null. E os campos dentro de "short_description" estarão vazios.
- O campo "buy_box_winner" indica que o item do catálogo que atualmente possui a buybox " está ganhando". Quando não há itens do catálogo competindo pela buybox para este produto, este campo será nulo.
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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 -H 'Authorization: Bearer $ACCESS_TOKEN' 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 deverão ter 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 -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB123456789
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.
