Última atualização em 09/11/2025

Configuração ou requisitos prévios

Antes de começar, é necessário realizar uma série de etapas prévias para deixar tudo pronto.

1. Crie sua conta do Mercado Livre

Para começar a usar nossa API, você precisa de uma conta do Mercado Livre. Essa conta será seu acesso principal ao ecossistema de desenvolvimento.

Já tem uma conta? Ótimo! Você pode pular para o próximo passo.
É novo no Mercado Livre? Não se preocupe, registrar-se é muito fácil. Basta visitar o site do Mercado Livre correspondente ao seu país e seguir as instruções para criar uma conta.

2. Configure sua aplicação e obtenha suas credenciais

Para poder usar a API do Mercado Livre, cada desenvolvedor precisa criar uma aplicação em nosso portal de desenvolvedores. Isso permitirá que você obtenha as credenciais únicas necessárias para acessar nossos serviços.

Siga estes passos:

Visite nosso site de desenvolvedores. Na página, selecione o país em que você vai trabalhar para acessar a documentação e os recursos correspondentes.
Siga este guia detalhado passo a passo para criar sua aplicação: em seguida, você obterá um Client ID e um Client Secret. Guarde-os bem, pois precisará deles!

Importante:

Durante a criação da sua aplicação, você deverá adicionar pelo menos um “Redirect URI”. Você pode inserir uma URL de teste (mesmo que não exista), pois precisará dela no próximo passo.

Em resumo, com suas credenciais (Client ID e Client Secret), você poderá gerar ‘Access Tokens’ para interagir com a API.

3. Obtenha seu Access Token: a chave para acessar a API

Chegou o momento de obter seu Access Token! Esse token é como uma chave que permitirá acessar a API do Mercado Livre de forma segura. Siga os passos detalhados na seção de Autenticação para consegui-lo e, em seguida, volte a este ponto para continuar.

Quer saber mais?

Para uma compreensão mais profunda sobre autenticação e autorização, consulte nossa documentação completa: Autenticação e Autorização .

4. Faça sua primeira requisição à API

Com seu Access Token em mãos, vamos realizar uma requisição simples para verificar se tudo está configurado corretamente.

Siga este passo:

Abra seu terminal ou linha de comando e execute a seguinte requisição curl:

curl -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/me

Parâmetro	Tipo	Opcional	Valores
`ACCESS_TOKEN`	string	Não	Lembre-se de utilizar o token que você gerou no passo anterior

O que esperar?

Se tudo correu bem, você receberá uma resposta da nossa API com um código de status 200 OK e um corpo contendo os dados do seu usuário. Isso significa que você está conectado!

Encontrou algum problema?

Se você receber um erro, não se preocupe. Consulte a seção de erros comuns relacionados a Access Tokens em nossa documentação de Autenticação e Autorização.

Pronto! você já está conectado à nossa API

Você completou a configuração inicial.

Mas atenção:

Você fez isso com sua conta real. Para evitar movimentos ou cobranças indesejadas, os próximos passos devem ser feitos com um usuário de teste. A seguir, explicaremos como criá-lo.

Agora sim, você está pronto para explorar a API do Mercado Livre e começar a construir soluções incríveis.