Sports Game Synopsis Generator

Public

API Details

This API generates brief synopses (maximum 100 characters) for each game in an upcoming round of a specified sports league. The synopses are designed to provide quick, engaging previews similar to those found on sports streaming platforms like Kayo Sports. The API takes the league name, round number, and details of each game (including teams, venue, and date) as input and returns concise, attention-grabbing synopses that highlight key aspects or storylines for each matchup.

Request Schema

PropertyTypeRequiredDescription
games
object[]
required
An array of game objects containing details for each matchup
date
string
required
The date of the game (YYYY-MM-DD)
venue
string
required
The name of the venue where the game will be played
awayTeam
string
required
The name of the away team
homeTeam
string
required
The name of the home team
round
integer
required
The round number of the upcoming games
league
string
required
The name of the sports league (e.g., NRL, AFL, NBA)

Response Schema

PropertyTypeRequiredDescription
synopses
object[]
required
An array of synopsis objects, one for each game in the input
game
string
required
A string identifying the game (typically 'Home Team vs Away Team')
synopsis
string
required
A brief, engaging synopsis of the game, maximum 100 characters

API Metadata

ID652
Version
v1
Method
post
Endpoint

/sports-game-synopsis-generator/v1

Tags
sports
synopsis
game preview
brief summary

API Examples

Example Request
{
  "games": [
    {
      "date": "2024-04-05",
      "venue": "Suncorp Stadium",
      "awayTeam": "Melbourne Storm",
      "homeTeam": "Brisbane Broncos"
    },
    {
      "date": "2024-04-06",
      "venue": "Allianz Stadium",
      "awayTeam": "Penrith Panthers",
      "homeTeam": "Sydney Roosters"
    }
  ],
  "round": 5,
  "league": "NRL"
}
Example Response
{
  "synopses": [
    {
      "game": "Brisbane Broncos vs Melbourne Storm",
      "synopsis": "Broncos aim to tame Storm in Friday night blockbuster at Suncorp. Can they break the Melbourne hoodoo?"
    },
    {
      "game": "Sydney Roosters vs Penrith Panthers",
      "synopsis": "Roosters face defending champs Panthers in crucial clash. Will home advantage be key for Sydney?"
    }
  ]
}