Post-match News

Our Post-Match news offers Match recaps are AI written in collaboration with United Robots, a renowned AI news provider. The articles are based on match results, goals, injuries, and other important events. They are available instantly after the final whistle.

You can choose a two endpoints to retrieve the Post-match News.

An overview of all available options:

GET Post-Match News: returns all the Post-Match News articles available within your subscription.
GET Post-Match News by Season ID: returns the all the Post-Match news articles from your requested season id.

For all the Post-Match News endpoints the base URL is the same:

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

Per endpoint the rest of the URL requires additional information. We will explain this per endpoint.

Requesting Post-Match News

GET Post-Match News

The first option is to request all the post-match articles available in your subscription. The URL to retrieve all these articles is the same as the base URL for post-match news. All you have to do is authorize the request with your API token. Check our authentication section for more info.

https://api.sportmonks.com/v3/football/news/postmatch?api_token=YOUR_TOKEN

Response

{
  "data": [
    {
      "id": 2887,
      "fixture_id": 18841653,
      "league_id": 8,
      "title": "Jarrod Bowen and Kurt Zouma won the match for West Ham against Luton",
      "type": "postmatch"
    },
    {
      "id": 2888,
      "fixture_id": 18841655,
      "league_id": 8,
      "title": "Sheffield United and Everton drew 2-2",
      "type": "postmatch"
    },
    {
      "id": 2889,
      "fixture_id": 18841648,
      "league_id": 8,
      "title": "Evan Ferguson behind Brighton's win over Newcastle",
      "type": "postmatch"
    },
    {
      "id": 2890,
      "fixture_id": 18841654,
      "league_id": 8,
      "title": "Erling Haaland unstoppable as Manchester City beat Fulham",
      "type": "postmatch"
    },

In the response, you will see the unique id of the article, the fixture its related to and the league its related to. Furthermore, you will see the title of the specific article and the type of the article, which is either "prematch" or "postmatch".

Interested in adding extra information to the response? Check our adding useful information section

GET Post-Match News by Season ID

The GET Post-Match News by Season ID is the most commonly used endpoint to return all the post-match articles from the requested season ID. So, how do you request all of this data yourself? We’re going to show you how!

This section will show you how to request articles for the Champions League season 2023/2024 (season id: 21638). You will need to add the season_id parameters to your request.

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

This will result in the following request:

https://api.sportmonks.com/v3/football/news/post-match/seasons/21638?api_token=YOUR_TOKEN

Response

{
  "data": [
    {
      "id": 4099,
      "fixture_id": 19101797,
      "league_id": 2,
      "title": "Real Madrid's unbeaten run extended after 2-2 to FC Bayern München",
      "type": "postmatch"
    },
    {
      "id": 4103,
      "fixture_id": 19101795,
      "league_id": 2,
      "title": "1-0 win for Borussia Dortmund over Paris Saint Germain – Füllkrug was the hero",
      "type": "postmatch"
    }

As you can see, the response is an will retrieve all the articles for that specific Champions League season.

Adding useful information

Now, you might have noticed that the API returns only the necessary information. But you will still need the actual, written article. Or if you’re interested in more details? You can use certain includes for this.

Check the endpoint page for a complete overview of the available includes.

Let’s say you want the Post-Match articles of the Champions League 2023/2024 season, but this time with the actual written article and fixture information. As you’ve learnt earlier, your request is:

https://api.sportmonks.com/v3/football/news/post-match/seasons/21638?api_token=YOUR_TOKEN

Now, you can add the lines and fixture includes for more info:

https://api.sportmonks.com/v3/football/news/post-match/seasons/21638?api_token=YOUR_TOKEN&include=lines;fixture

Response

{
  "data": [
    {
      "id": 4099,
      "fixture_id": 19101797,
      "league_id": 2,
      "title": "Real Madrid's unbeaten run extended after 2-2 to FC Bayern München",
      "type": "postmatch",
      "lines": [
        {
          "id": 15283,
          "newsitem_id": 4099,
          "text": "The game was the fourth in a row without a win for Real Madrid.",
          "type": "line"
        },
        {
          "id": 15284,
          "newsitem_id": 4099,
          "text": "FC Bayern München have now won two, drawn two and lost one of their last five games having scored 8 and conceded five. Meanwhile Real Madrid have one win and four draws with 8 goals for and 7 against.",
          "type": "line"
        },
        {
          "id": 15280,
          "newsitem_id": 4099,
          "text": "Real Madrid enjoyed a great game in the Champions League and their 11th game in a row without defeat came away to FC Bayern München. The game finished 2-2.",
          "type": "line"
        },
        {
          "id": 15281,
          "newsitem_id": 4099,
          "text": "The visiting team FC Bayern München took an early lead when Vinicius Junior  netted after 24 minutes, with an assist by Toni Kroos, making it 1-0.",
          "type": "line"
        },
        {
          "id": 15282,
          "newsitem_id": 4099,
          "text": "Straight after the break, Leroy Sané made his mark and equalised for FC Bayern München.",
          "type": "line"
        },

Filtering

Let’s continue with the another example. You've used the GET Post-Match News endpoint. You now have included the lines in the response, but you’re only interested in the articles for the Premier League (ID: 8). You can filter for that league via the filter option:

https://api.sportmonks.com/v3/football/news/post-match?api_token=YOUR_TOKEN&include=lines;league&filters=newsitemLeagues:8

Response


  "data": [
    {
      "id": 2796,
      "fixture_id": 18841626,
      "league_id": 8,
      "title": "Aston Villa took command from the start against Everton",
      "type": "postmatch",
      "lines": [
        {
          "id": 9382,
          "newsitem_id": 2796,
          "text": "Aston Villa were in control from the first to final whistle in the Premier League game against Everton on Sunday. They increased their lead in the second half and in the end won 4-0.",
          "type": "line"
        },
        {
          "id": 9386,
          "newsitem_id": 2796,
          "text": "Aston Villa further increased the lead as Jhon Durán found the net in the 75th minute.",
          "type": "line"
        },
        {
          "id": 9387,
          "newsitem_id": 2796,
          "text": "With this victory, Aston Villa have got their first win of the season, while Everton are on a run of two straight defeats. Both teams have played two games.",
          "type": "line"
        },
        {
          "id": 9388,
          "newsitem_id": 2796,
          "text": "The previous meeting between the teams ended in a 2-0 away win for Aston Villa in February.",
          "type": "line"
        },
        {
          "id": 9383,
          "newsitem_id": 2796,
          "text": "Aston Villa scored the first goal when John McGinn netted after 18 minutes, with an assist by Leon Bailey, making it 1-0.",
          "type": "line"
        },
        {
          "id": 9384,
          "newsitem_id": 2796,
          "text": "In the 24th minute Douglas Luiz increased the lead for Aston Villa.",
          "type": "line"
        },
        {
          "id": 9385,
          "newsitem_id": 2796,
          "text": "Straight after the break, Leon Bailey made his mark and increased the team's lead.",
          "type": "line"
        },
        {
          "id": 9389,
          "newsitem_id": 2796,
          "text": "Aston Villa next Premier League games are against Burnley (away) on 27 August, Liverpool (away) on 3 September and Crystal Palace (home) on 16 September. Everton play Wolverhampton (home) on 26 August, Sheffield United (away) on 2 September and Arsenal (home) on 16 September.",
          "type": "line"
        },
        {
          "id": 9390,
          "newsitem_id": 2796,
          "text": "Elsewhere in the Premier League Nottingham Forest picked up a narrow 2-1 victory against Sheffield United, Brentford defeated 3-0 Fulham, Liverpool won 3-1 against Bournemouth, Brighton won 4-1 against Wolverhampton, Tottenham won 2-0 against Manchester United, Manchester City won 1-0 against Newcastle and West Ham won 3-1 against Chelsea.",
          "type": "line"
        }
      ],
      "league": {
        "id": 8,
        "sport_id": 1,
        "country_id": 462,
        "name": "Premier League",
        "active": true,
        "short_code": "UK PL",
        "image_path": "https://cdn.sportmonks.com/images/soccer/leagues/8/8.png",
        "type": "league",
        "sub_type": "domestic",
        "last_played_at": "2024-05-06 19:00:00",
        "category": 1,
        "has_jerseys": false
      }

Check our selecting and filtering tutorial for more information.

PreviousPre-match News NextPlaceholders

Last updated 1 year ago

Was this helpful?