coolbet.ee APIcoolbet.ee ↗
Access Coolbet.ee sports betting data via 6 endpoints: sports tree, live events, upcoming matches, odds, recommendations, and promotions.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/72d76056-f538-4af4-9a0a-7977f194a32c/get_sports_tree' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full sports navigation tree with categories and subcategories. Returns a hierarchical tree rooted at a single node with nested children representing sports, regions, and leagues.
No input parameters required.
{
"type": "object",
"fields": {
"children": "array of sport category objects, each containing nested children for regions and leagues"
},
"sample": {
"data": {
"id": 1,
"name": "Root",
"slug": "",
"depth": 1,
"order": null,
"children": [
{
"id": 62,
"icon": "football",
"name": "Jalgpall",
"slug": "jalgpall",
"depth": 2,
"children": [
{
"id": 18769,
"name": "Inglismaa",
"depth": 3,
"children": [
{
"id": 18975,
"name": "Premier League",
"depth": 4,
"matches_count": 9
}
],
"fullSlug": "jalgpall/inglismaa"
}
],
"fullSlug": "jalgpall",
"sport_category_id": 62
}
],
"fullSlug": ""
},
"status": "success"
}
}About the coolbet.ee API
The Coolbet.ee API exposes 6 endpoints covering the full sports betting data surface of coolbet.ee, including live in-play events, pre-match odds, and active promotions. Use get_events_by_category to pull match arrays filtered by league category ID — such as La Liga (19104) or Premier League (18975) — and get_live_events to stream currently in-play fixtures with paginated results.
Sports Navigation and Event Discovery
get_sports_tree returns a hierarchical tree of sports, regions, and leagues as nested children arrays from a single root node. The IDs from this tree feed directly into get_events_by_category, which accepts a category_id integer and an optional limit parameter, returning an array of league objects each containing matches, markets, and market_types definitions. This makes it straightforward to traverse from sport down to individual fixture level.
Match Details and Odds
get_event_details accepts a match_id (sourced from get_events_by_category or get_recommendations) and returns the full match metadata object — teams, start time, layout — alongside markets grouped by type and foGroups defining available betting categories such as Winner and Totals. If match_id is omitted, the endpoint automatically resolves a popular event using the recommendations feed.
Live Events and Recommendations
get_live_events returns all currently active in-play fixtures organized by league category, with a hasMore boolean for pagination using limit and offset parameters. get_recommendations surfaces popular events sorted by popularity, returning matches with odds and a market_types_by_league_category map that ties each category to its available market type definitions.
Promotions
get_promotions returns active public bonus offers with fields including id (UUID), code, bonus_type, start_time, end_time, and a description object keyed by locale. This is useful for monitoring campaign activity or bonus availability without requiring account access.
- Build a live odds comparison widget using
get_live_eventsandget_event_detailsmarket data. - Track La Liga and Premier League pre-match lines via
get_events_by_categorywith specific category IDs. - Monitor Coolbet promotion windows by polling
get_promotionsforstart_timeandend_timechanges. - Aggregate popular fixtures across sports using
get_recommendationsand itsmarket_types_by_league_categorymapping. - Construct a sports league browser by traversing the hierarchy returned by
get_sports_tree. - Alert on in-play market availability by combining
get_live_eventspagination with per-matchget_event_detailscalls.
| 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 Coolbet have an official public developer API?+
What does `get_event_details` return when no `match_id` is provided?+
get_event_details automatically resolves a popular event from the recommendations feed and returns its full data — including match metadata, all markets with outcomes, and foGroups such as Winner and Totals. Providing a specific match_id from get_events_by_category or get_recommendations targets a precise fixture instead.Does `get_live_events` support pagination?+
limit and offset integer parameters and returns a hasMore boolean indicating whether additional results exist beyond the current page.