Criei um cliente Node.js para a API não documentada do Transfermarkt ⚽ · wcarmesini

Fala pessoal! 👋

Recentemente desenvolvi um cliente em Node.js para consumir dados do Transfermarkt, uma das maiores plataformas de estatísticas de futebol do mundo.

⚡ O que ele faz?

Com essa biblioteca você consegue acessar de forma simples e otimizada:

👤 Perfis de jogadores (dados, histórico, valor de mercado, etc.)
🏟️ Informações de clubes e estádios
🏆 Dados de competições e tabelas
🎮 Detalhes de partidas (lineups, eventos, placar)
👨‍⚖️ Perfis de árbitros e treinadores

Tudo isso já com caching integrado (via node-cache) para evitar requisições repetidas e melhorar a performance.

⚠️ Importante

Apesar de a API ser oficialmente utilizada no site do Transfermarkt, ela não é pública nem documentada pela empresa.
Por isso, os endpoints podem mudar a qualquer momento sem aviso prévio.

🚀 Como usar

O projeto está disponível no GitHub:
👉 wcarmesini/transfermarkt_api_client

Basta clonar o repositório e instalar as dependências:

git clone https://github.com/wcarmesini/transfermarkt_api_client.git
cd transfermarkt_api_client
npm install

Exemplo básico para buscar informações de um jogador:

import { playerProfile } from './src/services/index.js';

async function run() {
  const messi = await playerProfile(28003);
  console.log(messi);
}

run();

🤝 Contribuições

Toda ajuda é bem-vinda!
Se quiser testar, sugerir melhorias ou abrir PRs, fique à vontade no repositório.

⚽ Se você curte futebol, dados e programação, acho que vai gostar desse projeto.
Dá uma olhada e me conta o que achou! 👇