# Pro Football Reference — 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 NFL data including season schedules, team standings, player statistics, game boxscores, play-by-play details, and player profiles to research teams, players, and game information. Search for specific players and dive into detailed game analysis with boxscore information and minute-by-minute play data.

**Category:** Sports | **Website:** [pro-football-reference.com/](https://pro-football-reference.com/) | **Docs:** [parse.bot/marketplace/53a72bae-415f-471f-8a3c-fd2420630bee/pro-football-reference-com-api](https://parse.bot/marketplace/53a72bae-415f-471f-8a3c-fd2420630bee/pro-football-reference-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-pro-football-reference-com-api-53a72bae/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_game_boxscore

Retrieve detailed boxscore data for a specific NFL game. Returns team scores, game metadata (roof, surface, duration, attendance, Vegas line), and player-level offensive and defensive statistics. The game_id is available from get_season_schedule results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID from Pro-Football-Reference (e.g. '202402110kan' for Super Bowl LVIII). Available in get_season_schedule results as game_id. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_game_boxscore \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>"}'
```

### get_game_details

Retrieve specific detailed tables for an NFL game such as play-by-play or drive charts. Returns row-level data whose fields vary by table type. Play-by-play includes quarter, down, distance, detail text, and expected points. Drive tables include drive number, start position, plays, yards, and result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID from Pro-Football-Reference (e.g. '202402110kan'). Available in get_season_schedule results as game_id. |
| `table_id` | string | Yes | Table to extract from the game page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>","table_id":"<string>"}'
```

### get_player_profile

Retrieve a player's biographical profile and career stats summary. Returns name, position, college, birthdate, and career statistics tables (passing, rushing, receiving, and/or defense depending on position). The player_id is available from search_players results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `player_id` | string | Yes | Player ID from Pro-Football-Reference (e.g. 'MahoPa00' for Patrick Mahomes). Available from search_players results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"player_id":"<string>"}'
```

### get_season_schedule

Retrieve the full NFL schedule for a given season. Returns every regular-season and playoff game with final scores, yardage totals, turnover counts, and a game_id suitable for drill-down into boxscores and play-by-play. One request per season; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | NFL season year as a four-digit string (e.g. '2023' for the 2023-24 season). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_season_schedule \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### get_season_stats

Retrieve statistical leaders for a given NFL season and category. Returns all qualifying players ranked by the primary stat for that category (e.g. pass_yds for passing, rush_yds for rushing). Fields in each player object vary by category.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | Yes | Stat category to retrieve leaders for. |
| `year` | string | Yes | NFL season year as a four-digit string (e.g. '2023'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_season_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","year":"<string>"}'
```

### get_season_team_standings

Retrieve conference standings for a given NFL season. Returns teams grouped by AFC and NFC with wins, losses, points scored/allowed, margin of victory, and strength of schedule metrics.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `year` | string | Yes | NFL season year as a four-digit string (e.g. '2023'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/get_season_team_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":"<string>"}'
```

### search_players

Search for NFL players by name to find their player IDs and profile URLs. If the search matches a single player exactly, PFR redirects to that player's page directly and the result contains one entry. Otherwise returns a list of matching players.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Player name to search for (e.g. 'Patrick Mahomes', 'Brady'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pro-football-reference-com-api-53a72bae/search_players \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```