# NFL — 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 real-time NFL data including game schedules, scores, player statistics, team rosters, standings, injury reports, fantasy rankings, and the latest news — all from nfl.com.

**Category:** Sports | **Website:** [nfl.com/](https://nfl.com/) | **Docs:** [parse.bot/marketplace/f5dc4749-3bbe-416c-be21-c1b189dd6f00/nfl-com-api](https://parse.bot/marketplace/f5dc4749-3bbe-416c-be21-c1b189dd6f00/nfl-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-nfl-com-api-f5dc4749/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_current_week

Get current NFL week information based on the current date. Returns the season, week number, season type, week type, and date range for the current NFL week. During off-season periods the returned week may span a long date range.

**Estimated cost:** Metered

_No parameters required._

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

### get_fantasy_rankings

Get NFL fantasy rankings for a specific position, week, and season from fantasy.nfl.com. Returns ranked players with opponent matchups and positional info.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `position` | string | No | Position: QB, RB, WR, TE, K, DEF. |
| `season` | string | No | NFL season year. |
| `week` | string | No | Week number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nfl-com-api-f5dc4749/get_fantasy_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"position":"<string>","season":"<string>","week":"<string>"}'
```

### get_game_details

Get detailed game information including scores, drive charts, play-by-play, scoring summaries, replays, and standings for games in a specific week. Returns significantly more data per game than get_games.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | NFL season year. |
| `season_type` | string | No | Season type: REG, POST, PRE. |
| `week` | string | No | Week number. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nfl-com-api-f5dc4749/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","season_type":"<string>","week":"<string>"}'
```

### get_games

Get a list of games for a given season, type, and week. Returns game schedules with teams, scores, venues, broadcast info, and ticket links. When week is omitted, returns games for all weeks in the specified season type.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | NFL season year. |
| `season_type` | string | No | Season type: REG, POST, PRE. |
| `week` | string | No | Week number (1-18 for REG, 1-4 for POST). Omit to get all weeks for the season type. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nfl-com-api-f5dc4749/get_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","season_type":"<string>","week":"<string>"}'
```

### get_injuries

Get injury reports for NFL teams. Fetches the league-wide injuries page and optionally filters by team. Returns player injury details, practice status, and game status. During off-season, injury reports may be empty.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team` | string | No | Team name to filter by, matched loosely against team names on the injuries page (e.g. 'detroit-lions', 'patriots', 'seahawks'). Omit for all teams with active injury reports. |

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

### get_news

Get the latest NFL news and expert analysis from nfl.com. Returns article titles, links, and summaries. No input parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### get_player_stats

Get player statistics for a specific category and season. Returns full-season aggregate stats parsed from nfl.com. Column names vary by category (e.g. passing returns pass_yds, td, int, rate; rushing returns rush_yds, td, avg).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Stats category: passing, rushing, receiving, fumbles, tackles, interceptions, field-goals, kickoffs, kickoff-returns, punting, punt-returns. |
| `season` | string | No | NFL season year. |
| `season_type` | string | No | Season type: REG, POST, PRE. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nfl-com-api-f5dc4749/get_player_stats \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","season":"<string>","season_type":"<string>"}'
```

### get_standings

Get NFL team standings for a specific season and week. Returns win/loss records, conference and division standings, streaks, and playoff clinch status for all 32 teams.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | NFL season year. |
| `season_type` | string | No | Season type: REG, POST, PRE. |
| `week` | string | No | Week number. Omit to get standings for all weeks. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nfl-com-api-f5dc4749/get_standings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"season":"<string>","season_type":"<string>","week":"<string>"}'
```

### get_team_roster

Get the current roster for a specific NFL team. Returns player names, jersey numbers, positions, status, height, weight, experience, and college for all players on the active roster.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team` | string | No | Team slug in lowercase-hyphenated format (e.g. 'detroit-lions', 'kansas-city-chiefs', 'san-francisco-49ers'). |

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

### get_teams

Get all 32 NFL teams and their basic info for a given season. Returns team name, abbreviation, conference, division, logo URL, colors, venue, social links, and ownership information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `season` | string | No | NFL season year (e.g. 2023, 2024, 2025). |

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