Recursos Cross
Explora los recursos principales de nuestras APIs
Documentación
Puedes usar esta documentación para las siguientes unidades de negocio:
Moderaciones con pausado
Flujo recomendado
Consultar moderaciones con ítems pausados
Realiza una búsqueda de publicaciones con status: paused y el tag moderation_penalty. Para activarla, debes realizar un PUT a /items con status: active, ya que este tipo de moderación preventiva solo pausa la publicación.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/0123456789/items/search?tags=moderation_penalty&status=pausedRespuesta:
{
"seller_id": "0123456789",
"paging": {...},
"results": [
"MLA1147839589",
"MLA1148439168",
"MLA1149506534",
"MLA1157034561",
"MLA1164314507",
"MLA1173423437"
],
"orders": [...],
"available_orders": [...]
}Cuando identifiques estos ítems, debes consultar sus moderaciones. Por ejemplo:
Moderación por cambio inusual de precio
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?related_item_id=$ITEM_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/223456789?related_item_id=MLA135232000Respuesta:
{
"infractions": [
{
"id": "1378710000",
"date_created": "2023-09-11T10:37:45.107-0400",
"user_id": "223456789",
"related_item_id": "MLA135232000",
"element_id": "MLA135232000",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "DESC",
"reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
"remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos."
}
],
"paging": {
"offset": 0,
"limit": 1,
"total": 1
},
"sorting_type": "date_created_desc"
}En este caso te recomendamos dar el accionable al vendedor de corregir precio y activar el ítem.
Moderación de ítem sin ventas
Los ítems sin ventas y/o sin visitas también podrán ser pausados por Mercado Libre para evitar afectar la reputación del vendedor. Ejecutando la misma llamada anterior, obtenemos información sobre este tipo de moderación. Conoce cómo gestionar las publicaciones que no tuvieron ventas en un largo periodo de tiempo.
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/453616000?related_item_id=MLA1363212345Respuesta:
{
"infractions": [
{
"id": "1399670000",
"date_created": "2023-09-20T09:32:57.409-0400",
"user_id": "453616000",
"related_item_id": "MLA1363212345",
"element_id": "MLA1363212345",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "PP",
"reason": "La pausamos porque no tuvo ventas durante un largo periodo de tiempo. Lo hicimos para ayudarte en la gestión y evitarte cancelaciones.",
"remedy": "Inactiva para revisar
Si todavía querés vender tu publicación, revisala para verificar que esté actualizada y reactivala para que vuelva a estar a la venta, o podés eliminarla si ya no vendés."
}
],
"paging": {
"offset": 0,
"limit": 20,
"total": 1
},
"sorting_type": "date_created_desc"
}En este caso te recomendamos dar el accionable al vendedor de revisar la publicación para verificar que esté actualizada y reactivarla para que vuelva a estar a la venta o eliminarla si ya no vende.
Carga de imágenes por URL
Al crear un nuevo ítem, cuando la carga de las imágenes son de tipo source (mediante URL), mientras Mercado Libre procesa y válida la descarga de todas las imágenes el estado y subestado de las publicaciones quedará:
- Para publicaciones marketplace:
• con “status”: "paused" y “substatus”: “picture_download_pending”. - Para publicaciones de inmuebles y vehículos:
• con “status”: "paused" y “substatus”: “picture_download_pending” para vendedores con "user_type": "normal".
• con “status”: "not_yet_active" y “substatus”: “picture_download_pending” para vendedores con "user_type": "real_estate_agency" o "user_type": "car_dealer".
Cuando las imágenes se descarguen correctamente, el ítem tendrá “status”: “active” automáticamente. En los casos, donde las imágenes, no puedan descargarse luego un período de tiempo definido o que la imagen descargada este por debajo de las dimensiones minimas esperadas, el ítem quedará moderado con “status”: “under_review” y “sub_status”: “picture_download_pending”.
Recuerda que cada imagen será válida siempre que su dimensión sea como mínimo de 250px en ambos lados (width y height) y al menos un lado de más de 500px.
Respuesta:
{
"infractions": [
{
"id": "1467440394",
"date_created": "2023-10-10T19:01:02.73-0400",
"user_id": "453616456",
"related_item_id": "MLA1373668879",
"element_id": "MLA1373668879",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "FOTOS",
"reason": "La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.",
"remedy": "La pausamos temporalmente porque estamos verificando que tu foto se haya cargado correctamente.
"
}Si la imagen no puede descargarse luego un período de tiempo definido, el ítem quedará moderado con status: under_review, sub_status: picture_downloading_pending.
Respuesta:
{
"id": "1467963806",
"date_created": "2023-10-10T20:13:18.009-0400",
"user_id": "453616456",
"related_item_id": "MLA1373668879",
"element_id": "MLA1373668879",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "FOTOS",
"reason": "La foto no se cargó correctamente. Corregila para reactivar tu publicación.",
"remedy": "La foto no se cargó correctamente. Corrígela para reactivar tu publicación.
"
},En este caso te recomendamos dar el accionable al vendedor cargar nuevamente su imagen de portada, ya que no pudo ser procesada (link inválido de imagen).
Siguiente: Moderaciones de Imágenes.