Betfred APIbetfred.com ↗
Access Betfred South Africa casino game catalogs, popularity rankings, sports match listings, and sportsbook configuration via 4 structured API endpoints.
What is the Betfred API?
The Betfred API provides 4 endpoints covering the full Betfred South Africa platform: casino game catalogs, recent biggest-win rankings, upcoming sports match events, and sportsbook configuration. The get_casino_games endpoint returns a complete catalog with fields like title, brand, category, type, and image_url. The get_sports_matches endpoint accepts sport and limit parameters to filter upcoming events sorted by closing time.
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 across all of Betfred's external game integrations (slots, live casino, crash, table and instant games). Each game carries its string id (as minted by the site, e.g. one shape is "<integration>:<providerGameId>"), uuid, name/title, brand (publisher), the integration module it belongs to (category and module carry the same value), a fixed type of "casino", and a thumbnail image_url. In-house games, lotto and sportsbook products are not included. The catalog is returned as a single page (two upstream round trips); use the SDK limit= kwarg to cap items client-side.
No input parameters required.
{
"type": "object",
"fields": {
"games": "array of game objects with id (string), uuid, name, title, brand, category, type, image_url, and module",
"total": "integer total count of games"
},
"sample": {
"data": {
"games": [
{
"id": "7205:2000",
"name": "Reels",
"type": "casino",
"uuid": "f0880d2a-946c-53db-ac27-7071eb84736f",
"brand": "fbastards",
"title": "Reels",
"module": "fbastards",
"category": "fbastards",
"image_url": "https://static.adv.bet/casino/fbastards-icons/thumbnails/2000_horizontal_L.webp"
},
{
"id": "8008:vswaysmgrmgw",
"name": "Forever Split Megaways",
"type": "casino",
"uuid": "71446848-3d6e-542c-9754-e9399794ed14",
"brand": "pragmatic",
"title": "Forever Split Megaways",
"module": "pragmatic",
"category": "pragmatic",
"image_url": "https://static.adv.bet/casino/pragmatic-icons/thumbnails/vswaysmgrmgw_horizontal_L.webp"
}
],
"total": 2357
},
"status": "success"
}
}About the Betfred API
Casino Game Catalog
The get_casino_games endpoint returns the full casino game catalog as a single collection. Each game object includes id, uuid, name, title, brand, category, type, image_url, and module. The response also exposes a total field giving the integer count of all available games. Because the catalog is returned as one page, use the client-side limit= parameter if you only need a subset of records.
Game Popularity via Winning Records
The get_popular_games endpoint returns recent biggest winnings across games. Each record includes gameID, sport, tournamentUUID, categoryUUID, and amount (denominated in ZAR). This serves as an activity signal — games with recent high-value wins appear in the rankings, making it useful for surfacing currently active titles.
Upcoming Sports Events
The get_sports_matches endpoint returns upcoming match events sorted by closesAt. Each event object carries uuid, type, categoryUuid, tournamentUuid, sport, and closesAt. Two optional inputs — sport (string) and limit (integer) — let you narrow results to a specific sport and cap the number of returned records. The response also includes a count field reflecting the total number of matching events.
Sportsbook Configuration
The get_sports_config endpoint exposes the current platform configuration as a single object. It includes an array of sports, an array of banners (each with type, url, and href), a currency object detailing the ZAR symbol and decimal places, a topLeagues array with uuid, categoryUuid, and sport, and a settings object covering betting limits, custom system bets, UI style, and feature flags. This endpoint is useful for building UI mirrors or monitoring platform-level changes over time.
The Betfred API is a managed, monitored endpoint for betfred.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when betfred.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official betfred.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a casino game browser filtered by category or brand using fields from get_casino_games.
- Track which games have the highest recent winning amounts in ZAR using get_popular_games rankings.
- Display upcoming sports fixtures for a specific sport by passing the sport param to get_sports_matches.
- Monitor Betfred sportsbook betting limits and feature flags via the settings object in get_sports_config.
- Sync top league UUIDs from get_sports_config to match against events returned by get_sports_matches.
- Compare game catalog size over time using the total count returned by get_casino_games.
- Pull banner URLs from get_sports_config to track promotional campaigns on the platform.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.