Recursos Cross
Explora los recursos principales de nuestras APIs
Documentación
Puedes usar esta documentación para las siguientes unidades de negocio:
Infracciones
Consultar items con estado under review
Los items con status under review tienen diferentes sub-estados: warning, waiting_for_patch, held, pending_documentation, forbidden, picture_dowloading_pending y puedes filtrarlos mediante el status "pending".
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?status=pendingEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456/items/search?status=pendingRespuesta:
{
"seller_id": "123456",
"query": null,
"paging": {
"limit": 50,
"offset": 0,
"total": 8
},
"results": [
"MLC951993111",
"MLC951803222",
"MLC949619333",
"MLC949606444",
"MLC947744555",
"MLC947725666",
"MLC947725777",
"MLC947699888"
],
"orders": [...]
}Conoce más sobre Flujo y estados de las publicaciones.
Pausado preventivo por cambio de precio
Preventivamente las publicaciones detectadas con cambios inusuales de precios pasarán a tener status: paused y el tag moderation_penalty. Para activarla, debe realizar un PUT a /items con status: active, ya que este tipo de moderación preventiva solo pausa la publicación. Estos ítems no tendrán status under review.
Llamada filtrando ítems con tag moderation_penalty:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?tags=moderation_penalty
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/0123456789/items/search?tags=moderation_penalty
Respuesta:
{
"seller_id": "0123456789",
"paging": {...},
"results": [
"MLA1147839589",
"MLA1148439168",
"MLA1149506534",
"MLA1157034561",
"MLA1164314507",
"MLA1173423437"
],
"orders": [...],
"available_orders": [...]
}Detalle de la moderación por cambio inusual de precio
{
"infractions": [
{
"id": "1008955725",
"date_created": "2022-09-22T11:01:44.451-0400",
"user_id": "1165408677",
"related_item_id": "MLA1174435263",
"element_id": "MLA1174435263",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "TP_OTROS",
"reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica que sea el valor correcto antes de reactivarla.",
"remedy": ""
}
],
"paging": {
"offset": 0,
"limit": 1,
"total": 1
},
"sorting_type": "date_created_desc"
}Por último, el vendedor deberá validar el precio, editarlo y activar el ítem.
Pausado de ítems recién creados
En la creación de un nuevo ítem, si el thumbnail es de tipo source (URL), el ítem quedará pausado, con un sub estado PICTURE_DOWNLOADING_PENDING para indicarle al seller que aún no se descargo la imagen principal.
- Se crea con status: PAUSED, sub_status: PICTURE_DOWNLOADING_PENDING
- Cuando la imagen se descarga correctamente, el ítem pasa a status: ACTIVE automáticamente.
En el caso de que la imagen nunca se pueda descargar (luego de varios intentos, en un período de tiempo definido) el ítem quedará moderado. Si el ítem está moderado queda en status: UNDER_REVIEW, sub_status: PICTURE_DOWNLOADING_PENDING, WAITING_FOR_PATCH
Aclaración esto también aplica para modificación de thumbnails.
Consultar moderaciones de un usuario
Las moderaciones de un vendedor pueden afectar:
- ítems
- preguntas o respuestas (questions)
- opinión del producto (review)
Te recomendamos identificar la razón (reason) y solución (remedy) para aplicar en el idioma correspondiente al sitio de la infracción o en inglés.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_IDEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678Respuesta:
{
"infractions": [
{
"id": "1025647",
"date_created": "2016-11-12T18:28:03.731Z",
"user_id": "6540387",
"related_item_id": "MLA642576340",
"element_id": "MLA642576340",
"element_type": "ITM",
"site_id": "MLA",
"filter_subgroup": "LINKS",
"reason": "Tuvimos que borrar tu publicación porque ofrecías un producto que está prohibido por nuestra Política de Autopartes y repuestos.",
"remedy": "Recuerda que las autopartes y repuestos usados están regulados por las leyes 25761, 24449 y sus decretos reglamentarios.
Si deseas obtener más información puedes consultar el sitio de DNRPA"
},
],
"paging": {
"offset": 0,
"limit": 20,
"total": 7
},
"sorting_type": "date_created_desc"
}Campos de la respuesta
id: identificador único de la infracción.
date_created: fecha en que se produjo la infracción.
user_id: el usuario que realizó la infracción.
related_item_id: identificador único de la publicación relacionada con el elemento que posee la infracción. Si la infracción es en una publicación, el valor de este atributo será igual a valor del atributo element_id.
element_id: identificador único del elemento que posee la infracción. Es dependiente del atributo element_type.
element_type: tipo de elemento, los valores pueden ser: ITM (publicación), QUE (preguntas y respuestas) y REV (reviews/opinión de productos).
site_id: sitio del marketplace del elemento que tiene la infracción.
subgroup: este campo te permite identificar, agrupar y resumir (sumarizar) las infracciones pertenecientes a los distintos grupos de filtros. Por ejemplo:
- DOMAIN: moderación por mala categorización
- COMPATS: moderación por falta de Compatibilidad (Autopartes).
- PQT: moderación por mala calidad de imágenes
- LINKS: moderación por incluir datos de contacto o links externos a Mercado Libre
- CLASI: moderaciones en clasificados (vehículos, inmuebles, servicios)
- BRAND_PROTECTION: moderación por denuncias realizadas desde Brand Protection Program y deben ser respondidas antes del vencimiento.
reason: texto (html) que describe el motivo y política que se infraccionó.
remedy: texto (html) que indica la acción, sólo en los casos en que sea recuperable. Por ejemplo, “Quitar los datos personales de una publicación”.
Filtrar moderaciones
| Filtro | Descripción | Opciones | Default |
|---|---|---|---|
| related_item_id | Id de la publicación asociado a la infracción | - | - |
| element_id | Id del elemento moderado | - | - |
| element_type | Tipo del elemento moderado | ITM (item) REV (review) QUE (pregunta/respuesta) |
- |
| date_created_since | Fecha de inicio del filtrado | Formato: YYYY-MM-DD | - |
| date_created_to | Fecha de fin del filtrado | Formato: YYYY-MM-DD | - |
| language | Puedes solicitar los textos del reason y remedy en idioma español o portugués. El idioma por default es inglés. | ES (español) o PT (portugués) | Inglés |
| limit | Cantidad de infracciones devueltas | El valor es de 1 a 20 | 20 |
| offset | Offset para el paginado | 0 | |
| sort | Ordenar los resultados por fecha de creación de manera ascendente o descendente | date_created_asc, date_created_desc | date_created_desc |
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=XEjemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0Respuesta:
{
"infractions": [
{
"id": "594794188",
"date_created": "2020-10-28T01:43:32.414-0400",
"user_id": "12345678",
"related_item_id": "MLA169211231",
"element_id": "MLA169211232",
"element_type": "ITM",
"site_id": "MLA",
"reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
"remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
}],
"paging": {
"offset": 0,
"limit": 1,
"total": 20671
},
"sorting_type": "date_created_desc"
}Consultar moderación de imágenes
Los ítems con el tag poor_quality_thumbnail fueron validados por Mercado Libre y no cumplen algún requisito de imagen. Identifica estas publicaciones con imágenes de baja calidad para mejorarlas. Conoce más sobre el recurso Búsqueda de ítems y la importancia de las fotos para los vendedores.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/quality/pictures/$ITEM_IDRespuesta:
{
"itemID": "MLA0111111",
"quality": "good",
"thumbnail": "344725-MLA25503040734_042017",
"conditions": [
{
"id": "white_background",
"passed": true
},
{
"id": "minimum_size",
"passed": true
},
{
"id": "logo_text_watermark",
"passed": true
},
{
"id": "unprofessional_photo",
"passed": true
}
],
"taggedDate": "2019-05-02T07:27:40Z"
}Campos de la respuesta
itemID: ID de la publicación.
quality: calidad de imagen, puede tomar los valores “good” ó “poor”, definiendo los estados de “buena imagen” o “mala imagen” respectivamente.
thumbnail: es la imagen por la cual se procesó el ítem, corresponde a la thumbnail del ítem.
conditions: son un conjunto de condiciones por las que pasa un ítem para determinar su calidad de imagen. Una condición está formada por su ID (dando una definición corta de que analiza) y su atributo de passed, un valor booleano definiendo si la imagen cumplió la condición o no.
taggedDate: fecha del último procesamiento realizado sobre el ítem.
Posibles ID de Condiciones
minimum_size: Esta validación evalúa si alguna de las imágenes de la publicación supera el mínimo de 500 x 500 px.
logo_text_watermark: Esta validación evalúa si la primera imagen de la publicación contiene logos, texto, banners promocionales o marcas de agua.
white_background: Esta validación evalúa si la primera imagen de la publicación tiene fondo blanco puro. Es decir, fondo blanco creado con un editor de imágenes, en lugar de una foto de producto frente a una pared u otro elemento.
multiproduct: Esta validación evalúa si la primera imagen contiene más de un producto. Por ejemplo, no permitimos que la primera imagen de la publicación contenga varios pares de zapatillas.
blur: Esta validación evalúa que las imágenes de la publicación no sean borrosas.
unprofessional_photo: Esta validación se ejecuta cuando el resto de las validaciones da negativo. Evalúa tres condiciones a la vez: multiproducto, fondo blanco y logos. No significa que la imagen cumpla las tres, sino que puede no estar cumpliendo con alguna de las tres.
rollbacked: Esta validación es reservada para el equipo de atención al cliente. La utilizamos cuando un vendedor se contacta para reclamar por detecciones incorrectas (falso positivo). Una vez aplicada, la foto no se vuelve a moderar, excepto que el vendedor cambie la imagen.
Errores
En caso de recibir un error 404 - “No picture tagged for item (Item_id)” debido a que el ítem no pudo ser validado, te recomendamos mejorar la imagen con el siguiente recurso.
Cómo mejorar imagen
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/tagging/quality/message/$ITEM_IDRespuesta:
{
"reason": "Para recuperar tu exposición, corregí tus fotos- Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom.
",
"conditions": [
{
"id": "sizePictures",
"message": "Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom."
}
]
}Conoce más sobre cómo trabajar con imágenes.
Agregar tag poor_quality_thumbnail en el ítem de prueba
Para añadir el tag "poor_quality_thumbnail" a un ítem de prueba, cargue los datos de su usuario de test en el soporte por site:
Siguiente: Brand Protection Program.