Documentación · v2
Automeli API
La API pública permite que un sistema externo (ERP, e-commerce, plataforma propia) lea su catálogo y publique productos en Mercado Libre vía Automeli sin pasar por la web. La v2 usa nombres de campo limpios y paginación por cursor en todos los listados. Toda la integración cabe en menos de una hora si sigue el quickstart.
https://api.automeli.com/api/v2 · Auth: header X-API-Key · Errores: RFC 7807 Problem DetailsEmpezar
Registro y primera key
Si nunca usó Automeli: registro, conectar su cuenta de Mercado Libre y generar su primera API Key.
Empezar
Quickstart 60s
Integración mínima end-to-end. Copie 4 comandos curl y lea su catálogo o publique en prueba.
Autenticación
API Keys y scopes
Cómo crear keys, los entornos live/test y los permisos por scope.
Recursos
Catálogo y sincronización
GET /v2/products: el listado de su catálogo con cursor, y PATCH /sync-status para excluir productos.
Recursos
Publicar productos
POST /v2/products, programación con scheduled_for y uso de Idempotency-Key.
Recursos
Jobs
Consultar el estado de un job, listar histórico, reintentar items, cancelar.
Recursos
Productos de prueba
Liste lo que publicó en test y promuévalo a real por listing_id_test.
Recursos
Cuenta y créditos
Info del seller, créditos disponibles y categorías fiscales configuradas.
Referencia
Errores
Catálogo completo de códigos E_*, formato Problem Details y cómo reaccionar.
Referencia
Rate limit
Tope por minuto, headers X-RateLimit-* y reintentos con backoff.
Referencia
Buenas prácticas
Consejos concretos para que su integración sea estable en producción.
Referencia
Migrar desde v1
Tabla de equivalencias campo por campo y los 5 cambios que piden tocar lógica.
Referencia
FAQ
Preguntas frecuentes sobre tipos de publicación, créditos, cursor y errores comunes.
¿Integró con la v1? Sigue funcionando sin cambios y su documentación se conserva en /api-docs/v1; cuando quiera pasarse, la guía de migración lista las equivalencias campo por campo.
¿Algo no quedó claro? Hable con soporte y cite el X-Request-Id de la request que le dio problema — ese header viene en todas las respuestas y nos permite rastrear lo que pasó del lado del server.