# 2s.io NFL Players Search

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

Search NFL players by name and page through results, returning player profile details including position, physical stats, team, and career info.

## Facts

- Endpoint: GET https://2s.io/api/sports/nfl-players
- Price: $0.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/2s-io-nfl-players-search-8d7c94c6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_DVOzxnop0-MRSBqZp_Mpg

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-io-nfl-players-search-8d7c94c6
```

Example prompt: Can you look up Patrick Mahomes in the NFL players database and tell me his position, current team, height, weight, and what college he went to?

## When to prefer this

Use this endpoint when you need structured NFL player profile data — especially for searching a specific player by name or browsing the full player roster with pagination. Prefer this over general web search when you need clean, structured fields like position, team, physical measurements, and college for downstream processing.

## Known failure modes

- No players found matching the search string — empty results array returned
- Invalid cursor value causing pagination error
- per_page value out of 1–100 range causing validation error
- Payment not attached or insufficient — 402 Payment Required
- Rate limit exceeded

## How this service works

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

## Output

A cursor-paginated list of NFL players matching the search query, each with id, full name, position, height, weight, jersey number, college, years of experience, age, and current team details. The response includes a meta.cursor value to fetch the next page of results.

## 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. \"mahomes\"."
      },
      "per_page": {
       "type": "integer",
       "description": "Page size, 1–100 (default 25)."
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/2s-io-nfl-players-search-8d7c94c6/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)