Contenidos

→Buscar productos
→Determinar el producto exacto a vender
→Productos parents y children
→Elegir el producto específico para publicar


Buscar productos

Previo a publicar un producto en catálogo debes confirmar, utilizando el buscador de productos, el producto correcto que venderás, si éste se encuentra activo y sus características. Este recurso te permite identificar los productos para publicar de manera directa en catálogo y/o mediante publicaciones asociadas.
Los parámetros del buscador de productos pueden ser el código universal o un conjunto de palabras clave, por ejemplo marca y modelo.


Parámetros

site_id: (obligatorio) string que representa el país.
status: puede ser que si bien el producto está identificado dentro de nuestro catálogo, aún no es elegible para asociar a una publicación.

  • status=active: devuelve aquellos productos que ya pueden elegirse para asociar a una publicación.
  • status=inactive: devuelve aquellos productos que todavía no son elegibles para asociar a una publicación.
Nota:
Si no envías este parámetro, por defecto traerá todos los resultados, tanto activos como inactivos.

q: string con palabras claves de búsqueda. Ejemplo: “Celular Samsung Galaxy S8”. Obligatorio en caso no se envíe un product_identifier.
product_identifier: (obligatorio) string con el código universal del producto. Ejemplo: GTIN el cual engloba los diferentes PIs (EAN, UPC, ISBN, etc). Obligatorio en caso no se envíe una cadena de palabras claves.
domain_id: (opcional) string con el dominio en el cual se quiere publicar.
offset: (opcional) posición desde la que se devuelven los resultados de la búsqueda.
limit: (opcional) cantidad de resultados que devuelve la búsqueda.


Llamada con parámetro “q”:

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

Ejemplo con parámetro “q”:

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

Respuesta con parámetro “q”:

{
    "keywords": "Samsung Galaxy S8",
    "paging": {
        "total": 5,
        "limit": 10,
        "offset": 0
    },
    "results": [
        {
            "id": "MLA6408700",
            "status": "active",
            "domain_id": "MLA-CELLPHONES",
            "name": "Samsung Galaxy S8 64 GB Oro arce",
            "attributes": [
                {
                    "id": "BRAND",
                    "name": "Marca",
                    "value_id": "206",
                    "value_name": "Samsung"
                },
            ],
            "pictures": [
                {
                    "id": "661005-MLA31003118709_062019",
                    "url": "https://mla-s2-p.mlstatic.com/661005-MLA31003118709_062019-F.jpg"
                },
                {
                    "id": "622366-MLA31003080250_062019",
                    "url": "https://mla-s2-p.mlstatic.com/622366-MLA31003080250_062019-F.jpg"
                },
                {
                    "id": "807399-MLA31003000897_062019",
                    "url": "https://mla-s2-p.mlstatic.com/807399-MLA31003000897_062019-F.jpg"
                },
                {
                    "id": "785278-MLA31003118710_062019",
                    "url": "https://mla-s1-p.mlstatic.com/785278-MLA31003118710_062019-F.jpg"
                }
            ]
        }
    ]
}

Llamada con parámetros “q” y “domain_id”:

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

Ejemplo con parámetros “q” y “domain_id”:

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

Respuesta con parámetros “q” y “domain_id”:

{
  "q": "Samsung Galaxy S8",
  "domain_id":"MLA-CELLPHONES",
  "paging": {
    "total": 10,
    "offset": 0,
    "limit": 10
  },
  "results": [
    {
      "id": "MLA6408699",
      "status": "active",
      "domain_id": "MLA-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-MLA31003000895_062019",
          "url": "https://mla-s2-p.mlstatic.com/924348-MLA31003000895_062019-F.jpg"
        }
      ]
    }
  ]
}

Llamada con parámetro “product_identifier”:

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

Ejemplo con parámetro “product_identifier”:

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

Respuesta con parámetro “product_identifier”:

{ 
  "product_identifier": "0123456789", 
  "paging": {
      "total": 10, 
      "offset": 0, 
      "limit": 10 
   }, 
   "results": [ 
        { 
          "id": "MLA6408699", 
          "status": "active", 
          "domain_id": "MLA-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-MLA31003000895_062019", 
                 "url": "https://mla-s2-p.mlstatic.com/924348-MLA31003000895_062019-F.jpg" 
              } 
           ] 
        } 
     ] 
  }
Notas:
- Dependiendo los parámetros utilizados para la búsqueda, obtendremos como resultado uno o varios productos como sugerencia.
- Si se utiliza como parámetro un product_identifier, se obtendrá solo un producto.
- Si se utiliza como parámetro una keyword, ya sea con o sin un dominio, se podrán obtener uno o varios productos que se relacionen a los valores ingresados.

