• API Docs
  • Guia para productos
  • Tipos de publicación
Última actualización 30/05/2023

Tipos de publicación y cómo obtener mayor exposición

De acuerdo con el nivel de exposición que desees para tus artículos, podrás elegir entre diferentes tipos de publicación. Cada tipo de publicación tiene sus propias características y feeds. Veamos cómo trabajar correctamente con ellos.

Tipos de publicación por site

Importante:
A partir del 21 de junio de 2023 en MPE (Perú) y del 4 de julio de 2023 en MEC (Ecuador), el listing type gold_special (ítem premium) será automáticamente cambiado para gold_pro.

Conoce los diferentes tipos de publicación por sitio de Mercado Libre. Para conocer los ID disponibles, ejecuta https://api.mercadolibre.com/sites.


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types

Respuesta:

[
  {
    "site_id": "MLA",
    "id": "gold_pro",
    "name": "Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_premium",
    "name": "Oro Premium"
  },
  {
    "site_id": "MLA",
    "id": "gold_special",
    "name": "Clásica"
  },
  {
    "site_id": "MLA",
    "id": "gold",
    "name": "Oro"
  },
  {
    "site_id": "MLA",
    "id": "silver",
    "name": "Plata"
  },
  {
    "site_id": "MLA",
    "id": "bronze",
    "name": "Bronce"
  },
  {
    "site_id": "MLA",
    "id": "free",
    "name": "Gratuita"
  }
]

Especificación del tipo de publicación

Si deseas más información sobre un listing_type específico, incluye el listing_type en la llamada GET:


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_types/bronze

Respuesta:

{
  "id": "bronze",
  "not_available_in_categories": [
    "MLA1743",
    "MLA1459"
  ],
  "configuration": {
    "name": "Bronce",
    "listing_exposure": "low",
    "requires_picture": false,
    "max_stock_per_item": 9999,
    "deduction_profile_id": null,
    "differential_pricing_id": null,
    "duration_days": {
      "buy_it_now": 60,
      "auction": 7,
      "classified": null
    },
    "immediate_payment": {
      "buy_it_now": false,
      "auction": false,
      "classified": false
    },
    "mercado_pago": "mandatory",
    "listing_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 0,
      "percentage_of_fee_amount": 0,
      "currency": "ARS"
    },
    "sale_fee_criteria": {
      "min_fee_amount": 0,
      "max_fee_amount": 100000000000000000,
      "percentage_of_fee_amount": 11,
      "currency": "ARS"
    }
  },
  "exceptions_by_category": [
    {
      "category_id": "MLA1540",
      "category_name": "Servicios",
      "configuration": {
        "name": "Básico 90",
        "listing_exposure": "mid",
        "requires_picture": false,
        "max_stock_per_item": 999,
        "deduction_profile_id": null,
        "differential_pricing_id": null,
        "duration_days": {
          "buy_it_now": null,
          "auction": null,
          "classified": 90
        },
        "immediate_payment": {
          "buy_it_now": false,
          "auction": false,
          "classified": false
        },
        "mercado_pago": "not_available",
        "listing_fee_criteria": {
          "min_fee_amount": 347,
          "max_fee_amount": 347,
          "percentage_of_fee_amount": 0,
          "currency": "ARS"
        },
        "sale_fee_criteria": {
          "min_fee_amount": 0,
          "max_fee_amount": 0,
          "percentage_of_fee_amount": 0,
          "currency": null
        }
      },
      "exceptions_by_category": [
      ]
    }
  ]
}

Los artículos Clásica y Premium tendrán una duración ilimitada; puedes consultarlo en el campo stop_time:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MCO415406202?attributes=stop_time

Además, se pausarán estas publicaciones si el stock está en 0 y se activarán cuando agregues una nueva cantidad. Verás el artículo de la siguiente manera:

"status": "paused",
  "sub_status": [
    "out_of_stock"
  ]

Si deseas agregar stock y activar nuevamente el artículo, deberías hacer lo siguiente:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "available_quantity": 1
}
https://api.mercadolibre.com/items/$ITEM_ID

