Documentación Mercado Libre

Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
circulos azuis em degrade

Documentación

Última actualización 25/09/2023

Publicaciones denunciadas

Con el objetivo de reducir las denuncias en el marco del Brand Protection Program, disponibilizamos las siguientes funcionalidades para consultar y responder denuncias realizadas a vendedores. Recuerda que una denuncia podrá llevar a la baja de la publicación y la sanción de infractores reincidentes podrá impactar en su reputación, restricciones sobre su cuenta, suspensión, inhabilitación temporal y/o permanente. También puedes utilizar el flujo de Mercado Libre para responder una denuncia.


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.


Nota:
Solo puedes adjuntar un archivo PDF, JPG o PNG y peso máximo 5 MB.

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

Nota:
Si el vendedor no envía documentación en casos opcionales, puede enviar string vacío ("document_name": " ").

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