Recursos

Lista negra

La misma Lista Negra del panel (Configuración → Protección de cuenta): las marcas, palabras y categorías que Automeli no publica en su cuenta. Sirve para proteger la reputación: si recibe una denuncia de marca, agregue esa marca para que no se vuelva a publicar.

Cómo funciona

Hay una sola lista por cuenta: las keys live y test leen y previsualizan la misma. Tiene tres partes:

  • Marcas (brand): se comparan con la marca del producto. Por ejemplo, Ray-Ban.
  • Palabras (word): se buscan completas en el título y la descripción, sin importar mayúsculas ni tildes. «Pila» bloquea «Juguete a pila», pero no «Tapete de pilates». Una frase tiene que aparecer junta y en ese orden, y el plural se agrega aparte. Sirve para lo que no es una marca, como un personaje: Michael Myers.
  • Categorías de Mercado Libre: bloquean todo lo que se clasifica en ellas. Por ahora la API las lee; se editan desde el panel.

Lo nuevo que coincida no se publica nunca. Lo que ya tiene publicado depende de la pausa automática del Actualizador (auto_pause en la respuesta): si está activa, esas publicaciones se pausan en el próximo ciclo con el motivo «Lista Negra»; si no, siguen a la venta. Se activa en el panel.

Leer la lista negra

GET/v2/blacklist
scopeaccount:read
RequestGET /blacklist
curl "https://api.automeli.com/api/v2/blacklist?search=ray&limit=2" \
     -H "X-API-Key: automeli_live_..."
200Response

auto_pause.terms / auto_pause.categories: si el Actualizador pausa las publicaciones que ya tiene cuando coinciden con un término o una categoría (si está en false, la lista solo frena lo nuevo). terms[].type: brand (se compara con la marca del producto), word (se busca en el título y la descripción) o brand_and_word (las dos). terms_matched = términos que pasan los filtros. categories[].blocked: false = excepción propia («esta rama no») o sugerida de Automeli que usted apagó; suggested: true = la agregó Automeli (Mercado Libre suele rechazar o sancionar esa categoría); subcategories = cuántas subcategorías cubre.

{
  "site_id": "MCO",
  "auto_pause": { "terms": true, "categories": true },
  "terms_count": 7475,
  "terms_by_type": { "brand": 6753, "word": 722, "brand_and_word": 0 },
  "terms_matched": 26,
  "terms": [
    { "term": "Crayola", "type": "brand" },
    { "term": "Foxxray", "type": "brand" }
  ],
  "next_cursor": "eyJsYXN0X2tleSI6ImZveHhyYXkiLCJsYXN0X2lkIjoxMDA1OH0=",
  "has_more": true,
  "categories_summary": { "total": 445, "blocked": 399, "suggested": 6 },
  "filters_applied": { "search": "ray", "type": null, "include_categories": false }
}
Una cuenta grande tiene miles de términos. Para saber si una marca ya está, use search en vez de recorrer la lista. Los conteos (terms_count, terms_by_type, categories_summary) son siempre de la lista entera, con o sin filtros.

Los términos se paginan con cursor (100 por página, hasta 1.000 con limit), en orden alfabético. La paginación sigue aunque entre una página y otra se quiten términos. Las categorías no vienen por defecto, solo su resumen: con include_categories=true llega la lista, y con search solo las que coinciden por nombre o por id. En categories, suggested: true marca las que agregó Automeli porque Mercado Libre suele rechazar o sancionar esas publicaciones, y blocked: false es una excepción suya o una sugerida que usted apagó.

Errores posibles de este endpoint (4)
E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403
E_BLACKLIST_INVALID_PARAM

Sólo v2 (GET /blacklist): search, type, limit, cursor o include_categories inválido (o enviado como objeto en vez de texto); el detalle dice cuál

422
E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404
E_INTERNAL

Error inesperado. Reintente con backoff

503

Agregar o quitar marcas y palabras

Hasta 10 términos por llamada. Empiece siempre con dry_run: true: no escribe nada y dice cuántas publicaciones pausaría o reactivaría.

POST/v2/blacklist/terms
scopesettings:writekeyliveidempotent
RequestPOST /blacklist/terms
curl -X POST "https://api.automeli.com/api/v2/blacklist/terms" \
     -H "X-API-Key: automeli_live_..." \
     -H "Content-Type: application/json" \
     -d '{
  "action": "add",
  "type": "brand",
  "terms": ["Ray-Ban", "Acme Toys"],
  "dry_run": true
}'
200Response