Recuerda que el tipo de publicación Gratuita mantendrá el flujo actual. El vendedor podría cambiar entre los tipos de publicación Clásica y Premium cada vez que lo desee sin cargo, y podría poner los artículos en pausa y terminar de la misma manera en que funciona ahora.
Si deseas cambiar de Premium a Clásica, deberás seguir estos pasos: 

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "id": "gold"
}
https://api.mercadolibre.com/items/$ITEM_ID/listing_type


Tipos de publicación disponibles

Puedes consultar los tipos de publicación disponibles por usuario y para un category_id determinado.


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/available_listing_types?category_id=$CATEGORY_ID

Respuesta:

{
  "category_id": "MLC3530",
  "available": [
	{
  	"site_id": "MLC",
  	"id": "gold_premium",
  	"name": "Oro Premium",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "gold",
  	"name": "Oro",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "silver",
  	"name": "Plata",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "bronze",
  	"name": "Bronce",
  	"remaining_listings": null
	},
	{
  	"site_id": "MLC",
  	"id": "free",
  	"name": "Gratuita",
  	"remaining_listings": null
	}
  ]
}

Si no puedes publicar en cierto tipo de publicación y quieres saber por qué no está disponible para ti, puedes realizar esta llamada GET para averiguar el motivo:


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/available_listing_type/free?category_id=$CATEGORY_ID

Respuesta:

{
  "available": false,
  "cause": "You have more than 5 transactions in the last year.",
  "code": "list.transactions.exceeded"
}


Exposiciones de las publicaciones

Esta API devuelve información sobre los niveles de exposición asociados a todos los tipos de publicaciones en Mercado Libre. Puedes consultar todas las exposiciones disponibles para las publicaciones por site, con una simple llamada GET.


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_exposures

Respuesta:

{[
  {
	"id": "lowest",
	"name": "Última",
	"home_page": false,
	"category_home_page": false,
    "advertising_on_listing_page": true,
	"priority_in_search": 4
  },
  {
	"id": "low",
	"name": "Inferior",
	"home_page": false,
	"category_home_page": false,
    "advertising_on_listing_page": false,
	"priority_in_search": 3
  },
  {
	"id": "mid",
	"name": "Media",
	"home_page": false,
	"category_home_page": true,
	"advertising_on_listing_page": false,
	"priority_in_search": 2
  },
  {
	"id": "high",
	"name": "Alta",
	"home_page": false,
	"category_home_page": true,
    "advertising_on_listing_page": false,
	"priority_in_search": 1
  },
  {
	"id": "highest",
	"name": "Superior",
	"home_page": true,
	"category_home_page": true,
    "advertising_on_listing_page": false,
	"priority_in_search": 0
  }
]

Y consultar cada una por su ID:


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/sites/MLA/listing_exposures/high

Respuesta:

{
  "id": "high",
  "name": "Alta",
  "home_page": false,
  "category_home_page": true,
  "advertising_on_listing_page": false,
  "priority_in_search": 1
}


Actualizaciones disponibles

Puedes realizar una actualización a un tipo de publicación superior una vez. Si necesitas realizar una actualización, puedes ver qué tipos de publicación están disponibles para tu artículo.


Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/available_upgrades

Respuesta:

[
  {
	"site_id": "MLC",
	"id": "gold_premium",
	"name": "Oro Premium"
  },
  {
	"site_id": "MLC",
	"id": "gold",
	"name": "Oro"
  },
  {
	"site_id": "MLC",
	"id": "silver",
	"name": "Plata"
  }
]

¡Eso es! Ahora estás listo para acceder a la exposición correcta para tus productos y realizar actualizaciones de artículos. Como sabemos que a veces necesitas más de un intento para realizar tu publicación, te ofrecemos la posibilidad de consultar si tu publicación quedó exactamente cómo la querías antes de publicarla. Consulta más sobre el validador de publicaciones.


Bajar un artículo a un tipo de publicación inferior (downgrades)

Downgrade es reducir la exposición de tu artículo al actualizarlo en un tipo de publicación inferior. Está disponible para algunos casos particulares:

  • Está permitido realizar downgrades en las publicaciones entre gold_pro a gold_special y viceversa en cualquier momento.
  • Antes de que comiencen, se pueden realizar downgrades para las publicaciones en payment_required.
  • No está permitido realizar el downgrade de una publicación a gratis.