# Teamcolorcodes — 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.

> Get official color codes for sports teams across NFL, NBA, MLB, NHL, NCAA, and international soccer leagues, then search and browse teams to find their exact hex and RGB colors. Perfect for designing fan apps, merchandise, or any project that needs authentic team branding information.

**Category:** Sports | **Website:** [teamcolorcodes.com/](https://teamcolorcodes.com/) | **Docs:** [parse.bot/marketplace/327a3b12-fdcd-4cc0-8a1f-074565ff4c3c/teamcolorcodes-com-api](https://parse.bot/marketplace/327a3b12-fdcd-4cc0-8a1f-074565ff4c3c/teamcolorcodes-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-teamcolorcodes-com-api-327a3b12/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_team_colors

Get detailed color codes for a specific team. Returns color sections parsed from the team page, each containing individual color entries with available format values (Hex, RGB, CMYK, Pantone, Color Name). Different sections may contain subsets of formats (e.g. a Pantone-only section, an RGB-only section). The first section typically has all formats.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `team_url` | string | Yes | Full URL of the team color codes page (e.g. https://teamcolorcodes.com/dallas-cowboys-color-codes/). Obtain from list_teams or search_teams results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teamcolorcodes-com-api-327a3b12/get_team_colors \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"team_url":"<string>"}'
```

### list_leagues

List all supported sports leagues and their relative paths. Returns a static list of 12 leagues spanning NFL, NBA, MLB, NHL, MLS, EPL, NCAA, WNBA, La Liga, Serie A, Bundesliga, and Ligue 1. Each league entry provides the path needed to query its teams via list_teams.

**Estimated cost:** Metered

_No parameters required._

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

### list_teams

List all teams in a specific league. Fetches the league page and extracts team links with their full URLs. The returned URLs are suitable for passing directly to get_team_colors. Results may include promoted/related teams from the page sidebar.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_path` | string | Yes | Relative path of the league (e.g. /nfl-team-color-codes/, /nba-team-color-codes/). Obtain from list_leagues endpoint. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teamcolorcodes-com-api-327a3b12/list_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_path":"<string>"}'
```

### search_teams

Search for teams by name across leagues. Performs case-insensitive partial matching on team names. Searches up to 6 leagues (all by default, or a single league if league_path is specified). Returns matching teams with their URLs and league paths. Stops after 50 matches.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `league_path` | string | No | Optional league path to restrict search to a single league (e.g. /nba-team-color-codes/). Omitting searches across all leagues. |
| `query` | string | Yes | Team name or keyword to search for (case-insensitive partial match). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-teamcolorcodes-com-api-327a3b12/search_teams \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"league_path":"<string>","query":"<string>"}'
```