covers.com APIwww.covers.com ↗
Get NBA matchup data from Covers.com: team records, ATS/O-U trends, head-to-head history, injury reports, and best odds across sportsbooks via 2 endpoints.
curl -X GET 'https://api.parse.bot/scraper/263dbe36-dd77-4eb2-baf6-5041203b3ae4/get_matchups' \ -H 'X-API-Key: $PARSE_API_KEY'
Get NBA matchups listing for a given date with team info, scores, spread and total trends. Returns all games scheduled or completed for the specified date.
| Param | Type | Description |
|---|---|---|
| date | string | Date in YYYY-MM-DD format. Omitting returns today's games. |
{
"type": "object",
"fields": {
"date": "string, the requested date or 'today'",
"games": "array of game objects with team info, scores, and betting trend summaries",
"total": "integer, number of games returned"
},
"sample": {
"data": {
"date": "today",
"games": [
{
"status": null,
"game_id": 379387,
"away_team": {
"full": "Cleveland Cavaliers",
"short": "CLE",
"nickname": "Cavaliers"
},
"game_time": null,
"home_team": {
"full": "Detroit Pistons",
"short": "DET",
"nickname": "Pistons"
},
"away_score": "117",
"home_score": "113",
"total_info": "o/u Margin o19.5",
"spread_info": "Cover By +8.5 CLE +4.5"
}
],
"total": 1
},
"status": "success"
}
}About the covers.com API
The Covers.com NBA API exposes game-level betting and matchup data across 2 endpoints, covering everything from spread and totals trends to injury reports and projected scores. The get_matchups endpoint returns all NBA games for a given date with team info and trend summaries, while get_matchup_details delivers per-game ATS records, over/under splits, head-to-head history, and best-available odds across multiple sportsbooks.
Endpoints and Data Coverage
The get_matchups endpoint accepts an optional date parameter in YYYY-MM-DD format and returns an array of game objects with team info, scores, and betting trend summaries. Omit the date to retrieve today's slate. The total field confirms how many games are in the response. This endpoint is suitable for building daily game dashboards or ingesting a full day's schedule at once.
Detailed Game Data
The get_matchup_details endpoint takes a game_id from the matchups listing and returns a richer data object. The records field is keyed by team short code and includes each team's overall record, ATS record, over/under record, and separate home and away splits. The injuries field provides away and home arrays with per-player entries covering player name, position, injury status, and date. The projections field includes projected scores, best spread, best total, and best moneyline odds sourced across sportsbooks, along with the projected covering team.
Head-to-Head History
The head_to_head array in get_matchup_details surfaces recent prior meetings between the two teams. Each entry includes the date, home team, game result, ATS result, and over/under result. This allows trend analysis across multiple recent matchups without needing to query a separate historical endpoint.
Coverage Notes
Data is scoped to NBA games. The away_team_name and home_team_name fields in the detail response confirm team alignment when working with multiple games. Sportsbook odds returned in projections reflect the best available line at time of query and may shift as game time approaches.
- Build a daily NBA betting dashboard showing spread and total trends for all games on a given date.
- Track ATS and over/under records by home vs. away splits for each team using the
recordsobject. - Integrate injury report data into lineup analysis tools before tip-off.
- Compare projected scores from
projectionsagainst current sportsbook lines to spot value. - Aggregate head-to-head results to surface teams with consistent ATS trends against a specific opponent.
- Monitor best moneyline odds across sportsbooks for arbitrage or line-shopping workflows.
- Automate pre-game briefings that combine team records, injuries, and projections in a single API call.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Covers.com offer an official developer API?+
What does the `records` object in `get_matchup_details` include?+
Does the API cover sports other than NBA basketball?+
get_matchups and detailed records, injuries, projections, and head-to-head data via get_matchup_details. You can fork this API on Parse and revise it to add endpoints for other sports covered on Covers.com, such as NFL, NHL, or college basketball.Are historical game results available, or only upcoming and current-day games?+
get_matchups endpoint returns games for any date you specify in YYYY-MM-DD format, including past dates, so completed game data is accessible. The head_to_head array within get_matchup_details also includes prior meeting results for the two teams in a given matchup.Does the API return live in-game odds or line movement history?+
projections field returns best available spread, total, and moneyline odds at the time of the request, not a historical log of line movement. Live in-game odds and line movement tracking are not currently exposed. You can fork this API on Parse and revise it to add a line-movement or live-odds endpoint if that data becomes accessible.