Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.Documentación
Publicaciones denunciadas
Consulta items denunciados
Con el siguiente recurso puedes obtener ítems denunciados de un vendedor, fecha de la denuncia, fecha de vencimiento (plazo máximo para responder la denuncia), motivo de denuncia, el id que identifica el caso y su estado.
Parámetros obligatorios
Si no deseas filtrar las denuncias, debes enviar obligatoriamente los campos date created y status vacíos: ?offset=0&date_created=&status=
offset: limitas la cantidad de resultados. El resultado máximo por página es 50. Para obtener los primeros resultados debes enviar 0, luego 50, 100, 150, 200 y así sucesivamente.
date_created: fecha de creación de denuncias. Con este parámetro delimitas las denuncias desde un día hasta el día de la fecha (actualidad).
status: estado de la denuncia. Los estados relevantes para los vendedores son: WAITING_DOCUMENTATION, DOCUMENTATION_PRESENTED, DOCUMENTATION_APPROVED, DOCUMENTATION_NOT_APPROVED, DOCUMENTATION_NOT_PRESENTED, MEMBER_NOT_RESPOND, ROLLBACK.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/cases?offset=0&date_created=2022-04-01&status=DOCUMENTATION_APPROVED
Respuesta:
[
{
"item_id": "MLA1126353524",
"date_created": "2022-04-26T12:45:55Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32222222,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1112955839",
"date_created": "2022-04-26T12:45:55Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32022999,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1112602234",
"date_created": "2022-04-26T12:45:55Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32022888,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1114491076",
"date_created": "2022-04-26T12:45:55Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32022777,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1111800968",
"date_created": "2022-04-26T12:45:54Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32022934,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1116841233",
"date_created": "2022-04-26T12:45:54Z",
"due_date": "2022-05-02T03:59:00Z",
"case_id": 32022933,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1112610988",
"date_created": "2022-04-25T19:16:16Z",
"due_date": "2022-04-30T03:59:00Z",
"case_id": 32021874,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1124551926",
"date_created": "2022-04-25T19:16:15Z",
"due_date": "2022-04-30T03:59:00Z",
"case_id": 32021873,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1124619165",
"date_created": "2022-04-25T19:16:15Z",
"due_date": "2022-04-30T03:59:00Z",
"case_id": 32021871,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1111638957",
"date_created": "2022-04-25T19:16:15Z",
"due_date": "2022-04-30T03:59:00Z",
"case_id": 32021872,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"item_id": "MLA1116851723",
"date_created": "2022-04-04T17:01:33Z",
"due_date": "2022-04-09T03:59:00Z",
"case_id": 31975293,
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"current_status": "DOCUMENTATION_APPROVED"
},
{
"total": 11,
"offset": 0,
"limit": 50
}
]
Campos de la respuesta
item_id: identificador del ítem.
date_created: fecha de creación de la denuncia recibida.
due_date: fecha de vencimiento para responder la denuncia. Si no respondes, el estado de la denuncia pasará a DOCUMENTATION_NOT_PRESENTED y el item será moderado y eliminado (forbidden).
case_id: identificador de denuncia. Te permitirá conocer más detalle de la denuncia recibida.
reason_text: motivo de denuncia.
current_status: estado actual de la denuncia. Este cambiará de acuerdo a las respuestas y resoluciones. Conoce los diferentes estados:
Current_status | Nombre | Descripción | Estado del ítem |
---|---|---|---|
DOCUMENTATION_APPROVED | Documentación aprobada | La denuncia fue respondida por el vendedor, el miembro aprobó la documentación y retiró su denuncia. | Activo |
DOCUMENTATION_NOT_APPROVED | Documentación no aprobada | La denuncia fue respondida por el vendedor, pero el miembro ratificó su denuncia. | Eliminado |
DOCUMENTATION_NOT_PRESENTED | Documentación no presentada | La denuncia no fue respondida por el vendedor. | Eliminado |
DOCUMENTATION_PRESENTED | Documentación presentada | La denuncia fue respondida por el vendedor y está a la espera de una respuesta por parte del miembro. | Pausado |
MEMBER_NOT_RESPOND | Denuncia sin respuesta del miembro | La denuncia fue respondida por el vendedor, pero el denunciante no respondió a tiempo. | Activo |
ROLLBACK | Retractada | La denuncia fue retractada. | Activo |
WAITING_DOCUMENTATION | Esperando respuesta | Estamos esperando respuesta de la denuncia por parte del vendedor. | Pausado |
Consulta detalle de item denunciado
Para mayor información sobre el caso y el ítem denunciado, realiza la siguiente consulta:
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$CASE_ID
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
Respuesta:
{
"item_info": {
"item_id": "MLA1232441735",
"price": 5000,
"description": "",
"title": "Item De Testeo, Por Favor No Ofertar",
"pictures": [{
"size": "500x500",
"url": "https://http2.mlstatic.com/resources/frontend/statics/processing-image/1.0.0/O-ES.jpg",
"max_size": "500x500"
}]
},
"last_updated": "2022-11-09T11:59:59.000-0400",
"date_created": "2022-11-09T11:59:37.000-0400",
"photos_denounced": [],
"reason_text": "tu publicación podría estar utilizando una copia ilegal de imágenes protegidas por sus derechos de autor (como fotos de catálogo protegidas, personajes de dibujos animados, videos, imágenes de celebridades).",
"due_date": "2022-11-13T23:59:00.000-0400",
"photos_new": [],
"member_quittance": null,
"reason_id": "PPPI6",
"document_name": null,
"public_member_name": "Nike",
"user_type": "seller",
"document_url": null
}
Campos de respuesta
item_info: información relevante del ítem.
last_updated: fecha de última actualización de la denuncia.
date_created: fecha de creación de la denuncia.
photos_denounced: imágenes denunciadas.
reason_text: motivo de denuncia recibida.
due_date: fecha de vencimiento para responder la denuncia.
photos_new: imágenes nuevas para agregar al ítem. Una vez respondida la denuncia con este campo, Mercado Libre agrega los pictures id a la publicación.
member_quittance: comentario del miembro del programa.
reason_id: identificador de la denuncia. Conoce los diferentes tipos de denuncias:
Tipos de denúncia
Reason ID | Nombre | Descripción |
---|---|---|
PPPI1 | Producto Falsificado | Es una copia o falsificación de un producto que no fue fabricado por la marca. |
PPPI2 | Uso indebido de marca | Utiliza la marca indebidamente en la publicación. Por ejemplo: en el título, en la descripción, en las fotos, etc. |
PPPI3 | Derecho de Autor - Software | La publicación ofrece un programa de computación que infringe los derechos. |
PPPI5 | Derecho de Autor - Libros | La publicación ofrece una obra literaria que infringe los derechos. |
PPPI6 | Derecho de Autor - Imágenes | La publicación contiene imágenes y/o fotos que el vendedor no tiene autorización para utilizar. |
PPPI7 | Derecho de Autor - Imagen Personal | Utiliza la imagen personal del denunciado. |
PPPI8 | Modelo o Diseño Industrial | Infringe un modelo o diseño industrial. |
PPPI9 | Infringe patentes, modelos de utilidad o derechos de obtentor de variedades vegetales | Infringe patentes, modelos de utilidad o derechos de obtentor de variedades vegetales. |
PPPI10 | Producto no destinado a la venta. | Ej. Muestras gratis, productos no lanzados en el mercado de Brasil, otros productos que fueron entregados en comodato. |
PPPI11 | Derecho de Autor - Cursos | La publicación ofrece un curso que infringe los derechos. |
PPPI12 | Derecho de Autor - Videojuegos | La publicación ofrece un videojuego que infringe sus derechos. |
PPPI14 | Derecho de Autor - Videos / Películas | Videos / Películas. La publicación ofrece una obra audiovisual que infringe mis derechos. |
PPPI15 | Derecho de Autor - Música | La publicación ofrece un contenido musical que infringe sus derechos. |
PPPI16 | Derecho de Autor - Personaje | Personaje. La publicación ofrece productos que incluyen personajes sin autorización. |
PPPI17 | Derechos de Autor - Otros | La publicación ofrece otro tipo de obra (diseño, pintura, escultura, etc.) que infringe sus derechos. |
PPPI18 | Derechos Conexos - Reproducciones Ilegales | Fijaciones o reproducciones no autorizadas. |
PPPI19 | Derechos Conexos - Imagen Personal | Usa la imagen personal asociada a su interpretación artística sin autorización. |
PPPI20 | Derechos Conexos - Material Auditivo | Usa material auditivo sin autorización. Música o sonidos grabados. |
PPPI21 | Derechos Conexios - Material Audiovisual | Películas, series, vídeos, grabaciones de recitales, de espectáculos y eventos deportivos. |
PPPI22 | Derechos Conexios - Transmisión Ilegal | Servicios para acceder a señales de manera ilegal. |
PPPI23 | Derechos Conexios - Dispositivo Ilegal | Dispositivos que captan señales de manera ilegal. |
document_name: nombre del documento enviado por el miembro.
public_member_name: nombre público del miembro del programa.
case_id: identificador de la denuncia.
current_status: estado actual de la denuncia.
document_url: url del documento enviado por el miembro.
Flujo para responder denuncias
1. Identificar tipo de respuesta
- Si el vendedor tiene derechos de uso de las imágenes, deberá responder la denuncia con comentario (opcional) y adjuntar el documento (requerido).
- Si el vendedor no tiene derechos sobre estas imágenes, deberá cargar nuevas imágenes y enviar en su respuesta los id de las imágenes nuevas y los id de las imágenes eliminadas. Utiliza nuestra API de /pictures para trabajar imágenes.
- Por documentación: el vendedor debe responder a la denuncia con un comentario (requerido) y con la documentación (opcional). Previo a enviar la respuesta, te recomendamos cargar el documento en el endpoint.
2. Cargar documento probatorio
Una vez que los vendedores diferencien si se trata de una denuncia por uso de imágenes (enviando imágenes + documentos) o documentos, deberán cargar el documento en Mercado Libre de la siguiente manera:
Parámetros obligatorios
case_id: identificador de la denuncia.
name: nombre del archivo.
form: archivo o documento oficial que prueba la respuesta de la denuncia.
Llamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/files?case_id=$CASE_ID&name=$NAME_FILE.JPG -Form =@/Users/Nombre/Ejemplo/documento-denuncia-Nike.jpg
Ejemplo
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/files?case_id=32679944&name=testFile.jpg'--form '=@"/Users/Nombre/Ejemplo/documento-denuncia-Nike.jpg"'
Respuesta
{
"file_name":"32679944.jpg"
}
Este file_name lo utilizarás para el campo document_name al momento de querer adjuntar una documentación probatoria ante la denuncia.
3. Enviar respuesta ante denuncia
Llamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/$CASE_ID
Respuesta por uso de imágenes (sin variaciones):
seller_quittance: comentario del vendedor.
photos_new: fotos nuevas que enviará el vendedor y Mercado Libre cargará estas imágenes en el ítem.
photos_removed: id de imágenes que desea eliminar. Mercado Libre eliminará estas imágenes.
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
"seller_quittance": "comentario",
"document_name": "32618474.png",
"photos_new": ["799744-MLA1234_112022"],
"photos_removed": ["637858-MLA124_112022"],
"variations": []
}
Respuesta por uso de imágenes (con variaciones):
variations: indicas id de la variación del ítem junto con las imágenes que deseas que permanezcan en esta.
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
"seller_quittance": "test",
"document_name": "32618474.png",
"photos_new": ["799744-MLA1234_112022"],
"photos_removed": ["637858-MLA124_112022"],
"variations": [{
"id": "16787985187",
"picture_ids": [
"111111 - IMAGEN_EXISTENTE_111111",
"111111 - IMAGEN_EXISTENTE_111111",
"111111 - IMAGEN_EXISTENTE_111111"
]
}]
}
Conoce más sobre cómo trabajar con imágenes.
Respuesta de denuncia con documento:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/pppi/case/12344
{
"seller_quittance": "comentario del vendedor",
"document_name": "32618474.png"
}
Recomendaciones para responder denuncias
Infracción | Motivo | Respuesta esperada |
---|---|---|
Producto falsificado, copias o réplicas | Es ilegal vender falsificaciones, copias o réplicas de productos de una marca registrada, y publicar este tipo de productos está prohibido por nuestros Términos y condiciones. | -Enviar fotos de la factura de compra que demuestre que el producto es original, que lo compraste legalmente y que justifique el stock ofrecido en tu publicación. -Enviar imágenes de las etiquetas y empaque original del producto. El titular de derechos podría pedirte documentación específica que debes adjuntar para responder. |
Uso ilegal de marca registrad | Una marca registrada es un signo distintivo (como una palabra, frase o logo), que se usa para identificar productos o servicios. | -Adjuntar copia de la autorización del titular de los derechos. -Si sos el titular de la marca que estás usando, envía una copia de tu título de marca. |
Software pirata | Es ilegal vender copias no autorizadas de software, y publicar este tipo de productos está prohibido por nuestros Términos y condiciones. | Enviar copia de la licencia que te autoriza a distribuir el software. |
Infracciones de derechos de autor | Protegen obras intelectuales originales como películas, música, fotografías y libros. La protección de derechos de autor evita que otros puedan usar una obra sin su permiso. | -Acreditar que eres el titular de esos derechos. -Enviar una copia de la autorización que te haya dado el titular para usar su obra. -Enviar una copia del certificado de depósito de la obra. |
Infracciones de derechos conexos | Dan protección a quienes, sin ser autores, contribuyen con creatividad, técnica u organización, en el proceso de poner a disposición del público una obra. | -Enviar autorizaciones para grabar su actuación o interpretación. Si es una denuncia de productores de fonogramas y videogramas, adjunta: -Facturas de adquisición de copias emitidas por algún distribuidor autorizado de los fonogramas o videogramas. -Contratos que autoricen la venta por consignación. Licencias para reproducir fonogramas o videogramas. Si es una denuncia de un organismo de radiodifusión, envía: -Licencia que te autoriza a distribuir o retransmitir la señal del organismo denunciante. |
Infracción de una patente o modelo de utilidad | Es un derecho exclusivo otorgado a una invención (producto o proceso) que implica una solución técnica nueva, no obvia y de aplicación industrial. | -Acreditar que sos el titular de la patente. -Enviar una copia de la autorización que te haya dado el titular para explotar comercialmente su invención. |
Infracción de un modelo o diseño industrial | Protegen el aspecto ornamental o estético aplicado a un producto. | -Acreditar que sos el titular de esos derechos. -Enviar una copia de la autorización que te haya dado el titular para explotarlos comercialmente incluyendo sus derechos protegidos. |
Producto no destinado para la venta | El propietario de la marca no destinó para fines comerciales y por lo tanto no entregó para que sean vendidos, por ej. muestras gratis o de prueba, o productos entregados en comodato. En Brasil es una infracción vender un producto que no fue lanzado oficialmente en ese mercado por el titular de los derechos o con su autorización. |
Enviar al denunciante documentación que pruebe que compraste el producto sin ninguna limitación para venderlo. |
Denuncias de prueba
Si deseas probar esta funcionalidad con usuarios test, ir a soporte por site:
Los items ID enviados deben estar status: active, tag test_item y catalog_listing: false