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.
Retrieve a list of all highlights.
league | object Example: league=NCAA |
date | object Example: date=2024-03-06 Date that follows the YYYY-MM-DD format. |
timezone | object Default: "Etc/UTC" Example: timezone=Europe/London Valid timezone identifier. |
season | object Example: season=2024 |
matchId | object Example: matchId=394 |
homeTeamId | object Example: homeTeamId=219 |
awayTeamId | object Example: awayTeamId=302 |
homeTeamName | object Example: homeTeamName=Bears |
awayTeamName | object Example: awayTeamName=Patriots |
homeTeamAbbreviation | object Example: homeTeamAbbreviation=BAY |
awayTeamAbbreviation | object Example: awayTeamAbbreviation=DBU |
homeTeamDisplayName | object Example: homeTeamDisplayName=Baylor |
awayTeamDisplayName | object Example: awayTeamDisplayName=Dallas Baptist |
limit | object [ 0 .. 40 ] Default: 40 |
offset | object >= 0 Default: 0 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "data": [
- {
- "id": 27,
- "type": "VERIFIED",
- "title": "NCAA: Bears vs Patriots",
- "description": "Tom Poole sends one deep to right to give Dallas Baptist an insurance run over Baylor.",
- "match": {
- "id": 394,
- "round": "regular-season",
- "date": "2024-03-06T00:30:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "name": "Bears",
- "displayName": "Baylor",
- "abbreviation": "BAY"
}, - "homeTeam": {
- "id": 219,
- "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"
}
}
Retrieve applied geo restrictions to the given highlight id.
id required | number Example: 44 Requested higlight id. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "state": "Allowed countries restriction",
- "allowedCountries": [
- "IT"
], - "blockedCountries": [ ],
- "embeddable": true
}
Retrieve highlight details by highlight id.
id required | number Example: 27 Requested highlight id. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 27,
- "type": "VERIFIED",
- "title": "NCAA: Bears vs Patriots",
- "description": "Tom Poole sends one deep to right to give Dallas Baptist an insurance run over Baylor.",
- "match": {
- "id": 394,
- "round": "regular-season",
- "date": "2024-03-06T00:30:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "name": "Bears",
- "displayName": "Baylor",
- "abbreviation": "BAY"
}, - "homeTeam": {
- "id": 219,
- "name": "Bears",
- "displayName": "Baylor",
- "abbreviation": "BAY"
}
}, - "channel": "MLB",
- "source": "youtube"
}
]
Retrieve a list of all matches.
league | object Example: league=NCAA |
date | object 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 | object Example: season=2024 |
homeTeamId | object Example: homeTeamId=219 |
awayTeamId | object Example: awayTeamId=302 |
homeTeamName | object Example: homeTeamName=Bears |
awayTeamName | object Example: awayTeamName=Patriots |
homeTeamAbbreviation | object Example: homeTeamAbbreviation=BAY |
awayTeamAbbreviation | object Example: awayTeamAbbreviation=DBU |
homeTeamDisplayName | object Example: homeTeamDisplayName=Baylor |
awayTeamDisplayName | object Example: awayTeamDisplayName=Dallas Baptist |
limit | number [ 0 .. 100 ] Default: 100 Example: limit=100 |
offset | number >= 0 Default: 0 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "data": [
- {
- "id": 394,
- "round": "regular-season",
- "date": "2024-03-06T00:30:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "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,
- "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"
}
}
Retrieve match details by match id.
id required | number Example: 58348 Requested match id. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 58348,
- "round": "regular-season",
- "date": "2024-03-31T17:00:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "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,
- "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"
}
}
]
Retrieve a list of all teams.
league | object Example: league=NCAA |
name | object Example: name=Bears |
displayName | object Example: displayName=Baylor |
abbreviation | object Example: abbreviation=BAY |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "data": [
- {
- "id": 219,
- "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"
}
}
Retrieve team details by team id.
id required | number Example: 219 Requested team id. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 219,
- "name": "Bears",
- "displayName": "Baylor",
- "abbreviation": "BAY",
- "league": "NCAA",
- "records": {
- "home": {
- "wins": 2,
- "losses": 6
}, - "away": {
- "wins": 2,
- "losses": 3
}, - "total": {
- "wins": 4,
- "losses": 9
}
}
}
]
Retrieve a list of all standings based on passed 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 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "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,
- "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"
}
}
Retrieve a list of all odds based on passed query parameters. At least one parameter has to be specified.
leagueName | object Example: leagueName=NCAA |
timezone | object 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 | object Example: date=2024-03-06 Date that follows the YYYY-MM-DD format. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "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"
}
}
Retrieve a list of all bookmakers based on passed query parameters.
name | object Example: name=Megapari Sport |
limit | number [ 0 .. 100 ] Default: 20 Example: limit=20 |
offset | number >= 0 Default: 0 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
{- "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"
}
}
Retrieve bookmaker details by bookmaker id.
id required | number Example: 53 Requested bookmaker id. |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 53,
- "name": "Megapari Sport"
}
]
Retrieve a list of last five games played for given team id.
teamId required | number Example: teamId=42 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 394,
- "round": "regular-season",
- "date": "2024-03-06T00:30:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "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,
- "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"
}
}
}
]
Retrieve a list of head 2 head games played for given team ids.
teamIdOne required | number Example: teamIdOne=42 |
teamIdTwo required | number Example: teamIdTwo=52 |
x-rapidapi-host required | string mlb-college-baseball-api.p.rapidapi.com |
x-rapidapi-key required | string Rapid API Token |
[- {
- "id": 394,
- "round": "regular-season",
- "date": "2024-03-06T00:30:00.000Z",
- "league": "NCAA",
- "season": 2024,
- "awayTeam": {
- "id": 219,
- "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,
- "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"
}
}
}
]