Tools do Mercado Livre
As 14 operações do Mercado Livre que o seu produto executa na conta do cliente pelo Connect. Todas usam o mesmo endpoint, POST /api/tools/{tool}/execute.
- Obter usuário atualGETRetorna a conta de vendedor conectada: id, nickname, email, site_id e reputação do vendedor. O id é o user_id, seller e seller_id das outras ferramentas, e o site_id (MLB no Brasil) vai em Buscar categorias.
- Buscar anúnciosGETLista os ids dos anúncios do vendedor, 50 por página por padrão. results tem só ids de anúncios: Listar anúncios retorna seus detalhes. Pagine com offset e limit; acima de 1000 resultados use search_type scan e o scroll_id de cada resposta.
- Listar anúnciosGETRetorna até 20 anúncios por id em uma chamada: título, preço, available_quantity, sold_quantity, status, permalink, imagens e atributos. Cada elemento tem status_code, id e o anúncio em body.
- Buscar categoriasGETPrevê a categoria de um produto a partir do título, com o domínio e os atributos reconhecidos no texto. O primeiro resultado é o mais provável. O category_id dele vai em Criar anúncio e em Listar atributos da categoria.
- Listar atributos da categoriaGETLista os atributos de uma categoria com id, value_type, valores aceitos e tags. Atributos com a tag required devem ser enviados em Criar anúncio, e os new_required quando o item é novo.
- Criar anúncioPOSTPublica um anúncio e o retorna com seu id. No modelo User Products, ativo para todos os vendedores, envie family_name e nenhum title: o Mercado Livre monta o título. A descrição é adicionada depois com Criar descrição do anúncio.
- Atualizar anúncioPUTAltera um anúncio e o retorna. Só os campos enviados mudam. status paused o oculta, active o reativa e closed o encerra de vez. title e family_name só mudam enquanto o anúncio não tem vendas.
- Obter descrição do anúncioGETRetorna a descrição de um anúncio em plain_text, com date_created e last_updated.
- Criar descrição do anúncioPOSTAdiciona a descrição a um anúncio que não tem uma, como um recém-criado com Criar anúncio. Falha com 400 quando já existe uma descrição: use Atualizar descrição do anúncio.
- Atualizar descrição do anúncioPUTSubstitui a descrição de um anúncio que já tem uma.
- Buscar pedidosGETLista as vendas do vendedor dos últimos 12 meses, com comprador, itens, pagamentos e id de envio. sort date_desc traz as mais recentes primeiro. Pagine com offset e limit; paging.total tem a contagem.
- Obter pedidoGETRetorna uma venda: status, itens, quantidades, preços, pagamentos, comprador, tags e o id de envio.
- Buscar perguntasGETLista as perguntas que compradores fizeram nos anúncios do vendedor, ou em um anúncio, com a resposta quando há. Perguntas sem resposta com mais de 7 meses são apagadas. Pagine com offset e limit.
- Responder perguntaPOSTPublica a resposta do vendedor a uma pergunta de comprador e retorna a pergunta com a resposta. A resposta é pública no anúncio.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
