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
| Property | Type | Required | Description |
|---|---|---|---|
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
| Property | Type | Required | Description |
|---|---|---|---|
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?"
}
]
}