OddsCoreAPI 2 (Deprecated)WidgetsContact

Introduction

Welcome to Sportmonks Football API 3.0 — your gateway to real-time and historical football data from around the world. This REST API lets you easily request structured data for leagues, teams, players

🌍 Overview

Sportmonks Football API 3.0 is built for flexibility, accuracy, and speed. It offers:

  • Highly customisable requests – filter, include, and select exactly what you need.

  • Fast livescores – get near real-time updates from leagues worldwide.

  • Reliable, verified data – trusted by thousands of developers and businesses.

In addition to the Football API, Sportmonks also offers:

  • 🧠 Prediction API – machine learning–powered match probabilities and value bets.

  • 🗞 News API – sports headlines and articles for enriched content.

  • 🧩 Football Widgets – ready-made, embeddable components.

  • 🏏 Cricket API and 🏎 Formula 1 API – part of our growing sports data suite.

📈 Coverage

  • Over 2,300 football leagues covered.

  • More than 1,350 leagues included in the Prediction API.

  • Every continent, country, league, season, stage, round, venue, TV station, player, coach, referee, bookmaker, market, event, and fixture has its own unique ID.

  • Over 100 endpoints, grouped under 15+ entities, each with its own filters, includes, and examples.

⚙️ API Structure

Sportmonks API 3.0 is built around structured entities. Each entity represents a data type (like teams, fixtures, or players) and provides multiple endpoints for different operations.

Example entities include:

  • Fixtures — match data, events, and statistics.

  • Teams — squads, stats, and performance metrics.

  • Players — personal data, stats, transfers, and more.

  • Standings — league tables and rankings.

💡 Each entity has a rate limit calculated over all its endpoints. You can read more in our Rate Limit guide.

🧭 Getting Started

We’ve built tutorials and guides to help you quickly integrate the API into your project. Start with:

  1. Authentication — learn how to authenticate using your API token.

  2. Making your first request — see step-by-step examples of a live API call.

  3. Request Options — customise your queries with filtering, sorting, and includes.

Example:

curl "https://api.sportmonks.com/v3/football/leagues?api_token=YOUR_TOKEN"

This request returns all leagues available in your subscription, including their names, IDs, and metadata.

🧰 Developer Resources

  • Best Practices — learn how to optimise calls and sync data efficiently.

  • Demo Response Files — preview real JSON responses before integrating.

  • Guides & Tutorials — deep dives into live data, statistics, and widgets.

🚀 Ready to Build?

You can jump right in with our tutorials or Postman collection to start experimenting:

👉 Run in Postman

PreviousTutorialsNextMake your first request

Last updated

Was this helpful?