# Stathead — 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.

> Search and analyze NFL player performance on a game-by-game basis. Access detailed football statistics — passing, rushing, receiving, and more — filterable by season, team, game type, or statistical thresholds.

**Category:** Sports | **Website:** [stathead.com/](https://stathead.com/) | **Docs:** [parse.bot/marketplace/3f3f2896-3877-41ff-92dc-35a490e2bde0/stathead-com-api](https://parse.bot/marketplace/3f3f2896-3877-41ff-92dc-35a490e2bde0/stathead-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-stathead-com-api-3f3f2896/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### football_player_game_finder

Retrieve game-by-game statistics for an NFL player from Pro-Football-Reference. Accepts either a player name (resolved via search) or a direct PFR player ID. Returns detailed per-game stats including passing (completions, attempts, yards, TDs, INTs, passer rating), rushing (attempts, yards, TDs), receiving (targets, receptions, yards, TDs), fumbles, and snap counts. When year is omitted, returns the full career game log. The game_type filter restricts to regular season or playoff games only.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_type` | string | No | Filter by game type. Accepted values: 'R' for regular season only, 'P' for playoffs only. If omitted, returns both regular season and playoff games. |
| `player` | string | No | Player name to search for (e.g., 'Patrick Mahomes'). Either player or player_id is required. When multiple players share a name, the first search result is used. |
| `player_id` | string | No | Pro-Football-Reference player ID (e.g., 'MahoPa00'). Either player or player_id is required. The ID format is typically the first four letters of the last name + first two of the first name + a two-digit disambiguator. |
| `year` | string | No | Season year to get game logs for (e.g., '2024'). If omitted, returns the career game log. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-stathead-com-api-3f3f2896/football_player_game_finder \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_type":"<string>","player":"<string>","player_id":"<string>","year":"<string>"}'
```