Flashscore match commentary API

Use the Flashscore match commentary API to retrieve sports records, event timing and published text as structured JSON from Flashscore. Supply event identifier in the query. Use these results to reconstruct the sequence of play and examine the moments behind changes in a match score. The documented source-page link form identifies the requested entry directly and lets you reuse an existing source-page reference. The detail page includes parameter definitions, paired request and response examples, and usage pricing for this operation.

Selected price
$0.002 / billing creditPublished pricing
Sellers / implementations
1 / 1
Requests · 30d
—Loading...
Success rate · 30d
—Loading...

Run sends a real API request. Charges follow the published API contract.

Request parameters
Flashscore match id or a match link (flashscore.com/match/YceoIxQh/ or .../?mid=YceoIxQh). YceoIxQh = Newcastle v Everton, Premier League, 2 Nov 2026.
Optional parameters (5)
0 leaves out the bulky `raw` source blocks (often 10-30x smaller).
Comma-separated fields to return, e.g. `posts.id,posts.title`. Call metadata is always included.
1 skips the 24-hour cache and fetches live.
JSON only for this OpenAny product. Omit output or use json; CSV and NDJSON are not supported.
With output=csv|ndjson: the top-level list to turn into rows (e.g. `reviews`), or `.` for the whole object as one row.

Sample response

