Developer API Integration

A simple, fast, and completely public API for live soccer data. No authentication required.

View Full API Spec & AI Prompt (llms.txt)

General Information

Core Capabilities

Real-time scores for major leagues (Live & Today endpoints).
League Standings including group phases (e.g., World Cup, Champions League).
Match Details featuring venue, referee, and live events (goals, cards).
Team Searching to quickly locate specific clubs.

Technical Details

Format: All endpoints return strictly formatted JSON.
Rate Limits: Globally limited to 100 requests per second. Exceeding this returns an HTTP 429 Too Many Requests.
Caching: High-traffic endpoints utilize an aggressive in-memory TTLCache to ensure near-instant response times.
Upstream Handling: If the primary data provider fails, the API gracefully returns HTTP 503 Service Unavailable.

Integration Examples

const fetchLiveMatches = async () => {
  try {
    const response = await fetch('https://aa.tooco.net/api/matches/live');
    
    if (response.status === 429) {
      console.error('Rate limit exceeded');
      return;
    }
    
    const data = await response.json();
    console.log(`Live Matches: ${data.count}`);
    
    data.matches.forEach(match => {
      console.log(`${match.home_team.name} vs ${match.away_team.name}`);
    });
  } catch (error) {
    console.error('Error fetching data:', error);
  }
};

fetchLiveMatches();

<?php
$url = "https://aa.tooco.net/api/matches/live";
$ch = curl_init($url);

curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpcode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpcode == 200) {
    $data = json_decode($response, true);
    echo "Live Matches: " . $data['count'] . "\n";
    foreach ($data['matches'] as $match) {
        echo $match['home_team']['name'] . " vs " . $match['away_team']['name'] . "\n";
    }
} elseif ($httpcode == 429) {
    echo "Rate limit exceeded\n";
}
?>

import requests

url = "https://aa.tooco.net/api/matches/live"
response = requests.get(url)

if response.status_code == 200:
    data = response.json()
    print(f"Live Matches: {data['count']}")
    
    for match in data.get('matches', []):
        print(f"{match['home_team']['name']} vs {match['away_team']['name']}")
elif response.status_code == 429:
    print("Rate limit exceeded")