# FantasyPros — 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 expert consensus rankings, player projections, average draft position data, injury reports, and the latest player news from FantasyPros. Search by player name or position to retrieve detailed stats, rankings, and expert analysis across all major scoring formats.

**Category:** Sports | **Website:** [fantasypros.com/](https://fantasypros.com/) | **Docs:** [parse.bot/marketplace/201e0735-75cc-4fd7-a4db-085c2b043444/fantasypros-com-api](https://parse.bot/marketplace/201e0735-75cc-4fd7-a4db-085c2b043444/fantasypros-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-fantasypros-com-api-201e0735/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_adp

Get Average Draft Position (ADP) data. Returns players ranked by their average draft position across fantasy platforms for the chosen scoring format. Single-page result.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `format` | string | No | ADP format. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fantasypros-com-api-201e0735/get_adp \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"format":"<string>"}'
```

### get_injuries

Get player injury reports for a given NFL week and season year. Returns injury status, practice participation details, and probability of playing for all players with active injury designations.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `week` | string | No | NFL week: draft, 1, 2, 3, ... 18. |
| `year` | string | No | NFL season year (e.g. 2024, 2025). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fantasypros-com-api-201e0735/get_injuries \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"week":"<string>","year":"<string>"}'
```

### get_player_details

Get detailed player page information including consensus rankings across formats, recent news, and expert advice. Use search_players to find the player slug first. The slug is the last segment of the link path without the .php extension.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Player slug derived from search_players link field (e.g. 'patrick-mahomes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fantasypros-com-api-201e0735/get_player_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### get_player_news

Get the latest fantasy football player news with fantasy impact analysis. Returns recent news items including titles, source links, publication dates, content summaries, and expert impact assessments. Single-page result.

**Estimated cost:** Metered

_No parameters required._

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

### get_projections

Get season-long stat projections for all players at a given position. Stat columns vary by position (e.g. QBs have passing and rushing stats, WRs have receiving stats). Returns a single-page list of all projected players.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `position` | string | No | Player position to get projections for. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fantasypros-com-api-201e0735/get_projections \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"position":"<string>"}'
```

### get_rankings

Get Expert Consensus Rankings (ECR) for a scoring format. Returns all ranked players with ECR position, tier, positional rank, and expert agreement metrics. Paginates as a single page. Each player includes rank_ecr, pos_rank, tier, and min/max/avg rank across experts.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `scoring` | string | No | Scoring format for rankings. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-fantasypros-com-api-201e0735/get_rankings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scoring":"<string>"}'
```

### search_players

Search for players by name. Returns matching players with their IDs, team, position, and profile links. Use the link field to derive a player slug for get_player_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Player name to search for. |

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