{
  "cached": false,
  "count": 78,
  "credits_used": 1,
  "fetched_at": "2026-11-19T12:21:39.611Z",
  "items": [
    {
      "clock": "90:00 +9:22",
      "important": false,
      "minute": "90+10'",
      "text": "John Brooks is looking at his watch and immediately ends this match.",
      "type": "whistle"
    },
    {
      "clock": "90:00 +8:30",
      "important": false,
      "minute": "90+9'",
      "text": "That will be a yellow card for one of the players. The one who gets booked is Fabian Schar (Newcastle Utd).",
      "type": "y-card"
    },
    {
      "clock": "90:00 +8:20",
      "important": false,
      "minute": "90+9'",
      "text": "Brennan Johnson (Everton) is cautioned by the referee.",
      "type": "y-card"
    },
    {
      "clock": "90:00 +7:45",
      "important": true,
      "minute": "90+8'",
      "text": "This was really stupid from Jacob Ramsey (Newcastle Utd)! He is booked for the second time today and is forced to leave the pitch after seeing a red card in the hand of John Brooks.",
      "type": "yr-card"
    },
    {
      "clock": "90:00 +6:00",
      "important": false,
      "minute": "90+6'",
      "text": "Jacob Ramsey (Newcastle Utd) is awarded a yellow card for his behaviour.",
      "type": "y-card"
    },
    {
      "clock": "90:00 +2:00",
      "important": false,
      "minute": "90+2'",
      "text": "Here is a change. Tyrique George is going off and David Moyes gives the last tactical orders to Hayden Hackney (Everton).",
      "type": "substitution"
    },
    {
      "clock": "90:00 +1:36",
      "important": false,
      "minute": "90+2'",
      "text": "Fabian Schar (Newcastle Utd) receives a lofted pass in the goal area and unleashes a dangerous header which sails narrowly wide of the left post!",
      "type": null
    },
    {
      "clock": "90:00 +0:55",
      "important": false,
      "minute": "90+1'",
      "text": "The resulting set piece from Newcastle is comfortably intercepted by one of the defending players.",
      "type": "corner"
    },
    {
      "clock": "90:00",
      "important": false,
      "minute": "90'",
      "text": "We will have 8 min. of added time.",
      "type": "time"
    },
    {
      "clock": "89:30",
      "important": true,
      "minute": "90'",
      "text": "Yoane Wissa (Newcastle Utd) had time and space inside the box after picking up a neat pass, but his shot low towards the middle of the goal was comfortably saved by Jordan Pickford.",
      "type": null
    },
    {
      "clock": "88:30",
      "important": false,
      "minute": "89'",
      "text": "Everton can’t profit from the corner as the defence clear the ball upfield.",
      "type": "corner"
    },
    {
      "clock": "86:42",
      "important": false,
      "minute": "87'",
      "text": "Substitution. Bazoumana Toure (Newcastle Utd) in, Amar Dedic out.",
      "type": "substitution"
    },
    {
      "clock": "85:00",
      "important": false,
      "minute": "85'",
      "text": "That didn't go as planned! Yoane Wissa (Newcastle Utd) tried his luck from the edge of the box, but his effort low towards the middle of the goal was too weak to get past Jordan Pickford, who easily kept it out.",
      "type": null
    },
    {
      "clock": "83:30",
      "important": false,
      "minute": "84'",
      "text": "William Osula (Newcastle Utd) jumps high after collecting a perfect cross and strikes with a bullet header! His effort goes miles wide of the goal. Poor header!",
      "type": null
    },
    {
      "clock": "83:13",
      "important": false,
      "minute": "84'",
      "text": "Flag goes up against Brennan Johnson (Everton) and the referee blows his whistle for offside.",
      "type": null
    },
    {
      "clock": "81:45",
      "important": false,
      "minute": "82'",
      "text": "David Moyes decides to make a substitution. Jarrad Branthwaite will be replaced by Michael Keane (Everton).",
      "type": "substitution"
    },
    {
      "clock": "79:45",
      "important": false,
      "minute": "80'",
      "text": "Here comes a substitution. Thierno Barry is given a rest as he is replaced by Brennan Johnson (Everton).",
      "type": "substitution"
    },
    {
      "clock": "78:45",
      "important": true,
      "minute": "79'",
      "text": "Jacob Ramsey (Newcastle Utd) releases a superb dipping volley at goal from the edge of the box that flies just wide of the left post.",
      "type": null
    },
    {
      "clock": "75:03",
      "important": false,
      "minute": "76'",
      "text": "Matthias Jaissle prepares a substitution. Anthony Elanga is replaced by Jacob Murphy (Newcastle Utd).",
      "type": "substitution"
    },
    {
      "clock": "74:37",
      "important": false,
      "minute": "75'",
      "text": "The substitution is prepared. Jacob Ramsey (Newcastle Utd) joins the action as a substitute, replacing Joelinton.",
      "type": "substitution"
    },
    {
      "clock": "72:33",
      "important": false,
      "minute": "73'",
      "text": "David Moyes is stunned as referee John Brooks shows him a yellow card. What was that for?",
      "type": "y-card"
    },
    {
      "clock": "66:20",
      "important": false,
      "minute": "67'",
      "text": "Amar Dedic (Newcastle Utd) attempts to surprise the keeper with a shot from distance, but it lacks accuracy and goes high over the crossbar.",
      "type": null
    },
    {
      "clock": "66:00",
      "important": false,
      "minute": "66'",
      "text": "A corner kick by Newcastle is thwarted by the well prepared Jordan Pickford (Everton).",
      "type": "corner"
    },
    {
      "clock": "65:17",
      "important": false,
      "minute": "66'",
      "text": "Fabian Schar (Newcastle Utd) shoots from outside the box, but his effort is blocked. The ball is out of play. A goal-scoring opportunity from a corner for Newcastle.",
      "type": null
    },
    {
      "clock": "65:10",
      "important": true,
      "minute": "66'",
      "text": "Anthony Elanga (Newcastle Utd) squanders a golden opportunity after striking the ball onto the post of the goal!",
      "type": null
    },
    {
      "clock": "63:48",
      "important": false,
      "minute": "64'",
      "text": "Matthias Jaissle has decided to make a change. Sean Steur (Newcastle Utd) replaces Nico.",
      "type": "substitution"
    },
    {
      "clock": "63:37",
      "important": false,
      "minute": "64'",
      "text": "A substitution has been made. Joe Willock goes off and Yoane Wissa (Newcastle Utd) comes on.",
      "type": "substitution"
    },
    {
      "clock": "62:54",
      "important": false,
      "minute": "63'",
      "text": "James Garner (Everton) tries his luck with a shot, but his effort goes wide of the target.",
      "type": null
    },
    {
      "clock": "62:45",
      "important": false,
      "minute": "63'",
      "text": "Everton force a corner. They send men into the box.",
      "type": "corner"
    },
    {
      "clock": "62:25",
      "important": true,
      "minute": "63'",
      "text": "Jake O'Brien (Everton) rises highest from the corner to head at goal, but his effort towards the right side of the goal is brilliantly kept out by the goalkeeper.",
      "type": null
    },
    {
      "clock": "61:59",
      "important": false,
      "minute": "62'",
      "text": "The ball goes out of play. Everton are awarded a corner kick.",
      "type": "corner"
    },
    {
      "clock": "61:42",
      "important": false,
      "minute": "62'",
      "text": "The goalkeeper pulls off a great save to deny Kiernan Dewsbury-Hall (Everton), whose effort would probably have ended in the roof of the net.",
      "type": null
    },
    {
      "clock": "59:56",
      "important": false,
      "minute": "60'",
      "text": "Fabian Schar (Newcastle Utd) watches the ball all the way and connects well with a volley on the edge of the box, but sends the effort miles over the bar.",
      "type": null
    },
    {
      "clock": "59:40",
      "important": false,
      "minute": "60'",
      "text": "Fabian Schar (Newcastle Utd) fires a shot at goal from a very promising position outside the penalty area, but it is blocked by a self-sacrificing defender.",
      "type": null
    },
    {
      "clock": "57:30",
      "important": false,
      "minute": "58'",
      "text": "Anthony Elanga (Newcastle Utd) fires a powerful shot which is blocked.",
      "type": null
    },
    {
      "clock": "55:38",
      "important": false,
      "minute": "56'",
      "text": "Everton take the corner, but their hopes of scoring a goal end with a nice clearance by the defence.",
      "type": "corner"
    },
    {
      "clock": "54:30",
      "important": true,
      "minute": "55'",
      "text": "Jarrad Branthwaite (Everton) attempts to convert a lofted cross as he jumps high and heads the ball towards the roof of the net. Lukas Hornicek shows his brilliant reflexes and pulls off a glorious save to stop the ball from hitting the net. Everton will take a corner kick.",
      "type": null
    },
    {
      "clock": "54:20",
      "important": false,
      "minute": "55'",
      "text": "Everton work the corner short. The ball is passed to a nearby teammate.",
      "type": "corner"
    },
    {
      "clock": "52:30",
      "important": false,
      "minute": "53'",
      "text": "Fabian Schar (Newcastle Utd) seems to be alright and is okay to carry on.",
      "type": null
    },
    {
      "clock": "52:00",
      "important": false,
      "minute": "52'",
      "text": "The booking goes to Tyrique George (Everton).",
      "type": "y-card"
    },
    {
      "clock": "50:30",
      "important": true,
      "minute": "51'",
      "text": "Wait! Referee John Brooks has indicated he is going to review the Everton goal using VAR. It’s probably to see if there was an offside in the build-up.",
      "type": "var"
    },
    {
      "clock": "49:30",
      "important": false,
      "minute": "50'",
      "text": "Looks like Fabian Schar (Newcastle Utd) is struggling after picking up a knock. Hopefully he can run it off.",
      "type": "injury"
    },
    {
      "clock": "48:49",
      "important": false,
      "minute": "49'",
      "text": "Goal 0:1! Thierno Barry (Everton) taps home from close range after the rebound fell kindly into his path.",
      "type": "soccer-ball"
    },
    {
      "clock": "48:30",
      "important": false,
      "minute": "49'",
      "text": "Tyrique George (Everton) had a golden opportunity. He volleyed from point blank range towards the bottom right corner, but Lukas Hornicek was alert and made an amazing save!",
      "type": null
    },
    {
      "clock": "47:28",
      "important": false,
      "minute": "48'",
      "text": "The attendance is 52279.",
      "type": "attendance"
    },
    {
      "clock": "45:01",
      "important": false,
      "minute": "46'",
      "text": "The second half gets underway.",
      "type": "whistle"
    },
    {
      "clock": "45:00 +2:37",
      "important": false,
      "minute": "45+3'",
      "text": "The referee blows his whistle for half-time, bringing to a close the first 45 minutes of the match.",
      "type": "whistle"
    },
    {
      "clock": "45:00 +2:20",
      "important": false,
      "minute": "45+3'",
      "text": "Harrison Armstrong (Everton) receives the ball in the penalty box and immediately fires a first-time effort that sails well wide of the right post.",
      "type": null
    },
    {
      "clock": "45:00 +1:09",
      "important": false,
      "minute": "45+2'",
      "text": "Jake O'Brien (Everton) receives a lofted pass in the goal area and unleashes a dangerous header which sails narrowly wide of the right post!",
      "type": null
    },
    {
      "clock": "45:00 +0:30",
      "important": false,
      "minute": "45+1'",
      "text": "Lewis Hall (Newcastle Utd) is able to continue to play.",
      "type": null
    },
    {
      "clock": "45:00",
      "important": false,
      "minute": "45'",
      "text": "There will be a minimum of 2 min. of added time.",
      "type": "time"
    },
    {
      "clock": "43:29",
      "important": false,
      "minute": "44'",
      "text": "Lewis Hall (Newcastle Utd) requires medical treatment, so the referee stops play and signals for the physio to come onto the pitch.",
      "type": "injury"
    },
    {
      "clock": "43:20",
      "important": false,
      "minute": "44'",
      "text": "Kiernan Dewsbury-Hall (Everton) decides to strike the ball towards goal, but his effort fails to threaten the goalkeeper after being blocked by one of the defenders.",
      "type": null
    },
    {
      "clock": "39:56",
      "important": false,
      "minute": "40'",
      "text": "That was close by Joelinton (Newcastle Utd)! He receives a pass on the edge of the box and shoots, but the ball goes inches wide of the right post.",
      "type": null
    },
    {
      "clock": "37:48",
      "important": false,
      "minute": "38'",
      "text": "A good clearance by a defender means the corner comes to nothing for Newcastle.",
      "type": "corner"
    },
    {
      "clock": "37:00",
      "important": false,
      "minute": "37'",
      "text": "Harvey Barnes (Newcastle Utd) unleashes a bullet of a shot that is blocked by a defender. The ball goes out of play. Newcastle are awarded a corner kick.",
      "type": null
    },
    {
      "clock": "33:36",
      "important": false,
      "minute": "34'",
      "text": "James Garner (Everton) takes the resulting free kick from the edge of the box, but it's blocked by the players standing in the wall, saving the goalkeeper a lot of effort.",
      "type": null
    },
    {
      "clock": "32:10",
      "important": false,
      "minute": "33'",
      "text": "Everton earn a free kick which could lead to a goal-scoring opportunity.",
      "type": null
    },
    {
      "clock": "31:50",
      "important": false,
      "minute": "32'",
      "text": "Dan Burn (Newcastle Utd) can't expect anything else than a yellow card for his hard tackle. And a yellow it is. John Brooks didn't think twice about pulling it out of his pocket.",
      "type": "y-card"
    },
    {
      "clock": "29:34",
      "important": false,
      "minute": "30'",
      "text": "Joe Willock (Newcastle Utd) decides to strike the ball towards goal, but his effort fails to threaten the goalkeeper after being well blocked by one of the defenders.",
      "type": null
    },
    {
      "clock": "27:27",
      "important": false,
      "minute": "28'",
      "text": "Jake O'Brien (Everton) sends a cross into the box, but the opposition's defence clears the ball away to eliminate the danger.",
      "type": null
    },
    {
      "clock": "25:21",
      "important": false,
      "minute": "26'",
      "text": "What a poor attempt! Tyrique George (Everton) drives another shot towards goal - this time from further out, but it couldn't have been worse if he had shot blindfolded. The ball goes miles wide to the right.",
      "type": null
    },
    {
      "clock": "20:30",
      "important": false,
      "minute": "21'",
      "text": "Merlin Rohl (Everton) gets to the ball in the penalty box and immediately fires a first-time effort. He didn't hit the ball properly and skies it high over the crossbar.",
      "type": null
    },
    {
      "clock": "16:46",
      "important": false,
      "minute": "17'",
      "text": "The corner is swung in and Dan Burn (Newcastle Utd) leaps above the defence only to send his header a whisker wide of the left post from close in.",
      "type": null
    },
    {
      "clock": "16:00",
      "important": false,
      "minute": "16'",
      "text": "The referee points to the corner flag. It's a corner to Newcastle.",
      "type": "corner"
    },
    {
      "clock": "16:00",
      "important": false,
      "minute": "16'",
      "text": "Joelinton (Newcastle Utd) takes a shot from the edge of the box, but it's not a big threat for the goalkeeper as his effort is blocked by a defender.",
      "type": null
    },
    {
      "clock": "14:29",
      "important": false,
      "minute": "15'",
      "text": "James Garner (Everton) clearly holds his opponent to prevent him from getting the ball and the referee immediately stops play.",
      "type": null
    },
    {
      "clock": "10:40",
      "important": false,
      "minute": "11'",
      "text": "Half-chance! William Osula (Newcastle Utd) plays a pass into the box, but Jordan Pickford reacts well to snuff out the attack.",
      "type": null
    },
    {
      "clock": "7:40",
      "important": false,
      "minute": "8'",
      "text": "Kiernan Dewsbury-Hall (Everton) unleashes a shot, but it's well wide of the right-hand post.",
      "type": null
    },
    {
      "clock": "5:44",
      "important": false,
      "minute": "6'",
      "text": "Thierno Barry (Everton) is adjudged to have been offside when making his run.",
      "type": null
    },
    {
      "clock": "4:30",
      "important": false,
      "minute": "5'",
      "text": "James Garner (Everton) smashes the ball with a volley from the edge of the box, but his poor attempt goes miles wide of the left post.",
      "type": null
    },
    {
      "clock": "4:27",
      "important": false,
      "minute": "5'",
      "text": "Jake O'Brien (Everton) produces a lovely ball into the penalty area but the defender manages to intercept and comfortably averts the danger.",
      "type": null
    },
    {
      "clock": "3:17",
      "important": false,
      "minute": "4'",
      "text": "Tyrique George (Everton) whips a promising cross into the box, but the opposition's defence intercepts the ball.",
      "type": null
    },
    {
      "clock": "0:01",
      "important": false,
      "minute": "1'",
      "text": "Today's match has just started, enjoy the game!",
      "type": "whistle"
    },
    {
      "clock": "'",
      "important": false,
      "minute": "",
      "text": "The players are out at last! Everton will take the kick-off.",
      "type": null
    },
    {
      "clock": "'",
      "important": false,
      "minute": "",
      "text": "The referee of today's match will be John Brooks.",
      "type": null
    },
    {
      "clock": "'",
      "important": false,
      "minute": "",
      "text": "The starting lineups for this match have been revealed.",
      "type": "lineup1"
    },
    {
      "clock": "'",
      "important": false,
      "minute": "",
      "text": "Welcome to our live text commentary, ladies and gentlemen! The starting lineups will be announced very soon, so just sit back and get ready to enjoy the action.",
      "type": null
    }
  ],
  "match_id": "YceoIxQh"
}

Response result

Response structure

Inferred from examples
  • cachedboolean
  • countinteger
  • credits_usedinteger
  • fetched_atstring
  • itemsobject[]
    • clockstring
    • importantboolean
    • minutestring
    • textstring
    • typestring | null
  • match_idstring

Common questions

Do I need a separate key for every provider?

Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.

Are these providers interchangeable?

No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.

How is this API billed?

API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.

Where do the price and contract come from?

The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.

How do OpenAny Balance and x402 differ?

OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.

Does Playground send a paid request?

Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.

Use Flashscore match commentary API with your agent

Inspect endpoint contracts and confirm availability and pricing before a paid call.