# FantasyPros — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/fantasypros/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-adp \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-injuries \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-player-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-player-news \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-projections \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/get-rankings \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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.beta.paywithlocus.com/api/wrapped/credits/fantasypros/search-players \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.