Determinar el producto exacto a vender

Para que un ítem pueda ser publicado en catálogo y ser comprado, tiene que estar asociado a un producto suficientemente específico tal que el comprador pueda saber con precisión qué está comprando y para el cual Mercado Libre haya creado el contenido (productos con status=”active” en el recurso /products/{catalog_product_id}).

Importante:
El contenido de la publicación de catálogo es provisto por Mercado Libre. Por lo tanto, el vendedor es responsable de confirmar que el producto a asociar coincida con las características específicas que se muestran en la plataforma.
En caso que exista una diferencia entre lo que el usuario compre y el producto asociado es posible, que se generen reclamos y/o cancelaciones que impactarán negativamente en su reputación y como consecuencia de esto la inhabilitación para publicar en catálogo, llevando eventualmente a la suspensión de la cuenta.

Productos parents y children

En muchos dominios existen dos niveles de productos:

Productos de nivel superior (“parents”) que agrupan productos específicos y no son en sí mismos aptos para ser comprados. Ejemplo: Motorola Moto G6. Este no tiene la capacidad ni el color especificado.
Productos de nivel terminal (“children”) suficientemente especificados para ser comprados. Ejemplo: Motorola G6 32 GB Índigo oscuro.

Ejemplo de un producto parent (no es específico y no se puede comprar):

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

Respuesta:

{
  "id": "MLA9652753",
  "status": "inactive",
  "domain_id": "MLA-CELLPHONES",
  "permalink": "https://www.mercadolibre.com.ar/p/MLA9652753",
  "name": "Motorola Moto G6",
  "buy_box_winner": null,
  "pickers": null,
  "pictures": null,
  "main_features": null,
  "attributes": [],
  "short_description": {},
  "parent_id": "",
  "children_ids": [
    "MLA9652754",
    "MLA9652755",
    "MLA9652756",
    "MLA9652757",
    "MLA9707910",
    "MLA9707911",
    "MLA9707912",
    "MLA9707913"
  ]
}

Ejemplo de un producto children (específico y se puede usar para publicar y comprar si está activo):

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

Respuesta:

{
  "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": [
  ]
}

Lo que nos interesa a los efectos de publicar es:

children_ids

  • Si el campo está vacío se trata de un producto children el cual es suficientemente específico para publicar.
  • Si este array contiene IDs de otros productos, quiere decir que el catalog_product_id actual corresponde a un producto parent (no completamente especificado). Para publicar en catálogo debemos buscar el producto específico entre sus children_ids.

status

  • Para poder crear una publicación de catálogo es necesario que el producto tenga status=”active”.
  • Los productos “parent” nunca tendrán status=”active” porque no son comprables.

Elegir el producto específico para publicar

Tu publicación y/o tus variaciones elegibles para catálogo poseerán un catalog_product_id que deberás verificar que es adecuado para publicar utilizando el recurso /products/$CATALOG_PRODUCT_ID.

Ejemplo de “catalog_product_id” en un ítem:

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

Respuesta acotada:

{
    "id": "MLA123456789",
    "site_id": "MLA",
    "title": "ITEM DE TESTEO",
    "subtitle": null,
    "seller_id": 337011113,
    "category_id": "MLA22195",
    "price": 14330,
    "available_quantity": 50,
    "catalog_product_id": "MLA14793781",
    "domain_id": "MLA-AUTOMOTIVE_TIRES"
}

Al momento de crear una publicación de catálogo a partir de una publicación existente elegible, tienes que verificar con nuestro recurso de Productos:

  • Si el catalog_product_id corresponde a un producto con status active, estás listo para publicar en catálogo utilizando ese catalog_product_id.
  • Si el catalog_product_id corresponde a un producto con status inactive.
  • Si el array children_ids está vacío quiere decir que la publicación o variación ya está asociada al producto más específico que tenemos y éste no está aún listo para publicarse en catálogo, por lo que no podrás crear la publicación de catálogo hasta que el producto esté editado por Mercado Libre.
  • Si el array children_ids no está vacío, deberás buscar entre los productos children el que corresponde exactamente con lo que estás vendiendo.
  • Si encuentras un catalog_product_id children activo que corresponda exactamente con lo que quieres vender, puedes utilizarlo en el siguiente paso para crear tu publicación de catálogo.
  • Si entre los catalog_product_id children no encuentras tu producto exacto o lo encuentras pero no está activo, no podrás publicar en esta oportunidad ese producto en el catálogo y deberás esperar a que Mercado Libre cree el producto y lo editorialice.

Siguiente: Publicación en catálogo.