Bookmakers

GET https://american-football.highlightly.net/bookmakers NFL & NCAAF API
GET https://sports.highlightly.net/american-football/bookmakers All Sports API

Retrieve the supported bookmakers.

Refresh interval
Once a day
Pagination
limit and offset

A bookmaker's name or id filters the odds endpoint. Fetch this list once, store the ids for the bookmakers you display, then pass one as bookmakerId, or its name as bookmakerName, to odds rather than filtering client side after the fact.

limit sets how many bookmakers come back. When the number exceeds it, request the next page by increasing offset. See Pagination and limits.

Parameters

Parameter Type Description
nameoptional string No description in the spec.e.g. Stake.com
limitoptional numberdefault 20 No description in the spec.e.g. 20
offsetoptional numberdefault 0 No description in the spec.e.g. 0

Request

curl --request GET \
  --url 'https://american-football.highlightly.net/bookmakers?name=Stake.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'
const params = new URLSearchParams({
  name: 'Stake.com'
})
const response = await fetch(`https://american-football.highlightly.net/bookmakers?${params}`, {
  headers: {
    'x-rapidapi-key': process.env.HIGHLIGHTLY_API_KEY
  }
})

if (!response.ok) {
  throw new Error(`Highlightly responded ${response.status}`)
}

const data = await response.json()
import os
import requests

response = requests.get(
    'https://american-football.highlightly.net/bookmakers',
    params={
        'name': 'Stake.com',
    },
    headers={
        'x-rapidapi-key': os.environ['HIGHLIGHTLY_API_KEY'],
    },
    timeout=10,
)

response.raise_for_status()
data = response.json()

Response

dataAmericanFootballBookmakerResponse[]required2 fields
idnumberrequired
namestringrequired
paginationPaginationResponserequired3 fields
totalCountnumberrequiredAvailable number of items, relevant to the provided query.
offsetnumberrequired
limitnumberrequired
planPlanResponserequired2 fields
tierstringrequiredYour current API subscription tier.
messagestringrequiredExplanation message regarding your current tier.

Example response

200 application/json
{
  "data": [
    {
      "id": 53,
      "name": "Megapari Sport"
    }
  ],
  "pagination": {
    "totalCount": 490,
    "offset": 20,
    "limit": 100
  },
  "plan": {
    "tier": "BASIC",
    "message": "Some results might be hidden with FREE tier. Check your API coverage for more information: https://rapidapi.com/highlightly-api-highlightly-api-default/api/sport-highlights-api/details"
  }
}

Values are the examples declared in the OpenAPI spec, not a captured live response.

Errors

Status Description
400 Bad request descriptive error.
500 Internal server error.