# Ncaaf — 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 comprehensive college football data to get live scores, team schedules, player statistics, and game details across the NCAAF. Track rankings, compare team rosters, analyze betting odds and spreads, and explore historical results and trends to stay informed on college football.

**Category:** Sports | **Website:** [ncaaf.com/](https://ncaaf.com/) | **Docs:** [parse.bot/marketplace/c658dcd5-040f-4556-aec7-4837e8a2dcf7/ncaaf-com-api](https://parse.bot/marketplace/c658dcd5-040f-4556-aec7-4837e8a2dcf7/ncaaf-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-ncaaf-com-api-c658dcd5/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_athlete_stats

Retrieve career and season statistics for a specific athlete, along with related news articles. Returns athlete biographical info, season type details, league metadata, and recent NCAAF news.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `athlete_id` | string | Yes | The unique ID of the athlete (e.g., '4889929'). |
| `season` | integer | No | Season year (e.g., 2024). Omitting returns the current season. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_athlete_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"athlete_id":"<string>","season":"<integer>"}'
```

### get_game_details

Retrieve detailed game information including boxscore, team/player statistics, drive summaries, scoring plays, and betting information (odds, spreads). Requires an event_id from the scoreboard. Returns comprehensive game data including play-by-play drives, leaders, and pick center odds.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `event_id` | string | Yes | The unique ID of the game event (e.g., '401628390'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event_id":"<string>"}'
```

### get_rankings

Retrieve current college football rankings from various polls (AP Top 25, AFCA Coaches Poll, FCS Coaches Poll). Each poll includes ranked teams with current/previous positions, points, first-place votes, and record summaries.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_scoreboard

Retrieve the scoreboard/schedule for a specific date or the current week. Returns game events with scores, teams, status, and broadcast information. Each event includes competitors with scores, records, and game leaders. Paginates as a single page; pass date in YYYYMMDD format to target a specific day.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `date` | string | No | Date in YYYYMMDD format (e.g., '20241012'). Omitting returns the current week's scoreboard. |
| `groups` | integer | No | Group ID: 80 for FBS, 81 for FCS. |
| `limit` | integer | No | Maximum number of events to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_scoreboard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"<string>","groups":"<integer>","limit":"<integer>"}'
```

### get_team_roster

Retrieve the full roster for a specific team, grouped by position (offense, defense, special teams). Each group contains athlete entries with biographical data, position, experience, and status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_id` | string | Yes | The unique ID of the team (e.g., '333' for Alabama). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_team_roster \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_id":"<string>"}'
```

### get_team_stats

Retrieve comprehensive season statistics for a specific team including passing, rushing, receiving categories and opponent stats. Each category contains detailed stat entries with values, display values, and per-game averages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | integer | No | Season year (e.g., 2024). Omitting returns the current season. |
| `team_id` | string | Yes | The unique ID of the team (e.g., '333' for Alabama). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_team_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<integer>","team_id":"<string>"}'
```

### get_teams

Retrieve a flat list of college football teams, optionally filtered by group (FBS or FCS). Returns team objects with id, displayName, abbreviation, location, logos, and links.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `groups` | integer | No | Group ID: 80 for FBS, 81 for FCS. |
| `limit` | integer | No | Maximum number of teams to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/get_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"groups":"<integer>","limit":"<integer>"}'
```

### search_teams

Search for teams by name or abbreviation. Performs a case-insensitive substring match against team displayName, name, and abbreviation fields. Returns matching teams from the FBS group.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Team name or abbreviation to search for (e.g., 'Alabama', 'TEX'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-ncaaf-com-api-c658dcd5/search_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```