Tipos de publicación y cómo obtener mayor exposición
Tipos de publicación por site
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.