Team Color Codes APIteamcolorcodes.com ↗
Access official Hex, RGB, CMYK, and Pantone color codes for NFL, NBA, MLB, NHL, MLS, NCAA, and international soccer teams via a structured API.
What is the Team Color Codes API?
The teamcolorcodes.com API exposes official brand color data for sports teams across 12 leagues through 4 endpoints. Use get_team_colors to retrieve named color sections for any team, each entry carrying available values in Hex, RGB, CMYK, and Pantone formats. search_teams lets you find teams by partial name match across all leagues at once, returning direct URLs ready to pass into color lookups.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/29e13f18-fd55-4186-a28e-fbac5952be0c/list_leagues' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace teamcolorcodes-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.team_color_codes_api import TeamColors, League, TeamSummary, Team, ColorSection, Color
client = TeamColors()
# List all available leagues
for league in client.leagues.list():
print(league.league, league.path)
# Navigate to a specific league and list its teams
nfl = client.league(path="/nfl-team-color-codes/")
for team_summary in nfl.teams.list():
print(team_summary.name, team_summary.url)
# Get detailed color codes for a team via the details navigation
for team_summary in nfl.teams.list(limit=2):
team_detail = team_summary.details()
print(team_detail.team, team_detail.url)
for section in team_detail.color_sections:
print(section.section)
for color in section.colors:
print(color.color_name, color.hex, color.rgb, color.pantone)
# Search for teams across all leagues
for result in client.teamsummaries.search(query="Lakers"):
print(result.name, result.url, result.league_path)
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.
No input parameters required.
{
"type": "object",
"fields": {
"leagues": "array of league objects each with league name and path"
},
"sample": {
"data": {
"leagues": [
{
"path": "/nfl-team-color-codes/",
"league": "NFL"
},
{
"path": "/nba-team-color-codes/",
"league": "NBA"
},
{
"path": "/mlb-team-color-codes/",
"league": "MLB"
},
{
"path": "/nhl-team-color-codes/",
"league": "NHL"
},
{
"path": "/soccer/mls-team-color-codes/",
"league": "MLS"
},
{
"path": "/soccer/epl-team-color-codes/",
"league": "EPL"
},
{
"path": "/ncaa-team-color-codes/",
"league": "NCAA"
},
{
"path": "/wnba-team-color-codes/",
"league": "WNBA"
},
{
"path": "/soccer/la-liga-team-color-codes/",
"league": "La Liga"
},
{
"path": "/soccer/serie-a-team-color-codes/",
"league": "Serie A"
},
{
"path": "/soccer/bundesliga-team-color-codes/",
"league": "Bundesliga"
},
{
"path": "/soccer/ligue-1-team-color-codes/",
"league": "Ligue 1"
}
]
},
"status": "success"
}
}About the Team Color Codes API
What the API Covers
The API covers 12 leagues: NFL, NBA, MLB, NHL, MLS, EPL, NCAA, WNBA, La Liga, Serie A, Bundesliga, and Ligue 1. list_leagues returns a static array of league objects, each with a league_path string (e.g. /nfl-team-color-codes/) that feeds directly into list_teams. list_teams takes that path and returns a teams array of objects with name and url fields. The url values are fully qualified and ready to pass to get_team_colors.
Team Color Detail
get_team_colors accepts a team_url and returns the team name, the queried url, and a color_sections array. Each section has a section name and a nested colors array. Individual color entries carry whichever format fields are present on that team's page — Hex, RGB, CMYK, Pantone, and Color Name. Not every section contains all formats; some sections are Pantone-only or omit CMYK, reflecting the source data rather than an API limitation.
Searching Across Leagues
search_teams accepts a required query string and an optional league_path. Without league_path, the search spans up to 6 leagues simultaneously and stops at 50 matches. Results include name, url, and league_path for each match, making it straightforward to identify which league a team belongs to before fetching its colors. Matching is case-insensitive and partial, so a query like "city" will return any team whose name contains that substring.
The Team Color Codes API is a managed, monitored endpoint for teamcolorcodes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when teamcolorcodes.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official teamcolorcodes.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Populate a fan merchandise configurator with the exact Hex and RGB values for a chosen NFL or NBA team.
- Automate design asset generation for all 30 MLB teams by iterating over
list_teamsresults and callingget_team_colors. - Build a quiz app that asks users to match team logos to their official Pantone color names.
- Validate brand consistency in a sports media CMS by comparing published color values against the Hex codes returned by
get_team_colors. - Generate a color palette reference sheet for all EPL or La Liga clubs using
list_teamsandcolor_sectionsdata. - Power a team-themed UI theme selector using
search_teamsto let users pick their club and load its CMYK and Hex values dynamically.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does teamcolorcodes.com have an official developer API?+
What color formats does `get_team_colors` return, and are all formats always present?+
color_sections array can carry Hex, RGB, CMYK, Pantone, and Color Name fields. Not every field is guaranteed for every entry — some sections contain only a subset of formats. The response reflects whichever formats are present for that specific team and color section.Does `search_teams` cover all 12 leagues?+
search_teams searches up to 6 leagues simultaneously. If you need to ensure coverage across all 12 leagues, you can supply a specific league_path and run separate queries per league, or you can fork the API on Parse and revise the search logic to span all 12 leagues in a single call.Does the API return historical or alternate jersey color sets, such as city edition or throwback palettes?+
Can I retrieve colors for international leagues outside the current 12?+
list_leagues response. You can fork the API on Parse and revise it to add additional league paths from the source site.