Find players

GET/v1/players

Find players by name or team, with the games they played and their last team. Send q (3 letters or more) or team.

Live and up A list: pages of 50, see paging

Parameters

Name	In	Type	About
`q`	query	string	Part of a name.
`team`	query	id	Only this team, by its id (tm_…). e.g. `tm_Z81WSSTP`
`competition`	query	id	Only this competition, by its id (cp_…). e.g. `cp_11A6HQXJ`
`season`	query	id	Only this season, by its id (ss_…). e.g. `ss_K1TTWVRM`
`page`	query	integer	Which page, from 1.
`cursor`	query	string	The next_cursor from the last answer, to carry on.
`per_page`	query	integer	Records an answer, from 1 to 200. 50 if left out.

What comes back

data is a list of these:

Field	Type	About
`id`	id	A player id.
`name`	string
`games`	integer
`first_date`	date
`last_date`	date
`last_team`	object or null
`last_team.id`	id	A team id.
`last_team.name`	string

Errors

400422401403429 What each one means

import requests r = requests.get("https://api.basketballapi.net/v1/players?team=tm_Z81WSSTP&competition=cp_11A6HQXJ", headers={"Authorization": "Bearer bba_live_your_key"}) print(r.json()["data"])

const r = await fetch("https://api.basketballapi.net/v1/players?team=tm_Z81WSSTP&competition=cp_11A6HQXJ", { headers: { Authorization: "Bearer bba_live_your_key" } }); const { data } = await r.json();

$ctx = stream_context_create(['http' => [ 'header' => "Authorization: Bearer bba_live_your_key", ]]); $r = json_decode(file_get_contents("https://api.basketballapi.net/v1/players?team=tm_Z81WSSTP&competition=cp_11A6HQXJ", false, $ctx), true);

{ "data": [ { "id": "pl_EDA561C6", "name": "Example name", "games": 34, "first_date": "2026-10-01", "last_date": "2026-10-01", "last_team": { "id": "tm_8EB4D858", "name": "Example name" } } ], "meta": { "count": 1, "next_cursor": null, "page": 1, "per_page": 50, "total": 1, "total_pages": 1, "next_page": null, "prev_page": null, "plan": "Free key" } }