News API
Contents

What Sportmonks provides

Each news article record includes:
– A unique article ID
– The fixture ID the article relates to
– The league ID the article relates to
– The article title
– The article type, either prematch or postmatch

Article body content is structured as individual lines through the NewsItemLine entity, accessible via the lines include. Each line has its own text field and a type field indicating the role of that line within the article.

Pre-match articles are published at a minimum of 48 hours before kick-off. Post-match articles are published as soon as a fixture concludes.

Pre-match coverage spans the UEFA Champions League, English Premier League, Spanish La Liga, German Bundesliga, Italian Serie A, and French Ligue 1. Pre-match articles are expert-written. Post-match articles are generated with AI.

Endpoints

The News group has five endpoints split across pre-match and post-match content.

GET Pre-Match News — returns all pre-match articles available within your subscription:

GET https://api.sportmonks.com/v3/football/news/pre-match

GET Pre-Match News by Season ID — returns all pre-match articles for a specific season:

GET https://api.sportmonks.com/v3/football/news/pre-match/seasons/{season_id}

GET Pre-Match News for Upcoming Fixtures — returns pre-match articles for all upcoming fixtures within your subscription:

GET https://api.sportmonks.com/v3/football/news/pre-match/upcoming

GET Post-Match News — returns all post-match articles available within your subscription:

GET https://api.sportmonks.com/v3/football/news/post-match

GET Post-Match News by Season ID — returns all post-match articles for a specific season:

GET https://api.sportmonks.com/v3/football/news/post-match/seasons/{season_id}

All five endpoints support the fixture, league, and lines includes (include depth: 1). You can filter articles by league using the newsitemLeagues dynamic filter, and paginate using the page and per_page parameters (maximum 50 results per page). The IdAfter static filter is useful for incremental imports, letting you continue fetching from a specific article ID.

What you can build with the News API

Match preview sections pulling expert-written pre-match articles for upcoming fixtures in the Premier League, La Liga, Bundesliga, Serie A, and Champions League to enrich fixture pages.

Post-match report feeds surfacing AI-generated match summaries as soon as results are in, ready to display alongside final scores and statistics.

League news hubs using the newsitemLeagues filter to build a dedicated article feed for a specific competition.

Seasonal article archives using the by-season endpoints to retrieve the full editorial record for a given campaign.

Content-enriched fixture pages combining the fixture and league includes to render articles directly in context alongside live or completed match data.

Availability

The News API is included in all Starter, Growth, Pro, and Enterprise plans. Pre-match coverage is limited to the UEFA Champions League, English Premier League, Spanish La Liga, German Bundesliga, Italian Serie A, and French Ligue 1.

Try it free. All paid plans include a 14-day free trial, and the forever-free plan gives you immediate access to the Danish Superliga and Scottish Premiership with no credit card required.

FAQs about the News API

What is the difference between pre-match and post-match news?
Pre-match articles are expert-written previews published at a minimum of 48 hours before kick-off. Post-match articles are AI-generated reports published immediately after a fixture concludes.
Which leagues are covered by the News API?
Pre-match coverage spans the UEFA Champions League, English Premier League, Spanish La Liga, German Bundesliga, Italian Serie A, and French Ligue 1. Post-match coverage follows the same competitions.
How do I retrieve the full body text of the article?
Use the lines include on any news endpoint. This returns the NewsItemLine entity for each article, where the text field contains the content of each line and the type field indicates its role within the article structure.
Can I filter news articles by league?
Yes. Use the newsitemLeagues dynamic filter alongside the league include to return articles for a specific league or set of leagues. For example: &include=league&filters=newsitemLeagues:8.
Can I paginate through large volumes of articles?
Yes. All news endpoints support pagination via the page and per_page parameters, with a maximum of 50 results per page. Use the IdAfter static filter to continue an import from a specific article ID without re-fetching earlier records.

Written by David Jaja

David Jaja is a technical content manager at Sportmonks, where he makes complex football data easier to understand for developers and businesses. With a background in frontend development and technical writing, he helps bridge the gap between technology and sports data. Through clear, insightful content, he ensures Sportmonks' APIs are accessible and easy to use, empowering developers to build standout football applications