E-commerce
Mercado Livre no seu produto e nos seus agentes de IA, por uma API
O toolkit do Mercado Livre cobre a conta do vendedor, busca e detalhes de anúncios, previsão de categoria e atributos, criação e atualização de anúncios e descrições, pedidos e perguntas de compradores. Seu cliente conecta a conta de vendedor uma vez por OAuth, e seu produto ou agente de IA executa cada operação pelo Connect, que guarda e renova as credenciais e registra cada execução.
15 dias para testar. Sem cartão de crédito.
POST https://connect.reportei.com/api/tools/mercado_livre_create_item/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"family_name": "<family_name>",
"category_id": "<category_id>",
"price": 1,
"currency_id": "<currency_id>",
"available_quantity": 1,
"buying_mode": "buy_it_now",
"listing_type_id": "<listing_type_id>"
}
}Como funciona
Do cliente conectado à primeira chamada no Mercado Livre.
- 1
O cliente conecta a conta
Seu sistema abre uma sessão do Connect para o toolkit e o cliente conecta a conta do Mercado Livre. Você recebe o id da conexão.
- 2
Seu produto chama a tool
Um POST em /api/tools/{tool}/execute com o id da conexão e os argumentos. Em caso de sucesso, o Connect preserva o status e o corpo da resposta do app.
- 3
O Connect cuida do resto
Guarda a credencial criptografada, renova tokens quando a conexão usa OAuth com suporte a renovação e registra as execuções numa trilha de auditoria consultável pela API.
Para que usar
O que o seu produto faz com o Mercado Livre.
Publique anúncios do seu catálogo
Preveja a categoria a partir de um título, leia os atributos obrigatórios e crie o item e sua descrição com os dados do seu próprio produto.
Sincronize pedidos e estoque
Busque os pedidos do vendedor e leia cada venda com itens, pagamentos e id de envio para alimentar seu ERP ou fluxo de expedição.
Agente responde perguntas de compradores
Um agente de IA lista as perguntas sem resposta nos anúncios do vendedor e publica a resposta com Responder pergunta.
Tools
14 tools do Mercado Livre
- 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.
OAuth com o app do seu produto
Você cadastra o app OAuth do seu produto uma vez, em POST /api/merchants/credentials/mercado_livre, e o cliente autoriza a conta numa tela de consentimento. O Connect renova o token quando ele está para vencer.
Perguntas sobre o toolkit do Mercado Livre
Preciso implementar a API do Mercado Livre?
Não. O Connect já traz 14 tools do Mercado Livre descritas e prontas. Seu cliente conecta a conta e o seu sistema chama cada tool pelo mesmo endpoint, com o mesmo formato de requisição.
Como o cliente conecta a conta do Mercado Livre?
Pelo modo que o toolkit aceita: OAuth com o app do seu produto. O Connect guarda a credencial criptografada e nunca a devolve ao seu sistema.
Funciona com agentes de IA?
Sim. O input de cada tool é descrito em JSON Schema, que o seu agente usa direto como definição de tool. O agente escolhe a tool e os argumentos, e o seu sistema faz a chamada ao Connect.
Meu cliente precisa ter conta no Reportei?
Não. O cliente conecta a conta numa tela do Connect, ou o seu sistema envia a credencial pela API, e ele continua usando só o seu produto.
Veja o Connect aplicado ao seu produto.
Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.
