Recursos
Infracciones y denuncias
Lo mismo que la página Infracciones del panel: qué infracciones de Mercado Libre tiene su cuenta, cuáles atender primero y qué hacer con cada una, y las denuncias de marca que todavía puede responder. Es lectura: no cambia nada en su cuenta.
Cada infracción trae una gravedad (severity):
severe: propiedad intelectual (falsificación, denuncia de marca, réplicas) o producto prohibido. Son las que suspenden cuentas y las que cuenta el nivel de riesgo.quality: calidad de la publicación (fotos, catálogo, categoría, compatibilidades…). Bajan la exposición, no suspenden.informative: no exigen nada. También pasan a informativas las graves de una publicación ya cerrada, las que Mercado Libre ya resolvió por su cuenta y las de más de un año (estas conhistoric: true).
Y una acción recomendada (action), con next_step en español para mostrarlo tal cual:
repair_in_automeli: se repara desde la página Infracciones del panel (fotos, catálogo o categoría).claim_to_ml: se reclama a Mercado Libre con el texto declaim_message.close_and_block: cerrar la publicación y bloquear la marca o el producto en la lista negra. No se reclama.fix_in_ml: se corrige en la publicación, dentro de Mercado Libre.auto_paused: Automeli la pausa sola; no hay nada que hacer.sanctioned_by_ml: Mercado Libre ya la sancionó; no se puede editar, pero cuenta para el riesgo.none: nada que hacer.
/v2/infractions/summaryGET /infractions/summarycurl "https://api.automeli.com/api/v2/infractions/summary" \
-H "X-API-Key: automeli_live_..."risk.level: high, medium, low o none (orientativo; la regla va en risk.rule), contando las graves abiertas. to_do: un grupo por tipo, primero las graves (severity severe) y después las de calidad (quality), con by_action, main_action y next_step; las graves traen además reasons y hasta 5 sample_listing_ids. main_action: repair_in_automeli (se repara desde el panel), claim_to_ml (se reclama a Mercado Libre con claim_message, ver GET /infractions), close_and_block (cerrar y bloquear en la lista negra), fix_in_ml (se corrige en Mercado Libre), auto_paused (Automeli la pausa sola), sanctioned_by_ml o none. open_complaints: hasta 10 denuncias abiertas, la que vence primero arriba; hours_left = horas enteras hasta due_at (negativo = vencida), responded = ya presentó documentación y Mercado Libre la revisa; total_capped: true = hay 200 o más. paused_by_veto = publicaciones que Automeli pausó por la lista negra de productos. category_republished = las que Automeli republicó para corregir la categoría y cómo quedaron. last_check_at = última revisión pedida desde el panel. partial: true = faltan las partes de unavailable (counts, open_complaints, quality_groups, paused_by_veto, category_republished o last_check_at): counts llega como { available: false }, sin cifras, y las demás en null (quality_groups: sin los grupos de calidad en to_do); unavailable_detail dice por qué si aplica (más de 10.000 de calidad no se agrupan: use GET /infractions con severity=quality). Nunca lea un partial como cuenta limpia.
{
"data": {
"risk": {
"level": "high",
"severe_open": 7,
"severe_last_7d": 0,
"last_severe_at": "2026-11-04T16:03:45.000Z",
"rule": "high: 5+ graves abiertas o 2+ en los últimos 7 días; medium: 1+ en 7 días o 2+ abiertas; low: 1 abierta. Es orientativo."
},
"counts": {
"available": true,
"severe": 7, "quality": 1238, "informative": 77, "resolved": 880, "total": 2202,
"resolved_last_30d": 75
},
"to_do": [
{
"type": "PI_FAKES",
"type_label": "Propiedad intelectual / Falsificación",
"severity": "severe",
"total": 1,
"by_action": { "claim_to_ml": 1 },
"main_action": "claim_to_ml",
"main_action_label": "Reclamar a Mercado Libre",
"next_step": "Envía el texto de claim_message a la IA de Mercado Libre desde la publicación; suele ganarse.",
"reasons": [
{ "reason_id": 454, "reason": "Los datos del producto no coincidían entre sí.", "count": 1, "action": "claim_to_ml", "last_at": "2026-07-30T17:21:03.000Z" }
],
"sample_listing_ids": ["MCO1234567890"]
},
{
"type": "CATALOG",
"type_label": "Catálogo",
"severity": "quality",
"total": 667,
"by_action": { "repair_in_automeli": 446, "fix_in_ml": 221 },
"main_action": "repair_in_automeli",
"main_action_label": "Reparar aquí",
"next_step": "Repárala desde la página de Infracciones de Automeli (fotos, catálogo o categoría): Automeli hace el cambio en Mercado Libre."
}
],
"sanctioned_by_ml": {
"total": 6,
"by_type": [
{ "type": "RECALL", "type_label": "Producto retirado del mercado", "total": 3 },
{ "type": "COMER", "type_label": "Producto prohibido para la venta", "total": 3 }
]
},
"open_complaints": {
"total": 1,
"total_capped": false,
"items": [
{
"case_id": 81234567,
"listing_id": "MCO9876543210",
"sku": "B0EXAMPLE1",
"title": "Gafas De Sol Polarizadas",
"brand": "Acme",
"complainant": "Acme Brands LLC",
"reason": "Uso no autorizado de la marca",
"status": "WAITING_DOCUMENTATION",
"responded": false,
"created_at": "2026-11-18T14:02:11Z",
"due_at": "2026-11-22T14:02:11Z",
"hours_left": 41
}
]
},
"paused_by_veto": 6,
"category_republished": { "total": 236, "ok": 108, "sanctioned_again": 37 },
"last_check_at": null,
"last_detection_at": "2026-11-15T06:05:28.000Z"
},
"partial": false,
"unavailable": [],
"context": { "seller_id": 108386, "environment": "live" }
}open_complaints trae las denuncias de marca abiertas, la que vence primero arriba, con hours_left (horas hasta due_at; negativo = vencida). Una denuncia sin responder a tiempo se vuelve infracción. responded: true = ya presentó documentación y Mercado Libre la revisa. Para un aviso diario, consulte este endpoint una vez al día y avise de las que tengan responded: false.risk.level (high, medium, low o none) es orientativo y la regla viene en risk.rule. to_do agrupa por tipo lo que falta atender: primero las graves, con sus motivos y algunas publicaciones de muestra, y después las de calidad. Para ver cada publicación, use el listado con el mismo type.
partial: true y la lista de lo que falta en unavailable (esa parte viene en null; counts llega como { available: false }). No es una cuenta limpia. Con más de 10.000 infracciones de calidad pendientes, las de calidad no se agrupan (unavailable_detail lo explica): consulte el listado con severity=quality. Si ni siquiera las graves terminan, responde 503 E_INFRACTION_TIMEOUT.Errores posibles de este endpoint (4)
E_AUTH_FORBIDDEN_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_INFRACTION_TIMEOUTSólo v2 (GET /infractions y /infractions/summary): la consulta superó su tope de tiempo (cuentas con cientos de miles de infracciones). Trae Retry-After: 30; reintente una vez o, en el listado, acótelo (type, listing_id, sku o fechas)
503E_INFRACTION_COOLDOWNSólo v2 (GET /infractions y /infractions/summary): esa misma consulta agotó el tiempo hace menos de 30 s y no se vuelve a correr. Espere lo que diga Retry-After o acótela
429E_INTERNALError inesperado. Reintente con backoff
503Una fila por publicación, tipo y motivo, de la más reciente a la más vieja, paginadas por cursor. Por defecto, solo las pendientes.
/v2/infractionsGET /infractionscurl "https://api.automeli.com/api/v2/infractions?severity=severe&limit=20" \
-H "X-API-Key: automeli_live_..."Una fila por publicación, tipo y motivo. listing_status = estado en Mercado Libre. severity, action y sus *_label como en GET /infractions/summary; next_step dice qué hacer. claim_message = texto para reclamar a Mercado Libre (solo con action claim_to_ml). detection_count = cuántas veces Mercado Libre la detectó. resolution: pending, o cómo se resolvió (resolved_at). historic: true = grave de más de un año, que ya no cuenta para el riesgo. brand_complaint = la marca y el origen si fue una denuncia de marca. republished_as = la publicación nueva si Automeli la republicó para corregir la categoría (ok: si quedó activa o pausada). Sin filas con algún filtro además de status (en la primera página): hint y types_present (los tipos que la cuenta sí tiene con ese status; null si no se pudieron leer). Con solo status y sin filas no hay hint: no hay infracciones con ese status.
{
"data": [
{
"listing_id": "MCO1234567890",
"sku": "B0EXAMPLE2",
"title": "Parrilla Enfriadora Acero Inoxidable",
"listing_status": "under_review",
"type": "DOMAIN",
"type_label": "Categoría incorrecta",
"reason_id": 305,
"reason": "Estaba en una categoría incorrecta.",
"severity": "quality",
"severity_label": "Calidad de la publicación",
"action": "repair_in_automeli",
"action_label": "Reparar aquí",
"next_step": "Repárala desde la página de Infracciones de Automeli (fotos, catálogo o categoría): Automeli hace el cambio en Mercado Libre.",
"claim_message": null,
"detected_at": "2026-11-13T14:47:17Z",
"detection_count": 1,
"resolution": "pending",
"resolved_at": null,
"historic": false,
"brand_complaint": null,
"republished_as": null
}
],
"next_cursor": "eyJsYXN0X2lkIjp7ImQiOiIyMDI2LTExLTEzIDE0OjQ3OjE3LjAwMDAwMCJ9fQ==",
"has_more": true,
"filters_applied": { "status": "pending" },
"context": { "seller_id": 108386, "environment": "live" }
}Los filtros se combinan entre sí, también con status (por defecto, pending): las informativas y la acción none solo salen con status=informative, resolved o all. severity, action y type aceptan varios valores separados por coma. Para reclamar, filtre por action=claim_to_ml: cada fila trae el texto listo en claim_message.
status) no significa que la cuenta esté limpia: la respuesta trae hint y types_present, los tipos que la cuenta sí tiene, para corregir el filtro (por ejemplo, HOMOL y no HOMOLOGACION).Si una consulta tarda demasiado responde 503 E_INFRACTION_TIMEOUT con Retry-After: 30; repetir la misma consulta antes de ese plazo responde 429 E_INFRACTION_COOLDOWN. Acótela con type, listing_id, sku o fechas.
Errores posibles de este endpoint (5)
E_AUTH_FORBIDDEN_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_INFRACTION_INVALID_PARAMSólo v2 (GET /infractions): status, severity, action, type, listing_id, sku, fechas o limit inválido; el detalle dice cuál y qué valores acepta
422E_INFRACTION_TIMEOUTSólo v2 (GET /infractions y /infractions/summary): la consulta superó su tope de tiempo (cuentas con cientos de miles de infracciones). Trae Retry-After: 30; reintente una vez o, en el listado, acótelo (type, listing_id, sku o fechas)
503E_INFRACTION_COOLDOWNSólo v2 (GET /infractions y /infractions/summary): esa misma consulta agotó el tiempo hace menos de 30 s y no se vuelve a correr. Espere lo que diga Retry-After o acótela
429E_INTERNALError inesperado. Reintente con backoff
503