# CBS Sports — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Access comprehensive CBS Sports data including live game schedules, scores, game details, expert picks and analyst performance rankings, and team social feeds — all from a single API.

**Category:** Sports | **Website:** [cbssports.com/](https://cbssports.com/) | **Docs:** [parse.bot/marketplace/4256db80-6acf-4dd4-95f0-ad431eb4f23a/cbssports-com-api](https://parse.bot/marketplace/4256db80-6acf-4dd4-95f0-ad431eb4f23a/cbssports-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_expert_picks

Retrieve expert picks and analysis for a specific game. Returns betting picks from CBS Sports experts including their selections, odds, writeups, and results. Not all games have expert picks — recent games in major leagues (NFL, NBA, MLB) are most likely to have picks. Returns an empty picks array when no picks exist for the game.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID from get_league_games. Use a recent game from a major league for best results. |
| `picks_count` | integer | No | Max number of picks to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/get_expert_picks \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>","picks_count":"<integer>"}'
```

### get_game_details

Get detailed information for a specific game, including team info (names, nicknames, colors) and league metadata. Team IDs from this response can be used with get_team_twitter_feed.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `game_id` | string | Yes | Game ID from get_league_games. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/get_game_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"game_id":"<string>"}'
```

### get_hottest_experts

List the hottest sports experts for a specific league based on recent performance. Returns ranked experts with profit, win percentage, and streak information. Experts are ranked by recent profitability within the given league.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_abbrev` | string | Yes | League abbreviation: 'NFL', 'NBA', 'MLB', 'NHL', 'NCAAF', 'NCAAB'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/get_hottest_experts \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_abbrev":"<string>"}'
```

### get_league_games

Get games for a specific league. Returns games in chronological order starting from the earliest available. Each game includes team abbreviations and IDs. Use list_leagues to get valid league IDs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_id` | string | Yes | League ID from list_leagues (e.g. '54' for NBA, '59' for NFL, '52' for MLB). |
| `limit` | integer | No | Max number of games to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/get_league_games \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_id":"<string>","limit":"<integer>"}'
```

### get_team_twitter_feed

Get a real-time social feed for specific teams using their IDs. Returns recent tweets from team-related accounts including beat writers and official team accounts. Team IDs come from get_league_games or get_game_details.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Max number of feed items to return. |
| `team_ids` | string | Yes | Comma-separated team IDs (e.g. '351,346'). Get team IDs from get_league_games or get_game_details. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/get_team_twitter_feed \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","team_ids":"<string>"}'
```

### list_leagues

List all available sports leagues and their IDs. Returns league abbreviations and numeric IDs usable with other endpoints. The full catalog includes major US leagues (NFL, NBA, MLB, NHL), college sports, international soccer, golf, tennis, and minor leagues.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cbssports-com-api-4256db80/list_leagues \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```