betfred.com APIbetfred.com ↗
Access Betfred casino game catalogs, sports event listings, popularity rankings, and sportsbook configuration via 4 structured API endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/27c79099-c133-403b-88d9-0dbf626ad44a/get_casino_games' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetches the complete casino game catalog including slots, table games, and more. Returns game details such as title, brand, category, type, and image URL.
No input parameters required.
{
"type": "object",
"fields": {
"games": "array of game objects with id, uuid, name, title, brand, category, type, image_url, and module",
"total": "integer total count of games"
},
"sample": {
"data": {
"games": [
{
"id": 736,
"name": "megahot20",
"type": "slot",
"uuid": "b7b015c3-1582-52b3-b0e4-eb0d1fadf103",
"brand": "agt",
"title": "Mega Hot",
"module": "agtslots",
"category": "hot",
"image_url": "https://content.kolinz.xyz/games/agt/sqthumb/megahot20.png"
}
],
"total": 2702
},
"status": "success"
}
}About the betfred.com API
The Betfred API provides 4 endpoints for extracting casino game data, sports event listings, and sportsbook configuration from Betfred. The get_casino_games endpoint returns the full game catalog with fields like title, brand, category, type, and image_url, while get_sports_matches lets you filter upcoming events by sport type and limit result count. Together the endpoints cover everything from individual game metadata to site-wide betting settings.
Casino Game Catalog
The get_casino_games endpoint returns every game in the Betfred casino, including slots, table games, and other categories. Each game object includes id, uuid, name, title, brand, category, type, image_url, and module. The total field in the response gives the full count of games available at query time, making it straightforward to detect catalog changes over successive calls.
Game Popularity and Recent Winnings
get_popular_games returns an array of recent winning records rather than a simple view count. Each record includes gameID, sport, tournamentUUID, categoryUUID, and amount. This data functions as a proxy for game activity levels — games appearing frequently with high amount values are the most actively played. Note that the sport field in this context maps to game identifiers rather than traditional sports categories.
Sports Events and Filtering
get_sports_matches accepts two optional parameters: limit (integer) to cap the number of returned events, and sport (string) to filter by discipline. Confirmed working values for sport include football, rugby, basketball, cricket, tennis, and golf. Each event object contains uuid, type, categoryUuid, tournamentUuid, sport, and closesAt. Events are sorted by closesAt, so the earliest-closing markets appear first. The count field reflects the total number of matching events before any limit is applied.
Sportsbook Configuration
get_sports_config returns the broader sportsbook setup: an array of available sports, topLeagues with their uuid, categoryUuid, and sport, banners with type, url, and href, and a settings object covering betting limits, custom system bets, UI style, and feature flags. The currency object specifies name, symbol, and decimalPlaces — currently configured for ZAR (South African Rand), indicating the data reflects Betfred's South African market.
- Build a casino game browser that organizes titles by
categoryandbrandusing data fromget_casino_games. - Track catalog size changes over time by comparing the
totalfield across daily calls toget_casino_games. - Identify the most active games by sorting
get_popular_gamesresults byamountto surface high-activity titles. - Pull upcoming football or tennis fixtures with
get_sports_matchesfiltered by thesportparameter for a betting preview tool. - Monitor market closing times by reading
closesAtfromget_sports_matchesto alert users before events expire. - Extract
topLeaguesfromget_sports_configto build a curated league navigation sidebar. - Read
settingsfromget_sports_configto understand betting limits and feature flags for a compliance or audit workflow.
| 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 Betfred have an official public developer API?+
What sport values work with the `sport` filter in `get_sports_matches`?+
football, rugby, basketball, cricket, tennis, and golf. Passing an unsupported value will return no matching events. The count field in the response always reflects the number of events matched after filtering.Does the API return odds or betting lines for sports events?+
get_sports_matches returns event metadata — uuid, type, categoryUuid, tournamentUuid, sport, and closesAt — but no odds, lines, or market prices. get_sports_config covers betting limits and league structure. You can fork this API on Parse and revise it to add an endpoint that fetches market odds for a given event UUID.Which market or region does this API reflect?+
get_sports_config response returns a currency object set to ZAR (South African Rand), so the data reflects Betfred's South African market. Game availability and sportsbook configuration may differ from Betfred's UK or other regional offerings.Does `get_casino_games` support filtering by category or type?+
category and type fields present on each game object. The API does not currently expose a server-side filter parameter for this endpoint. You can fork it on Parse and revise it to add category or type filtering if needed.