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.
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.
/v2/blacklistGET /blacklistcurl "https://api.automeli.com/api/v2/blacklist?search=ray&limit=2" \
-H "X-API-Key: automeli_live_..."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 }
}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_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_BLACKLIST_INVALID_PARAMSó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
422E_ACCOUNT_NOT_FOUNDCuenta Meli no encontrada
404E_INTERNALError inesperado. Reintente con backoff
503Hasta 10 términos por llamada. Empiece siempre con dry_run: true: no escribe nada y dice cuántas publicaciones pausaría o reactivaría.
/v2/blacklist/termsPOST /blacklist/termscurl -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
}'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
}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_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_RATE_LIMITEDExcedió el rate limit. Ver Retry-After
429E_IDEMPOTENCY_CONFLICTMisma Idempotency-Key con body distinto
409E_BLACKLIST_INVALID_TERMSSó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
422E_ACTION_REQUIRES_LIVE_KEYAcción real con key test (ml-actions, tax-category, delete-from-automeli, blacklist/terms): con test solo se permite dry_run
403E_INTERNALError inesperado. Reintente con backoff
503