---
title: "NFL custom scoring rankings (Pro Insights+)"
method: POST
path: "/v1/nfl/rankings/custom"
tags: ["NFL"]
---

# NFL custom scoring rankings (Pro Insights+)

`POST /v1/nfl/rankings/custom`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/nfl/rankings/custom`
- Auth: API key in header `X-PlayCaller-Key`

Rank NFL players by expected fantasy points in your league's exact scoring system. Pass scoring weights in the request body; receive players sorted by `custom_pts_per_game` — computed from prior-season per-game averages.

**Example use case:** Get PPR rankings (`rec: 1`), half-PPR (`rec: 0.5`), or any custom scoring system.

**Tier access:** Pro Insights, Syndicate Alpha

## Request body

- object
  - `scoring` object: Scoring weight overrides. Defaults: standard (0 PPR).
    - `rec` number: Points per reception
    - `rec_yd` number: Points per receiving yard
    - `rec_td` number: Points per receiving TD
    - `rush_yd` number: Points per rushing yard
    - `rush_td` number: Points per rushing TD
    - `pass_yd` number: Points per passing yard
    - `pass_td` number: Points per passing TD
    - `int` number: Points per interception thrown
    - `fumble_lost` number: Points per fumble lost
  - `limit` integer: Max players to return
  - `position` 'QB' | 'RB' | 'WR' | 'TE' | 'K': Filter by position

## Response `200`

Players ranked by custom scoring

- object
  - `success` boolean
  - `sport` string
  - `scoring_applied` object
  - `total` integer
  - `players` object[]
    - `rank` integer
    - `player_id` string
    - `full_name` string
    - `position` string
    - `team` string
    - `custom_pts_per_game` number: Expected fantasy pts/game in your scoring system
    - `adp` number, nullable

## Other responses

- `401`: Missing or invalid API key
- `402`: Pro Insights or Syndicate Alpha required
- `429`: Rate limit or monthly quota exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/playcallerapp/apis/playcaller-data-api.md) · [All operations](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/playcallerapp/apis/playcaller-data-api/revisions/100c0a3ffbfe?raw)