Bookmakers

List bookmakers, get the top-ranked sportsbook per region, and compare market payouts

List Bookmakers

GET /api/v1/bookmakers
GET /api/v1/bookmakers?geoCode=US

Param	Type	Default	Description
geoCode	string	(all)	Two-letter country code filter (e.g. US, GB, DE)

Response

{
  "generatedAt": "2026-04-05 00:00:00",
  "bookmakers": [
    {
      "id": 170,
      "name": "Stake.com",
      "slug": "stake-com",
      "order": 1,
      "rating": "9.8",
      "userRating": "3.84",
      "bonusDescription": "200% up to $1000",
      "bonusCode": null,
      "link": "https://...",
      "primaryColor": "#192C38"
    }
  ]
}

Cache TTL: 1 hour.

---

Top Bookmaker

GET /api/v1/bookmakers/top
GET /api/v1/bookmakers/top?geoCode=US

Returns the single highest-ranked bookmaker for the given region — useful for hero placements.

{
  "generatedAt": "2026-04-05 00:00:00",
  "bookmaker": {
    "name": "Stake.com",
    "slug": "stake-com",
    "link": "https://...",
    "primary_color": "#192C38",
    "bonus_description": "200% up to $1000",
    "bonus_code": null,
    "tnc": "Terms and conditions apply"
  }
}

Cache TTL: 1 hour.

---

Payout Rankings

GET /api/v1/bookmakers/payouts
GET /api/v1/bookmakers/payouts?sport=football&market=100

Param	Type	Default	Description
sport	string	football	Sport slug
market	number	100	Market ID (100 = 1X2)

{
  "generatedAt": "2026-04-05 00:00:00",
  "payouts": [
    { "id": 170, "name": "Stake.com", "slug": "stake-com", "payout": 97.5, "primary_color": "#192C38" }
  ]
}

payout is a percentage — higher means lower bookmaker margin and better expected return for the bettor.

Cache TTL: 1 hour.

---

Example

curl -H "x-api-key: YOUR_API_KEY" \
  "https://v4.football.sportsapipro.com/api/v1/bookmakers/payouts?sport=football&market=100"