teamcolorcodes.com APIteamcolorcodes.com ↗
Get Hex, RGB, CMYK, and Pantone color codes for NFL, NBA, MLB, NHL, NCAA, and soccer teams via the teamcolorcodes.com API.
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'
List all supported sports leagues and their relative paths. Returns a static list of leagues available for querying teams.
No input parameters required.
{
"type": "object",
"fields": {
"data": "array of objects each containing league name and path",
"status": "string indicating success"
},
"sample": {
"data": [
{
"path": "/nfl-team-color-codes/",
"league": "NFL"
},
{
"path": "/nba-team-color-codes/",
"league": "NBA"
},
{
"path": "/mlb-team-color-codes/",
"league": "MLB"
}
],
"status": "success"
}
}About the teamcolorcodes.com API
The teamcolorcodes.com API provides official brand color data across 6 major sports leagues using 4 endpoints. Call get_team_colors with any team URL to retrieve structured color sections containing Hex, RGB, CMYK, and Pantone values. You can also browse leagues with list_leagues, enumerate rosters with list_teams, or run a cross-league keyword search with search_teams to locate a team page before fetching its colors.
Endpoints and Coverage
The API covers NFL, NBA, MLB, NHL, NCAA, and international soccer. list_leagues returns an array of objects each containing a league name and path (e.g. /nfl-team-color-codes/). Feed any path into list_teams to get every team in that league as an array of {name, url} objects. The url from that response is what you pass to get_team_colors.
Color Data Returned
get_team_colors returns a data object with three top-level fields: team_name, url, and color_sections. Each entry in color_sections has a section label (some teams have primary and secondary sections) and a colors array. Individual color entries carry whichever of these four formats are documented for that team: hex, rgb, cmyk, and pantone. Not every team has all four formats — availability depends on what teamcolorcodes.com publishes for that team.
Searching Across Leagues
search_teams accepts a query string and an optional league_path. Without league_path, it searches up to 6 leagues and returns a results array of {name, url, league_path} matches. This is useful when you have a team name but do not know which league path to start from. Results can then feed directly into get_team_colors.
Practical Considerations
League paths are stable string identifiers (e.g. /nba-team-color-codes/) and serve as the linking parameter across list_leagues, list_teams, and search_teams. Color section names are sourced directly from the team's color page, so formatting may vary slightly between teams. There is no pagination — list_teams returns all teams for a league in a single response.
- Populate an official team color palette picker for a fan merchandise design tool using
get_team_colorshex values - Build a sports branding reference app that maps every NBA or NFL team to its exact Pantone and CMYK colors
- Validate brand color compliance in user-generated sports content by comparing submitted colors against official RGB values
- Generate CSS variables or Tailwind config entries per team using the hex codes from
color_sections - Cross-league team search in a sports trivia app using
search_teamswith a partial team name query - Automate data entry for a sports design system by iterating
list_teamsacross all leagues and fetching each team's colors
| 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 | 250 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 four always present?+
color_sections can include hex, rgb, cmyk, and pantone fields. Not all four are guaranteed — the API returns whichever formats teamcolorcodes.com lists for that specific team, so some teams may only have hex and RGB while others include all four.Does the API return historical or alternate uniform colors?+
Can I retrieve team logos or other brand assets alongside the color codes?+
How do I find a team's URL if I only know the team name?+
search_teams accepts a case-insensitive partial query string and returns matching {name, url, league_path} entries across up to 6 leagues. Pass the returned url directly to get_team_colors to fetch that team's color data.