Superbet APIsuperbet.ro ↗
Access Superbet.ro sports data via API: sports hierarchy, pre-match and live events, full odds markets, boosted prices, and accumulator suggestions.
What is the Superbet API?
The Superbet.ro API covers 9 endpoints that expose the full sports betting catalog from superbet.ro, including the sports and competition hierarchy, pre-match and live event listings, detailed per-market odds, boosted prices, and pre-built accumulator suggestions. The get_event_odds endpoint returns every available market line and current price for a single event, while get_live_events delivers in-play data with scores and period metadata in real time.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/0235330a-6b3b-43ca-bdb8-2df082bae2f5/list_sports' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace superbet-ro-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Superbet.ro sports betting SDK — bounded, re-runnable."""
from parse_apis.superbet_ro_sports_betting_api import Superbet, OfferState, SportId, EventNotFound
superbet = Superbet()
# List available sports, capped at 5
for sport in superbet.sports.list(limit=5):
print(sport.name, sport.id, sport.icon)
# Get the full sports/competitions hierarchy
hierarchy = superbet.sporthierarchies.get()
print(hierarchy.error, len(hierarchy.data.sports), len(hierarchy.data.categories))
# Get upcoming football (sport_id=5) prematch events
for event in superbet.events.list(sport_id=SportId._5, offer_state=OfferState.PREMATCH, limit=3):
print(event.match_name, event.match_date, event.market_count)
# Get featured/top event IDs
top_config = superbet.events.top()
print(top_config.config.target, top_config.config.timestamp, len(top_config.top_matches))
# Drill into a single event's bet builder markets
event = superbet.events.list(sport_id=SportId._5, limit=1).first()
if event:
builder = event.bet_builder()
print(builder.match_id)
for market in builder.markets[:3]:
print(market.name, market.id)
for odd in market.odds[:2]:
print(odd.name, odd.price, odd.status)
# Typed error handling: catch EventNotFound for an invalid event_id
try:
detail = superbet.events.get(event_id="99999999")
print(detail.match_name, detail.sport_id)
except EventNotFound as exc:
print(f"Event not found: {exc.event_id}")
print("exercised: sports.list / sporthierarchies.get / events.list / events.top / events.get / event.bet_builder")
List all available sports with their IDs, names, and icons. Returns the full catalog of sports offered on Superbet.ro, ordered by display priority.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of sport objects with id, name, icon, and order"
},
"sample": {
"data": {
"items": [
{
"id": 5,
"icon": "soccer",
"name": "Fotbal",
"order": 6
},
{
"id": 2,
"icon": "tennis",
"name": "Tenis",
"order": 33
}
]
},
"status": "success"
}
}About the Superbet API
Sports Hierarchy and Competition Structure
list_sports returns the full catalog of sports offered on Superbet.ro — each sport object includes an id, name, icon, and order field. That id is the key input for filtering across most other endpoints. get_sport_competitions expands this into the full hierarchy: nested arrays for sports, categories, tournaments, outcomes, and a marketTree structure, giving you the complete classification tree in one call.
Event Listings and Odds
get_sport_events returns paginated upcoming events filtered by sport_id, start_date, and end_date (format YYYY-MM-DD HH:mm:ss), plus an offer_state param that accepts prematch or live. Each event object in the response includes eventId, matchName, matchDate, and pre-selected odds. When dates are omitted the endpoint defaults to today through tomorrow UTC. For full odds detail on a single match, get_event_odds takes an event_id (sourced from get_sport_events or get_top_events) and returns all available market lines and current prices in one response. get_top_events returns a curated topMatches array of integer event IDs alongside a config object with target and timestamp fields.
Live, Boosted, and Accumulator Data
get_live_events queries a 12-hour window centered on the current time and returns in-play events with scores, periods, and live odds — filtered optionally by sport_id. get_super_boost_odds exposes events with boosted (Cote Marite) pricing, including both original and boosted prices; the date parameter accepts YYYY-MM-DD format, but only today and tomorrow reliably return data. get_popular_superbets returns pre-built accumulator suggestions for a given date, each object containing popularSuperbetId, matchName, matchDate, and associated odds; future dates return an empty array.
Bet Builder Markets
get_bet_builder_markets takes an event_id and returns a structured markets array for that match, where each market object includes an id, name, and odds array — the building blocks for combining custom bet legs. This endpoint covers only events that have Bet Builder markets configured on Superbet.ro; not all events will have this data populated.
The Superbet API is a managed, monitored endpoint for superbet.ro — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when superbet.ro 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 superbet.ro 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 live odds tracker that monitors in-play price movements using
get_live_eventsfiltered by sport - Aggregate pre-match lines across all sports by combining
list_sportsIDs withget_sport_eventspagination - Alert users when boosted prices appear via
get_super_boost_oddsfor today and tomorrow - Display curated accumulator suggestions in a tipster app using
get_popular_superbetsdaily data - Reconstruct the full competition tree for navigation or filtering UI using
get_sport_competitions - Pull all available market lines for a single match with
get_event_oddsto power a detailed odds page - Identify featured matches to highlight using
get_top_eventstopMatches IDs
| 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 | 100 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 Superbet.ro have an official public developer API?+
What does `get_live_events` return beyond basic event metadata?+
get_live_events returns live event objects that include scores and periods fields in addition to standard metadata like matchName and matchDate. It automatically queries a 12-hour window around the current time, so no date parameters are needed. You can narrow results to a single sport by passing a sport_id.Are there date range limitations for boosted odds and accumulator data?+
get_super_boost_odds only returns data for today and tomorrow — dates further out return an empty array. get_popular_superbets covers today and recent past dates; querying future dates also returns an empty array. Plan polling schedules accordingly.Does the API cover historical match results or final scores?+
Is Bet Builder data available for every event?+
get_bet_builder_markets returns structured markets only for events that have Bet Builder coverage configured on Superbet.ro. Events without Bet Builder support will return an empty markets array. The API currently does not expose which events have Bet Builder available before you query them; you can fork it on Parse and revise to add a filtering or discovery endpoint for Bet Builder-eligible events.