Highlightly MLB, NCAA Baseball API (3.1.3)

Download OpenAPI specification:Download

The API provides a standardized way for developers to interact with the service and retrieve MLB, NCAA data. With this API, users can request highlights based on various parameters such as team, match, league, or specific timeframes. The specification defines the endpoints and their corresponding operations, such as retrieving a list of all available highlights, retrieving a specific highlight by its ID, filtering highlights based on specific criteria, and more. The API specification also includes detailed information about the data models used, such as the structure of a highlight object, including properties like title, description, teams involved, players featured, and video URLs. In addition to the basic functionality, the API specification may also include optional features such as pagination for retrieving large result sets, sorting and filtering options, and authentication mechanisms for secure access to the API.

MLB, NCAA Baseball API

Baseball.Highlights

Get all highlights.

Retrieve a list of all highlights.

query Parameters

league	string Example: league=NCAA
date	string Example: date=2024-03-06 Date that follows the YYYY-MM-DD format.
timezone	string Default: "Etc/UTC" Example: timezone=Europe/London Valid timezone identifier.
season	number Example: season=2024
matchId	number Example: matchId=394
homeTeamId	number Example: homeTeamId=219
awayTeamId	number Example: awayTeamId=302
homeTeamName	string Example: homeTeamName=Bears
awayTeamName	string Example: awayTeamName=Patriots
homeTeamAbbreviation	string Example: homeTeamAbbreviation=BAY
awayTeamAbbreviation	string Example: awayTeamAbbreviation=DBU
homeTeamDisplayName	string Example: homeTeamDisplayName=Baylor
awayTeamDisplayName	string Example: awayTeamDisplayName=Dallas Baptist
limit	number [ 0 .. 40 ] Default: 40 Example: limit=40
offset	number >= 0 Default: 0

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"id": 27,
"type": "VERIFIED",
"imgUrl": "https://example.com/images/preview/27.png",
"title": "NCAA: Bears vs Patriots",
"description": "Tom Poole sends one deep to right to give Dallas Baptist an insurance run over Baylor.",
"url": "https://example.com/highlight/v23r23fds2cff",
"embedUrl": "https://example.com/embed/v23r23fds2cff",
"match": {"id": 394,
"round": "regular-season",
"date": "2024-03-06T00:30:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY"
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY"
}
},
"channel": "MLB",
"source": "youtube"
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Get geo restrictions for highlight.

Retrieve applied geo restrictions to the given highlight id.

path Parameters

id

required

number

Example: 44

Requested higlight id.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"state": "Allowed countries restriction",
"allowedCountries": ["IT"
],
"blockedCountries": [ ],
"embeddable": true
}

Get highlight by id.

Retrieve highlight details by highlight id.

path Parameters

id

required

number

Example: 27

Requested highlight id.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 27,
"type": "VERIFIED",
"imgUrl": "https://example.com/images/preview/27.png",
"title": "NCAA: Bears vs Patriots",
"description": "Tom Poole sends one deep to right to give Dallas Baptist an insurance run over Baylor.",
"url": "https://example.com/highlight/v23r23fds2cff",
"embedUrl": "https://example.com/embed/v23r23fds2cff",
"match": {"id": 394,
"round": "regular-season",
"date": "2024-03-06T00:30:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY"
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY"
}
},
"channel": "MLB",
"source": "youtube"
}
]

Baseball.Matches

Get all matches.

Retrieve a list of all matches.

query Parameters

league	string Example: league=NCAA
date	string Example: date=2024-03-06 Date that follows the YYYY-MM-DD format.
timezone	string Default: "Etc/UTC" Example: timezone=Europe/London Valid timezone identifier.
season	number Example: season=2024
homeTeamId	number Example: homeTeamId=219
awayTeamId	number Example: awayTeamId=302
homeTeamName	string Example: homeTeamName=Bears
awayTeamName	string Example: awayTeamName=Patriots
homeTeamAbbreviation	string Example: homeTeamAbbreviation=BAY
awayTeamAbbreviation	string Example: awayTeamAbbreviation=DBU
homeTeamDisplayName	string Example: homeTeamDisplayName=Baylor
awayTeamDisplayName	string Example: awayTeamDisplayName=Dallas Baptist
limit	number [ 0 .. 100 ] Default: 100 Example: limit=100
offset	number >= 0 Default: 0

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"id": 394,
"round": "regular-season",
"date": "2024-03-06T00:30:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"state": {"description": "Finished",
"report": "Final",
"score": {"home": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"away": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"current": "5 - 8"
}
}
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Get match by id.

Retrieve match details by match id.

path Parameters

id

required

number

Example: 47299

