Telegram football bots,
on the wire.

Build a Telegram football bot in 10 lines

Handle Telegram commands and forward live scores directly to users with zero parsing hassle:

import { Bot } from 'grammy';

const bot = new Bot(process.env.TELEGRAM_BOT_TOKEN);

// Command: /live - Return all live football matches
bot.command('live', async (ctx) => {
  const res = await fetch('https://api.kickoffapi.com/api/v1/fixtures?live=all', {
    headers: { 'x-api-key': process.env.KICKOFF_API_KEY }
  });
  const data = await res.json();
  
  if (!data.results) return ctx.reply('No matches currently in-play.');

  const text = data.response
    .map(m => `⚽ ${m.homeTeam.name} ${m.goalsHome} - ${m.goalsAway} ${m.awayTeam.name} (${m.elapsed}')`)
    .join('\n');

  await ctx.reply(`*Live Scores:*\n${text}`, { parse_mode: 'Markdown' });
});

bot.start();

Want automatic alerts pushed to your channels when a goal is scored? Use KickoffAPI Webhooks to receive JSON events in real-time. Check out the API documentation.

Slash commands to API mapping

Frequently asked questions