Está viendo la documentación de la API v1 (versión anterior). v1 sigue funcionando sin cambios hasta el 31 de enero de 2027, fecha en la que se apagará. Las integraciones nuevas deben usar la API v2, que cubre todo lo de v1 con nombres limpios y paginación por cursor. Si ya integró con v1, la guía de migración lista las equivalencias campo por campo.

Recursos

Productos en cuenta de prueba

Liste los productos que ya publicaste con una key test y que todavía no promoviste a la cuenta real. Sirve para reproducir el flujo de la web: publicar primero en prueba, revisar, y después publicar en real.

Listar productos en cuenta de prueba

GET/v1/products/test

Probar en sandbox

scopeproducts:read

Devuelve los productos almacenados en saved_products — los que se crearon al publicar con una API Key automeli_test_*. El campo published_to_live indica si ese SKU ya se promovió a la cuenta real.

RequestGET /products/test

curl "https://api.automeli.com/api/v1/products/test?status_meli=active&already_published=false&limit=50" \
     -H "X-API-Key: automeli_live_..."

200Response

Lista paginada de productos en la cuenta de prueba.

{
  "products": [
    {
      "sku": "B003H03SDQ",
      "listing_id_test": "MCO1943839161",
      "title": "Producto de prueba",
      "image": "https://http2.mlstatic.com/...jpg",
      "permalink_test": "https://articulo.mercadolibre.com.co/...",
      "listing_type_id": "gold_pro",
      "price": 89000,
      "currency": "COP",
      "category_id": "MCO420674",
      "category_name": "Soluciones Limpiadoras",
      "tax_category_id": 0,
      "status_meli": "active",
      "app_status": 1,
      "published_to_live": false,
      "test_published_at": "2026-05-08T12:00:00.000Z"
    }
  ],
  "pagination": { "limit": 50, "offset": 0, "returned": 1, "total": 1 }
}

Filtros disponibles

already_published

booleanopcional

Filtra por la columna en BD (en el response sale como published_to_live). false → solo los pendientes de promover a real. true → los que ya pasaron a real.

status_meli

stringopcional

Estado del listing en Mercado Libre. Útil para mostrar solo los que están sirviendo en test: active, paused, closed, under_review, inactive, not_yet_active, payment_required.

app_status

numberopcional

Estado interno de Automeli (0=pausado/eliminado, 1=activo).

sku

stringopcional

Filtra por SKU exacto.

limit

number (1-200)opcional

Default 50.

offset

numberopcional

Default 0. Para paginar.

Errores posibles de este endpoint (3)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_PRODUCT_INVALID_BODY

Body o query malformado (campo, fecha o estado inválido)

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

Flujo recomendado para replicar la web: (1) publique con una key test usando POST /v1/products; (2) liste los pendientes con GET /v1/products/test?already_published=false; (3) cuando un SKU esté listo, haga POST /v1/products con una key live para el mismo SKU. Automeli marca published_to_live: true en la misma transacción del publicador.

Atajo: promover en una sola llamada

Si quiere ahorrarte el GET + POST, hay un endpoint que hace todo en uno: lista internamente los SKUs activos pendientes y los publica en cuenta real.

POST/v1/products/test/promote

Probar en sandbox

scopeproducts:writekeyliveidempotent

Requiere una key automeli_live_*.

Body con todos los campos opcionales. Sin skus promueve todos los candidatos (hasta 1000 por llamada). Devuelve 202 con el job_id y la lista de SKUs aceptados:

RequestPOST /products/test/promote

curl -X POST "https://api.automeli.com/api/v1/products/test/promote" \
     -H "X-API-Key: automeli_live_..." \
     -H "Content-Type: application/json" \
     -d '{
  "skus": ["B003H03SDQ", "B07JHNJLYH"],
  "listing_type_id": "gold_pro",
  "tax_category_id": 0
}'

202Response

Job de promoción aceptado. Devuelve job_id y la lista de SKUs aceptados.

{
  "job_id": "8a3f2b10-4c9d-4e21-9f8a-1b2c3d4e5f60",
  "status": "queued",
  "promoted": 12,
  "rejected": 0,
  "total_candidates": 12,
  "skus": ["B003H03SDQ", "B07JHNJLYH", "..."]
}

Si usa una key test recibe 403 E_PROMOTE_REQUIRES_LIVE_KEY. Si ningún SKU cumple el filtro, 400 E_PROMOTE_NO_CANDIDATES.

Errores posibles de este endpoint (8)

E_AUTH_FORBIDDEN_SCOPE

Su key no tiene el permiso requerido (ver scopes)

403

E_PROMOTE_REQUIRES_LIVE_KEY

Endpoint /products/test/promote sólo acepta key live

403

E_PROMOTE_NO_CANDIDATES

Ningún producto de prueba publicable coincide con lo pedido

400

E_PRODUCT_INVALID_BODY

Body o query malformado (campo, fecha o estado inválido)

422

E_PRODUCT_INVALID_SKU

SKU no cumple regex (10 alfanum)

422

E_PRODUCT_CREDIT_EXHAUSTED

Sin créditos disponibles

400

E_PRODUCT_MAX_CONCURRENT_JOBS

Ya tiene 6 jobs activos

429

E_ACCOUNT_NOT_FOUND

Cuenta Meli no encontrada

404