API reference
List teams
Every side in the feed, with its team_id, short name and crest. Free on every plan.
GET
/odds/v1/teams- Cost
- 0 tokens
- Authentication
- X-API-Key, demo key works
Parameters
sportstringoptionalA sport key from /sports, e.g. american_football, soccer.leaguestringoptionalA league key from /sports, e.g. nfl, epl.countrystringoptionalA country code, e.g. au, gb.
Request
curl -s "https://api.b337.ai/odds/v1/teams?sport=american_football&league=nfl" \
-H "X-API-Key: demo"import requests
resp = requests.get(
"https://api.b337.ai/odds/v1/teams",
params={"sport": "american_football", "league": "nfl"},
headers={"X-API-Key": "demo"},
timeout=10,
)
resp.raise_for_status()
print(resp.json())// Node 18+, saved as an .mjs file
const res = await fetch("https://api.b337.ai/odds/v1/teams?sport=american_football&league=nfl", {
headers: { "X-API-Key": "demo" },
});
console.log(await res.json());Response
200 OK
{
"count": 32,
"data": [
{"team_id": "american_football:arizona_cardinals", "name": "Arizona Cardinals",
"short_name": "ARI", "sport": "american_football", "leagues": ["nfl"],
"logo_url": "https://api.b337.ai/odds/v1/media/logo/b53e6f5dea67ed9a.png", "events": 1},
{"team_id": "american_football:atlanta_falcons", "name": "Atlanta Falcons",
"short_name": "ATL", "sport": "american_football", "leagues": ["nfl"],
"logo_url": "https://api.b337.ai/odds/v1/media/logo/7b2bf559d35d77b2.png", "events": 2}
],
"generated_at": "2026-10-06T00:00:00Z"
}Fields
- One row per team_id: every side of every listed fixture (outrights excluded). In player sports (tennis, MMA, darts) the “team” is the player or pair.
short_nameis the abbreviation for the US majors (NFL, NBA, WNBA, MLB, NHL), elsenull.leagues: the leagues it is listed in.events: the fixtures it is in right now.logo_urlis the crest, ornull. See logos and headshots. The sameidandlogo_urlappear in each event'scompetitors.- It costs 0 tokens on every plan, the demo key included: it carries no prices.