# NCAA — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access live college sports scores, game schedules, detailed boxscores, play-by-play breakdowns, and team statistics across NCAA sports. Search for specific contests and retrieve comprehensive game information for any NCAA sport, division, or team.

**Category:** Sports | **Website:** [ncaa.com/](https://ncaa.com/) | **Docs:** [parse.bot/marketplace/58ea6a6c-c8cc-42fa-8d92-7b1a46722ad7/ncaa-com-api](https://parse.bot/marketplace/58ea6a6c-c8cc-42fa-8d92-7b1a46722ad7/ncaa-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_boxscore

Get player-level boxscore statistics for a game including individual player stats (points, rebounds, assists, shooting percentages) and team totals. Returns data organized by team with full roster stats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contest_id` | string | Yes | Contest ID obtained from search_contests results. |
| `sport` | string | No | Sport name: 'basketball' or 'football'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/get_boxscore \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contest_id":"<string>","sport":"<string>"}'
```

### get_game_detail

Get detailed game information for a specific contest including linescores, team rosters, location, championship metadata, and streaming links. Requires a contest_id obtained from search_contests. Returns full game state with period-by-period scoring breakdown.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contest_id` | string | Yes | Contest ID obtained from search_contests results (e.g. '6232202'). |
| `week` | integer | No | Optional week number for football games. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/get_game_detail \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contest_id":"<string>","week":"<integer>"}'
```

### get_play_by_play

Get play-by-play event data for a game organized by period. Each play includes a clock time, score at that moment, team attribution, and event description. Basketball games have 2 halves; football games have 4 quarters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contest_id` | string | Yes | Contest ID obtained from search_contests results. |
| `sport` | string | No | Sport name: 'basketball' or 'football'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/get_play_by_play \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contest_id":"<string>","sport":"<string>"}'
```

### get_team_stats

Get team-level aggregate statistics for a game including field goal percentages, rebounds, assists, turnovers, steals, and blocks for both teams. Returns the same boxscore structure as get_boxscore but without individual player stats — useful for a quick team comparison.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contest_id` | string | Yes | Contest ID obtained from search_contests results. |
| `sport` | string | No | Sport name: 'basketball' or 'football'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/get_team_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contest_id":"<string>","sport":"<string>"}'
```

### search_contests

Search for game contests by date, sport, and division. Returns a list of contests with scores, teams, game state, and bracket information. The season_year parameter follows NCAA convention where the 2024-25 season is year 2025 for basketball but the 2024 championship game falls under season_year 2023. Contests include live, scheduled, and final games for the given date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `contest_date` | string | Yes | Date in MM/DD/YYYY format (e.g. 04/08/2024). |
| `division` | integer | No | Division number: 1, 2, or 3. |
| `season_year` | integer | No | Season year following NCAA convention (e.g. 2023 for the 2023-24 championship season). |
| `sport_code` | string | No | Sport code. |
| `week` | integer | No | Week number, primarily used for football schedules. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaa-com-api-58ea6a6c/search_contests \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contest_date":"<string>","division":"<integer>","season_year":"<integer>","sport_code":"<string>","week":"<integer>"}'
```