Recursos
Acciones en Mercado Libre
Pause, active, cierre, republique o cambie el tipo de sus publicaciones de Mercado Libre desde su sistema, igual que en el panel: por lista de publicaciones o por filtros, hasta 10.000 por llamada.
Pausar
pauseDeja de mostrarse en Mercado Libre. Se puede reactivar.
Activar
activateVuelve a mostrar una publicación pausada.
Cerrar
closeFinaliza la publicación. No se puede deshacer.
Republicar
republishCrea de nuevo una publicación cerrada.
Cambiar tipo
change_listing_typeEntre Clásica (gold_special) y Premium (gold_pro).
- 1
Simule
Envíe la acción con dry_run: true. No toca nada y le dice cuántas publicaciones coinciden.
"dry_run": true - 2
Revise
Mire matched y la muestra de listing_ids. Si no es lo que esperaba, ajuste los filtros.
"matched": 37 - 3
Ejecute
Repita sin dry_run y con una key live. Para cerrar o republicar, envíe un Idempotency-Key y, si es por filtros, el conteo.
"expected_count": 37 - 4
Siga el avance
Consulte el job hasta que termine y revise failed_items.
"status": "completed"
listings:write, que al crear la key viene desmarcado y hay que activar a mano. Con una key test solo se puede simular.ml_status, la acción solo toma publicaciones activas o pausadas, y republish solo toma las cerradas. Puede haber hasta 3 acciones en curso a la vez./v2/products/ml-actionsPOST /products/ml-actionscurl -X POST "https://api.automeli.com/api/v2/products/ml-actions" \
-H "X-API-Key: automeli_live_..." \
-H "Content-Type: application/json" \
-d '{
"action": "pause",
"filters": { "ml_status": "active", "amazon_status": "Agotado" },
"dry_run": true
}'dry_run: true. No se ejecutó nada; matched es cuántas publicaciones tocaría.
{
"dry_run": true,
"action": "pause",
"matched": 37,
"sample": ["MCO1234567890", "MCO1234567891"],
"has_more": false,
"next_cursor": null
}actionlisting_idsfiltersexclude_listing_idslisting_typeexpected_countdry_runcursorGET /v2/products es lo que tocará la acción. Si una clave no está permitida, la API responde 422 en vez de ignorarla, para que un filtro mal escrito nunca amplíe el alcance.close y republish reales exigen el header Idempotency-Key; sin él la API responde 428 y no ejecuta nada. Reintentar un republish sin esa key crearía publicaciones duplicadas. Use una key estable por acción: si reintenta con la misma, recibe la respuesta original en vez de repetir la acción.next_cursor de la anterior, sin esperar a que termine su job: el cursor vence 1 hora después de emitido y puede haber hasta 3 jobs en curso. Si aun así recibe 422 E_ACTION_CURSOR_INVALID, no relance el republish: revise en Mercado Libre qué se republicó antes de decidir."status": "unconfirmed", el servicio no confirmó a tiempo que la acción quedó en cola. Consulte el job_id con GET: puede tardar hasta un minuto en aparecer, y solo si sigue en 404 pasado ese minuto, no se creó. No la envíe de nuevo con otra Idempotency-Key, porque podría ejecutarse dos veces.Errores posibles de este endpoint (15)
E_AUTH_MISSING_KEYFalta el header X-API-Key
401E_AUTH_INVALID_KEYKey con formato inválido o no reconocida
401E_AUTH_FORBIDDEN_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_RATE_LIMITEDExcedió el rate limit. Ver Retry-After
429E_CONCURRENCY_LIMITEDYa tiene en curso el máximo de peticiones simultáneas de su plan con esta API Key (v1 y v2 comparten el cupo; ver Rate limit). Trae Retry-After: 2; espere a que terminen las que tiene en vuelo antes de enviar más
429E_IDEMPOTENCY_CONFLICTMisma Idempotency-Key con body distinto
409E_PRODUCT_INVALID_BODYBody malformado o con campos inválidos (POST/PATCH)
422E_ACTION_CURSOR_INVALIDSólo v2 (ml-actions, tax-category, delete-from-automeli): el cursor venció (1 hora), fue alterado, es de otro alcance o llegó con otro expected_count. No se ejecutó nada: repita el dry_run y vuelva a empezar sin cursor, salvo en republish, donde reiniciar puede duplicar publicaciones (vea ml-actions). Los errores de filters en estas acciones devuelven E_PRODUCT_INVALID_BODY
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_ACTION_COUNT_MISMATCHAcción real con expected_count (obligatorio por filtros en close/republish de ml-actions, tax-category y delete-from-automeli): el conteo real supera expected_count más la tolerancia
409E_ACTION_MAX_CONCURRENT_JOBSYa tiene 3 jobs de acciones en cola o en proceso
429E_ACTION_IDEMPOTENCY_KEY_REQUIREDAcción real sin el header Idempotency-Key (close/republish de ml-actions, delete-from-automeli)
428E_ACTION_REJECTEDEl servicio de acciones rechazó la solicitud (p. ej. supera el máximo de publicaciones a cerrar); el detalle trae el motivo
422E_NO_ML_TOKENLa cuenta no tiene un token de MercadoLibre vinculado
400E_INTERNALError inesperado. Reintente con backoff
503Consulte cada 5 a 10 segundos hasta que el status sea completed, failed o cancelled.
/v2/products/ml-actions/{jobId}GET /products/ml-actions/{jobId}curl "https://api.automeli.com/api/v2/products/ml-actions/<job_id>" \
-H "X-API-Key: automeli_live_..."Estado del job. failed_items_truncated indica que hay más fallos que los listados.
{
"job_id": "1759672800123",
"action": "pause",
"status": "completed",
"total": 37,
"processed": 37,
"successful": 36,
"failed": 1,
"failed_items": [
{ "listing_id": "MCO1234567899", "error": "item_under_review" }
],
"failed_items_truncated": false,
"cancellation_requested": false,
"message": null,
"created_at": "2026-10-05T14:00:00.000Z",
"updated_at": "2026-10-05T14:01:12.000Z"
}Errores posibles de este endpoint (4)
E_AUTH_FORBIDDEN_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_CONCURRENCY_LIMITEDYa tiene en curso el máximo de peticiones simultáneas de su plan con esta API Key (v1 y v2 comparten el cupo; ver Rate limit). Trae Retry-After: 2; espere a que terminen las que tiene en vuelo antes de enviar más
429E_JOB_NOT_FOUNDjobId no existe o no es de su seller
404E_INTERNALError inesperado. Reintente con backoff
503/v2/products/ml-actions/{jobId}/cancelPOST /products/ml-actions/{jobId}/cancelcurl -X POST "https://api.automeli.com/api/v2/products/ml-actions/<job_id>/cancel" \
-H "X-API-Key: automeli_live_..."Cancelación solicitada.
{
"job_id": "1759672800123",
"status": "cancellation_requested",
"message": "Cancelación solicitada: el job se detiene antes del siguiente lote; lo ya hecho en Mercado Libre queda hecho."
}Errores posibles de este endpoint (5)
E_AUTH_FORBIDDEN_SCOPESu key no tiene el permiso requerido (ver scopes)
403E_CONCURRENCY_LIMITEDYa tiene en curso el máximo de peticiones simultáneas de su plan con esta API Key (v1 y v2 comparten el cupo; ver Rate limit). Trae Retry-After: 2; espere a que terminen las que tiene en vuelo antes de enviar más
429E_JOB_NOT_FOUNDjobId no existe o no es de su seller
404E_JOB_ALREADY_TERMINALCancel sobre job ya cerrado
400E_INTERNALError inesperado. Reintente con backoff
503