Sportmonks Football API

Sports & Fitness / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

Sportmonks Football API delivers comprehensive football data including live scores, fixtures, standings, player statistics, TV channels, and historical results for leagues like the EPL and La Liga. Authentication uses an API token appended as a query parameter, and a free trial is available on Sportmonks website. It is a feature-rich option for building football web apps or dashboards.

💡

Beginner Tip

Use the includes parameter to expand related data in a single request — for example ?include=localTeam,visitorTeam,scores to avoid multiple API calls. Check the docs for what includes each endpoint supports.

Available Data

article title and content
publication source
published date
article URL
image URL
match scores and results

Example Response

JSON Response
{
  "totalArticles": 100,
  "articles": [
    {
      "title": "Tech Industry Sees Record Growth",
      "source": {
        "name": "TechNews",
        "url": "https://technews.com"
      },
      "publishedAt": "2025-01-15T08:00:00Z",
      "description": "The technology sector reported unprecedented growth...",
      "image": "https://example.com/article-image.jpg",
      "url": "https://technews.com/article/123"
    }
  ]
}

Field Reference

data[].id Unique fixture identifier
data[].time.starting_at.date_time Fixture kick-off date and time
data[].localTeam.data.name Name of the home team (requires include=localTeam)
data[].visitorTeam.data.name Name of the away team (requires include=visitorTeam)
data[].scores.localteam_score Goals scored by the home team
data[].scores.visitorteam_score Goals scored by the away team

Implementation Example

const url = "https://docs.sportmonks.com/football/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

401 Unauthorized api_token query parameter is missing or incorrect
Append ?api_token=YOUR_API_KEY to every request URL
Unexpected null in nested object Requested include relationship is not available for all records
Always null-check nested include objects before accessing their fields
429 Too Many Requests Exceeded your plan rate limit
Reduce request frequency, cache responses, and check your plan requests-per-minute limit in the Sportmonks dashboard

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Sports & Fitness
Difficulty Intermediate
Verified: 2026-04-07

Similar APIs

View All →