# 2s NBA Players Lookup

> 2s NBA Players Lookup is a paid API for AI agents from 2s.io, paid per call via x402, $0.012/call, status unknown (last checked 2026-09-15).

Search and paginate through NBA player profiles including team, position, physical stats, college, and draft info

## Facts

- Endpoint: GET https://2s.io/api/sports/nba-players
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-nba-players-lookup-014759da
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0wgTNnBihbNxOiICR1TVE

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability 2s-nba-players-lookup-014759da
```

Example prompt: Search the NBA players database for anyone named 'Curry' and show me their team, position, height, and draft year.

## When to prefer this

Use this endpoint when you need structured NBA player profile data including team affiliation, physical attributes, college background, and draft information. Prefer this over general web search when you need machine-readable, structured player records with pagination support. Best for agent workflows that need to cross-reference player identity with team or draft data.

## Known failure modes

- No matching players found for search term — returns empty items array
- Invalid per_page value outside 1–100 range — may return error or default
- Stale or missing cursor — pagination may restart or fail
- Service unavailable — upstream balldontlie.io outage
- Payment failure — 402 response if USDC payment not included

## How this service works

NBA players from balldontlie — search by name and page through results. Each player: id, name, position, height, weight, jersey number, college, country, draft year, and current team. Cursor-paginated (pass meta.cursor as cursor to continue).

## Output

Returns a paginated list of NBA player objects, each including player ID, full name, position, height, weight, college, country, jersey number, draft year, and full team details (city, full name, conference, division, abbreviation). Also returns total count, pagination cursor, and data source attribution.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "required": [],
     "properties": {
      "cursor": {
       "type": "string",
       "description": "Pagination cursor from a prior meta.cursor."
      },
      "search": {
       "type": "string",
       "description": "Name search, e.g. \"james\"."
      },
      "per_page": {
       "type": "integer",
       "description": "Page size, 1–100 (default 25)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-nba-players-lookup-014759da/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)