Tools de Mercado Livre
Las 14 operaciones de Mercado Livre que tu producto ejecuta en la cuenta de tu cliente con Connect. Todas usan el mismo endpoint, POST /api/tools/{tool}/execute.
- Obtener usuario actualGETDevuelve la cuenta de vendedor conectada: id, nickname, email, site_id y reputación del vendedor. El id es el user_id, seller y seller_id de las demás herramientas, y el site_id (MLB en Brasil) va en Buscar categorías.
- Buscar anunciosGETLista los ids de los anuncios del vendedor, 50 por página por defecto. results tiene solo ids de anuncios: Listar anuncios devuelve sus detalles. Pagina con offset y limit; pasados 1000 resultados usa search_type scan y el scroll_id de cada respuesta.
- Listar anunciosGETDevuelve hasta 20 anuncios por id en una llamada: título, precio, available_quantity, sold_quantity, status, permalink, imágenes y atributos. Cada elemento tiene status_code, id y el anuncio en body.
- Buscar categoríasGETPredice la categoría de un producto a partir del título, con el dominio y los atributos reconocidos en el texto. El primer resultado es el más probable. Su category_id va en Crear anuncio y en Listar atributos de la categoría.
- Listar atributos de la categoríaGETLista los atributos de una categoría con id, value_type, valores aceptados y tags. Los atributos con la tag required deben enviarse en Crear anuncio, y los new_required cuando el ítem es nuevo.
- Crear anuncioPOSTPublica un anuncio y lo devuelve con su id. En el modelo User Products, activo para todos los vendedores, envía family_name y ningún title: Mercado Livre arma el título. La descripción se agrega después con Crear descripción del anuncio.
- Actualizar anuncioPUTCambia un anuncio y lo devuelve. Solo cambian los campos enviados. status paused lo oculta, active lo reactiva y closed lo termina para siempre. title y family_name solo cambian mientras el anuncio no tiene ventas.
- Obtener descripción del anuncioGETDevuelve la descripción de un anuncio en plain_text, con date_created y last_updated.
- Crear descripción del anuncioPOSTAgrega la descripción a un anuncio que no tiene una, como uno recién creado con Crear anuncio. Falla con 400 cuando ya existe una descripción: usa Actualizar descripción del anuncio.
- Actualizar descripción del anuncioPUTReemplaza la descripción de un anuncio que ya tiene una.
- Buscar pedidosGETLista las ventas del vendedor de los últimos 12 meses, con comprador, ítems, pagos e id de envío. sort date_desc trae las más recientes primero. Pagina con offset y limit; paging.total tiene el conteo.
- Obtener pedidoGETDevuelve una venta: status, ítems, cantidades, precios, pagos, comprador, tags y el id de envío.
- Buscar preguntasGETLista las preguntas que los compradores hicieron en los anuncios del vendedor, o en un anuncio, con la respuesta cuando la hay. Las preguntas sin responder de más de 7 meses se eliminan. Pagina con offset y limit.
- Responder preguntaPOSTPublica la respuesta del vendedor a una pregunta de comprador y devuelve la pregunta con la respuesta. La respuesta es pública en el anuncio.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