Con dry_run: true (el ejemplo): changes trae cada término que cambiaría, con stored_as (cómo quedará guardado; puede no ser el type pedido, ver note), new_term (no existía en el diccionario de Automeli) y active_listings al agregar (publicaciones activas que coinciden) o paused_by_term al quitar (pausadas hoy por ese término). estimated_pauses (add) = las que se pausarían: 0 si la pausa automática está apagada; estimated_reactivations (remove) = las que el Actualizador revisaría para reactivar; null en cualquiera de los dos = no se pudo contar a tiempo. orphan_paused (remove de algo que ya no está) = publicaciones que siguen pausadas con ese motivo. Los conteos son aproximados (counts_note). Sin dry_run: { dry_run: false, action, type, added, removed, rejected }. Si no hay nada que cambiar (todo ya estaba, o todo se rechazó) responde 200 con todo en rejected, no un error. rejected[].code: TERM_TOO_SHORT, TERM_TOO_LONG, TERM_INVALID_CHARACTERS, TERM_CONTAINS_COMMA, ALREADY_IN_BLACKLIST, NOT_IN_BLACKLIST o TERM_REJECTED; reason viene en español para mostrarlo tal cual. rejected[].term y changes[].term vienen como quedan guardados (Ray-ban, no Ray-Ban), salvo TERM_CONTAINS_COMMA y TERM_TOO_LONG, que devuelven el texto tal como llegó.

{
  "dry_run": true,
  "action": "add",
  "type": "brand",
  "auto_pause_active": true,
  "changes": [
    { "term": "Acme toys", "stored_as": "brand", "new_term": true, "note": null, "active_listings": 3 }
  ],
  "rejected": [
    { "term": "Ray-ban", "code": "ALREADY_IN_BLACKLIST", "reason": "ya está en tu lista negra (como marca)" }
  ],
  "counts_approximate": true,
  "counts_note": "Aproximado: se cuenta sobre el título y la marca de la publicación; el actualizador compara contra el texto de Amazon.",
  "estimated_pauses": 3
}
Quitar reactiva. Si quita una marca o una palabra, el Actualizador reactiva en su próximo ciclo las publicaciones que había pausado por ella, si nada más las frena. Antes de quitar una marca que recibió una denuncia, revise estimated_reactivations en el dry_run: reactivar lo denunciado arriesga una suspensión.

Vista previa. Con dry_run: true, changes trae cada término que cambiaría y cuántas publicaciones activas coinciden con él; estimated_pauses suma las que se pausarían (0 si la pausa automática está apagada). Los conteos son aproximados: se cuentan sobre el título y la marca de la publicación, y el Actualizador compara contra el texto de Amazon. Si un conteo no termina a tiempo, viene en null. Es lo único que permite una key test.

Escribir. Sin dry_run (key live) responde added o removed con lo que cambió. Los términos se guardan con la primera letra en mayúscula y sin tildes: «RAY-BÁN» queda «Ray-ban». Con el header Idempotency-Key un reintento no repite el cambio (vea Idempotencia). Si el término ya existe en el diccionario de Automeli con otro tipo (por ejemplo, como palabra cuando lo pidió como marca), se activa con ese tipo: revise stored_as y note en el dry_run.

Rechazos. Lo que no se puede aplicar a un término no es un error: vuelve en rejected con su code y un reason en español, y el resto se aplica. El term vuelve como quedaría guardado («Ray-ban»), no como lo envió. Si no queda nada que cambiar (todo ya estaba, o todo se rechazó), responde 200 con todo en rejected. Cada elemento de terms es un solo término: «Nike, Inc» no se parte en dos, vuelve con TERM_CONTAINS_COMMA. Un error 422 solo llega si el pedido entero está mal (por ejemplo, más de 10 términos o action inválida).

Errores posibles de este endpoint (6)
E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403
E_RATE_LIMITED

Excedió el rate limit. Ver Retry-After

429
E_IDEMPOTENCY_CONFLICT

Misma Idempotency-Key con body distinto

409
E_BLACKLIST_INVALID_TERMS

Sólo v2 (POST /blacklist/terms): action, type, terms o dry_run inválidos, o más de 10 términos. Los términos que no sirven uno por uno no son error: vuelven en rejected con 200

422
E_ACTION_REQUIRES_LIVE_KEY

Acción real con key test (ml-actions, tax-category, delete-from-automeli, blacklist/terms): con test solo se permite dry_run

403
E_INTERNAL

Error inesperado. Reintente con backoff

503