Requested match id.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 58348,
"round": "regular-season",
"date": "2024-03-31T17:00:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"state": {"description": "Finished",
"report": "Final",
"score": {"home": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"away": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"current": "5 - 8"
}
},
"venue": {"city": "Waco",
"name": "Baylor Ballpark",
"state": "Texas"
},
"stats": {"homeTeam": [{"batting": [{"value": 8,
"displayName": "Strikeouts"
}
],
"fielding": [null
],
"pitching": [null
]
}
],
"awayTeam": [{"batting": [{"value": 8,
"displayName": "Strikeouts"
}
],
"fielding": [null
],
"pitching": [null
]
}
]
},
"plays": [{"type": "Start Inning",
"teamId": 229,
"description": "Top of the 1st inning",
"currentOuts": 0,
"period": "Top 1st Inning",
"pitch": {"type": "CURVE",
"velocity": 78.2,
"ballsCount": 0,
"strikesCount": 0
},
"result": {"ballsCount": 1,
"strikesCount": 2
},
"score": {"away": 1,
"home": 2
}
}
],
"referees": [{"name": "Jonathan Parra",
"position": "Home Plate Umpire"
}
],
"rosters": {"awayTeam": {"jersey": 1,
"fullName": "Hunter Hines",
"position": "First Baseman",
"isStarter": true
},
"homeTeam": {"jersey": 1,
"fullName": "Hunter Hines",
"position": "First Baseman",
"isStarter": true
}
},
"forecast": {"status": "cloudy",
"temperature": "11.97°C"
}
}
]

Baseball.Teams

Get all teams.

Retrieve a list of all teams.

query Parameters

league	string Example: league=NCAA
name	string Example: name=Bears
displayName	string Example: displayName=Baylor
abbreviation	string Example: abbreviation=BAY

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"league": "NCAA",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Get team by id.

Retrieve team details by team id.

path Parameters

id

required

number

Example: 219

Requested team id.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"league": "NCAA",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
}
]

Baseball.Standings

Get standings list.

Retrieve a list of all standings based on passed query parameters.

query Parameters

leagueType	string Enum: "MLB" "NCAA" Example: leagueType=MLB
limit	number [ 0 .. 10 ] Default: 10 Example: limit=5
offset	number >= 0 Default: 0
leagueName	string Example: leagueName=National League (MLB)
abbreviation	string Example: abbreviation=NL
year	number Example: year=2024

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"leagueName": "Cactus League (MLB)",
"abbreviation": "CAC",
"year": 2024,
"leagueType": "MLB",
"seasonType": "Spring Training",
"startDate": "2024-02-15T08:00:00.000Z",
"endDate": "2024-03-27T06:59:00.000Z",
"data": [{"id": 58,
"logo": "https://example.com/baseball/images/teams/58.png",
"name": "Dodgers",
"stats": [{"description": "Number of Overtime Losses",
"abbreviation": "OTL",
"displayValue": "0"
}
]
}
]
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Baseball.Odds

Get a list of odds.

Retrieve a list of all odds based on passed query parameters. At least one parameter has to be specified.

query Parameters

leagueName	string Example: leagueName=NCAA
timezone	string Default: "Etc/UTC" Example: timezone=Europe/London Valid timezone identifier.
bookmakerId	number Example: bookmakerId=53
limit	number [ 0 .. 5 ] Default: 5 Example: limit=5
offset	number >= 0 Default: 0
matchId	number Example: matchId=394
bookmakerName	string Example: bookmakerName=Megapari Sport
date	string Example: date=2024-03-06 Date that follows the YYYY-MM-DD format.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"matchId": 394,
"odds": [{"bookmakerId": 53,
"bookmakerName": "Megapari Sport",
"type": "prematch",
"market": "Odd or Even",
"values": [{"odd": 2.8,
"value": "Home"
}
]
}
]
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Baseball.Bookmakers

Get a list of available bookmakers.

Retrieve a list of all bookmakers based on passed query parameters.

query Parameters

name	string Example: name=Megapari Sport
limit	number [ 0 .. 100 ] Default: 20 Example: limit=20
offset	number >= 0 Default: 0

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

{"data": [{"id": 53,
"name": "Megapari Sport"
}
],
"pagination": {"totalCount": 490,
"offset": 20,
"limit": 100
},
"plan": {"tier": "BASIC",
"message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
}
}

Get bookmaker by id.

Retrieve bookmaker details by bookmaker id.

path Parameters

id

required

number

Example: 53

Requested bookmaker id.

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 53,
"name": "Megapari Sport"
}
]

Baseball.Last Five Games

Get last five games for specific team id.

Retrieve a list of last five games played for given team id.

query Parameters

teamId

required

number

Example: teamId=42

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 394,
"round": "regular-season",
"date": "2024-03-06T00:30:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"state": {"description": "Finished",
"report": "Final",
"score": {"home": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"away": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"current": "5 - 8"
}
}
}
]

Baseball.Head 2 Head

Get head 2 head data for a specific set of teams.

Retrieve a list of head 2 head games played for given team ids.

query Parameters

teamIdOne required	number Example: teamIdOne=42
teamIdTwo required	number Example: teamIdTwo=52

header Parameters

x-rapidapi-host required	string mlb-college-baseball-api.p.rapidapi.com
x-rapidapi-key required	string Rapid API Token

Responses

Response samples

200
400
500

Content type

application/json

[{"id": 394,
"round": "regular-season",
"date": "2024-03-06T00:30:00.000Z",
"league": "NCAA",
"season": 2024,
"awayTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"homeTeam": {"id": 219,
"logo": "https://example.com/logos/team/219.png",
"name": "Bears",
"displayName": "Baylor",
"abbreviation": "BAY",
"records": {"home": {"wins": 2,
"losses": 6
},
"away": {"wins": 2,
"losses": 3
},
"total": {"wins": 4,
"losses": 9
}
}
},
"state": {"description": "Finished",
"report": "Final",
"score": {"home": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"away": {"hits": 4,
"errors": 2,
"innings": [0,
0,
1,
1,
0,
0,
1,
1,
1
]
},
"current": "5 - 8"
}
}
}
]