iSports API
Sports & FitnessAccess data of 2,000+ football leagues and 800+ basketball leagues: live data, stats, odds, database, animation etc.
📚 Documentation & Examples
Everything you need to integrate with iSports API
🚀 Quick Start Examples
// iSports API API Example
const response = await fetch('https://www.isportsapi.com/en/docs.html', {
method: 'GET',
headers: {
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);iSports API
iSports API delivers real-time and historical sports data covering 2,000+ football leagues and 800+ basketball leagues — live scores, schedules, standings, statistics, live odds, team and player databases, and match animations — through a simple HTTP JSON API.
Base URL: http://api.isportsapi.com
If api.isportsapi.com is slow or unreachable in your region, the mirror http://api2.isportsapi.com serves the same endpoints.
Authentication
Every request is authenticated with your api_key passed as a query-string parameter. Create an account and start a free trial to get a key.
GET http://api.isportsapi.com/sport/football/livescores?api_key=YOUR_API_KEY
Response Envelope
All endpoints return a consistent JSON envelope. A code of 0 means success.
{
"code": 0,
"message": "success",
"data": { }
}
Football Endpoints
| Endpoint | Description |
|---|---|
/sport/football/livescores |
Real-time scores, status and stats for in-play matches (limited to 1 call / 10s) |
/sport/football/schedule/basic |
Match schedule and fixtures |
/sport/football/player/search |
Search players by name (fuzzy match) |
/sport/football/fifaranking |
FIFA team rankings |
Live Scores (cURL)
curl "http://api.isportsapi.com/sport/football/livescores?api_key=YOUR_API_KEY"
Player Search
curl "http://api.isportsapi.com/sport/football/player/search?api_key=YOUR_API_KEY&name=Messi"
Basketball Endpoints
curl "http://api.isportsapi.com/sport/basketball/livescores?api_key=YOUR_API_KEY"
JavaScript Example
const apiKey = 'YOUR_API_KEY';
const res = await fetch(
`http://api.isportsapi.com/sport/football/livescores?api_key=${apiKey}`
);
const { code, message, data } = await res.json();
if (code === 0) {
console.log(data);
} else {
console.error('iSports error:', message);
}
Python Example
import requests
resp = requests.get(
"http://api.isportsapi.com/sport/football/livescores",
params={"api_key": "YOUR_API_KEY"},
)
payload = resp.json()
if payload["code"] == 0:
print(payload["data"])
else:
print("iSports error:", payload["message"])
Notes
- Live score endpoints are rate-limited (e.g. 1 call / 10 seconds) — poll responsibly.
- Match
statusandleagueTypeare returned as numeric codes; see the official docs for the full mapping.
