# nba2kapi

> Free REST API for NBA 2K player ratings: 1,700+ players across current,
> classic, and all-time rosters, 40+ attributes each, badges, teams, and
> weekly rating history. Data scraped weekly from 2kratings.com.
> Not affiliated with 2K Sports or the NBA.

Base URL: https://api.nba2kapi.com
Auth: X-API-Key header (free key at https://nba2kapi.com/dashboard, 500 requests/hour)

## Docs

- [Full API reference (single file for LLMs)](https://nba2kapi.com/llms-full.txt)
- [Human docs](https://nba2kapi.com/docs)
- [Interactive playground that writes API calls for you](https://nba2kapi.com/playground)

## Key endpoints

- GET /api/players — list/filter/sort every player (era=all merges eras; any attribute filterable via {attribute}_gte / _lte; sort=<field>:<dir>; fields= trims the payload)
- GET /api/players/bulk — the whole matching dataset in one call
- GET /api/players/slug/{slug} — one player, full detail
- GET /api/players/search?q= — name search
- POST /api/players/batch — resolve up to 100 names and/or slugs in one call
- GET /api/players/{id}/history — weekly rating snapshots
- GET /api/teams — teams with roster averages
- GET /api/teams/{team}/roster — full roster (accepts names or slugs)
- GET /api/badges — badge reference