Mercado Livre API 🎉🚀

Bem-vindo à API Pública de Produtos do Mercado Livre! 🤖💡

Esta API permite buscar produtos no Mercado Livre de maneira simples e rápida. Você pode fazer pesquisas personalizadas e obter detalhes sobre os produtos diretamente no formato JSON. Com isso, você pode integrar esses dados em qualquer aplicação ou só se divertir navegando por eles.

Protip: Use o endpoint da API para buscar o que você quiser e automatizar consultas para seu site, app ou chatbot! 😎

---

🚀 O que é isso?

A API Pública de Produtos do Mercado Livre faz web scraping no site do Mercado Livre e retorna um dicionário com o nome, preço e link de aproximadamente 50 produtos com base na sua busca. A API é construída usando Flask e pode ser facilmente acessada via HTTP.

Funcionalidades principais:

• Busca de produtos por nome.
• Retorno de dados dos produtos em formato JSON.
• Busca de um produto específico por ID (número do índice).
• Exemplo: Você pode buscar por tapete de pano para banheiro e obter uma lista de produtos com nome, preço e link. 😍

---

🔥 Como começar?

1. Clone este repositório:

git clone https://github.com/seu-usuario/mercado-livre-api.git
cd mercado-livre-api

2. Instale as dependências necessárias:

Você precisará de algumas bibliotecas para rodar a aplicação. Basta usar o pip para instalá-las:

pip install -r requirements.txt

3. Rodando a API:

Inicie a aplicação com o seguinte comando:

python app.py

Por padrão, o servidor Flask vai rodar no http://127.0.0.1:5000/ 🚀.

---

🛠️ Endpoints da API

Aqui estão os dois endpoints principais da nossa API:

1. Buscar produtos por nome

URL: /nome-da-busca

Método: GET

Exemplo de requisição:

GET http://127.0.0.1:5000/tapete-de-pano-para-banho

Resposta:

Retorna uma lista com os produtos encontrados para a pesquisa "tapete de pano para banho". Cada produto inclui as informações de nome, preço e link.

[
  {
    "nome": "Tapete de Pano para Banheiro - Azul",
    "preco": "R$ 39,90",
    "link": "https://mercadolivre.com.br/azul"
  },
  {
    "nome": "Tapete para Banheiro - Pano",
    "preco": "R$ 45,00",
    "link": "https://mercadolivre.com.br/banheiro"
  }
]

2. Buscar um produto específico pelo ID

URL: /nome-da-busca/id-do-produto

Método: GET

Exemplo de requisição:

GET http://127.0.0.1:5000/tapete-de-pano-para-banho/2

OBSERVAÇÃO: Não é necessário colocar nada entre as palavras quando buscar por um produto, pois o script já trata a string automaticamente.

Exemplo:

Você pode fazer suas requisições dessa maneira:

GET http://127.0.0.1:5000/tapete de pano para banho/2

Resposta:

Retorna os dados de um produto específico baseado no ID fornecido (a contagem começa do 0).

{
  "nome": "Tapete de Pano para Banheiro - Azul",
  "preco": "R$ 39,90",
  "link": "https://mercadolivre.com.br/azul"
}

Caso o ID seja inválido (fora do intervalo de produtos encontrados), a resposta será:

{
  "erro": "Produto não encontrado. ID fora do intervalo, digite um número menor ou igual a 50."
}

---

📝 Como funciona o código?

O projeto é composto por dois arquivos principais:

scrap_ml.py:

Este arquivo contém o código responsável pelo web scraping no site do Mercado Livre. Ele:

• Constrói a URL de busca com base na pesquisa fornecida.
• Realiza a requisição HTTP para obter a página de resultados.
• Extrai os dados dos produtos (nome, preço e link) usando o BeautifulSoup.
• Retorna esses dados em formato de lista de dicionários.

app.py:

Este arquivo é onde a API é configurada com o Flask. Ele define os endpoints para que você possa consultar os produtos no Mercado Livre via HTTP. Basicamente:

• O endpoint /nome-da-busca chama a função que pesquisa os produtos.
• O endpoint /nome-da-busca/id-do-produto permite buscar um produto específico pelo índice.

---

🔧 Como contribuir?

Se você tem alguma sugestão de melhoria ou encontrou algum bug, fique à vontade para contribuir!

1. Faça um fork deste repositório.
2. Crie uma branch para sua feature ou correção (git checkout -b minha-feature).
3. Faça commit das suas alterações (git commit -am 'Adicionando nova feature').
4. Envie para o repositório remoto (git push origin minha-feature).
5. Crie um Pull Request explicando as alterações.

Vamos juntos melhorar esse projeto! 🤝

---

💬 Suporte e Contato

Se você tiver dúvidas ou sugestões, pode abrir uma issue aqui mesmo no GitHub ou me procurar nas redes sociais. Estou sempre disponível para ajudar! 😄

• GitHub: @cleitonpcarvalho
• Email: cleiton.carvalho@automasoluct.com

---

🚀 Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para mais detalhes.

---

Aproveite! 🎉🚀