# PFF — 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 PFF.com football data including fantasy draft and weekly rankings, NFL season info, and NCAA college football schedules and game results.

**Category:** Sports | **Website:** [pff.com/](https://pff.com/) | **Docs:** [parse.bot/marketplace/929daa8b-be0a-4c75-96d4-8686a6207f4e/pff-com-api](https://parse.bot/marketplace/929daa8b-be0a-4c75-96d4-8686a6207f4e/pff-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-pff-com-api-929daa8b/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_fantasy_rankings

Retrieve fantasy football draft rankings with ADP data, tier assignments, and point projections. Returns a full list of ranked players for the given scoring format. Each player includes team info, bye week, ADP from ESPN, tier grouping, and high/low/mid point projections. Paginated by page number.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_type` | string | No | League format. Accepted value: 'standard'. |
| `page` | integer | No | Pagination page number. |
| `scoring_type` | string | No | Scoring format for draft rankings. 'REDRAFT_PPR' populates ADP data; other values accepted but may null out ADP fields. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pff-com-api-929daa8b/get_fantasy_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_type":"<string>","page":"<integer>","scoring_type":"<string>"}'
```

### get_fantasy_weekly_rankings

Retrieve weekly fantasy football rankings filtered by position. Returns players with their current-week rank, next-game matchup info, and ranker-specific projections across consensus and individual analysts. Useful for setting weekly lineups.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Pagination page number. |
| `position` | string | No | Player position filter. Accepted values: 'QB', 'RB', 'WR', 'TE', 'K', 'DST'. |
| `scoring_type` | string | No | Scoring format for weekly rankings. Accepted value: 'ppr'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pff-com-api-929daa8b/get_fantasy_weekly_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","position":"<string>","scoring_type":"<string>"}'
```

### get_ncaa_matchup

Retrieve scoring plays and score data for a specific college football game. The game_slug, season, and week parameters are tightly coupled — use the slug and corresponding season/week values from get_ncaa_schedule results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_slug` | string | Yes | Game slug from get_ncaa_schedule results (e.g. 'kansas-state-wildcats_at_iowa-state-cyclones_28740'). Must match the season and week it belongs to. |
| `season` | string | No | Season year matching the game_slug. Must correspond to the season from get_ncaa_schedule where the slug was found. |
| `week` | string | No | Week number matching the game_slug (e.g. '0', '1', '2'). Must correspond to the week from get_ncaa_schedule where the slug was found. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-pff-com-api-929daa8b/get_ncaa_matchup \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_slug":"<string>","season":"<string>","week":"<string>"}'
```

### get_ncaa_schedule

Get the college football (NCAA) schedule for a given season. Returns weeks containing games with slugs, scores, betting lines, and franchise details.

**Estimated cost:** Metered

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

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

### get_nfl_current_week

Retrieve the current NFL week and season information. Returns the active season year, week type (REG for regular season, POST for postseason), and a human-readable week description. No parameters required — always reflects the live NFL calendar state.

**Estimated cost:** Metered

_No parameters required._

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