---
title: "Find players with similar stat profiles (Pro Insights+)"
method: GET
path: "/v1/players/similar/{id}"
tags: ["Multi"]
---

# Find players with similar stat profiles (Pro Insights+)

`GET /v1/players/similar/{id}`

## Request

- Base URL: `https://api.playcallerapp.com`
- URL: `https://api.playcallerapp.com/v1/players/similar/{id}`
- Auth: API key in header `X-PlayCaller-Key`

Returns the N most similar players by cosine distance across an 8-dimension stat-profile vector:

1. Average fantasy points
2. Usage rate (snap% for NFL, minutes for NBA)
3. Opportunity rate (target share for NFL, usage% for NBA)
4. Average rushing yards
5. Average receiving yards
6. Consistency Score (from Alpha Metrics)
7. Momentum Delta (normalized)
8. Opportunity Ceiling (from Alpha Metrics)

Use case: "Find WRs with the same profile as CeeDee Lamb," "Identify breakout candidates with similar usage to Cooper Kupp Year 2," DFS stack-building, dynasty trade comps.

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

## Path parameters

- `id` string, required

## Query parameters

- `sport` 'nfl' | 'mlb' | 'nba', required
- `limit` integer

## Response `200`

Similar players ranked by cosine similarity

- object
  - `success` boolean
  - `query` object
    - `player_id` string
    - `full_name` string
    - `position` string
    - `team` string
    - `sport` string
  - `count` integer
  - `data` object[]
    - `id` string
    - `full_name` string
    - `position` string
    - `team` string
    - `similarity_score` number: 1.0 = identical profile, 0.0 = no overlap
  - `meta` ResponseMeta
    - `sport` string
    - `league` string: Present on multi-sport (ESPN-backed) endpoints; mirrors sport unless a sport has sub-leagues (e.g. soccer: epl/mls).
    - `tier` string
    - `calls_remaining_this_month` integer
    - `documentation_url` string, uri

## Other responses

- `400`: sport parameter missing or invalid
- `401`: Missing or invalid API key
- `403`: Pro Insights or Syndicate Alpha key required
- `404`: Player not found or insufficient game data
- `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)