Oddspedia APIoddspedia.com ↗
Access Oddspedia data via API: sure bets, value bets, dropping odds, match info, and odds comparison across dozens of bookmakers and multiple sports.
What is the Oddspedia API?
The Oddspedia API exposes 10 endpoints covering arbitrage opportunities, value bets, odds movements, and match metadata across sports including football, basketball, tennis, and ice hockey. The get_surebets endpoint returns live arbitrage opportunities sorted by profit percentage, while get_value_bets surfaces mathematically overpriced odds, and get_odds_comparison delivers a full bookmaker-by-bookmaker breakdown for any specific match and market.
curl -X GET 'https://api.parse.bot/scraper/a6aad0cf-30f9-40ae-81b9-d90b84c0e01f/get_surebets?language=en&profit_range=1.00%2C1000.00' \ -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 oddspedia-com-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.
"""
Oddspedia API - Usage Example
Get your API key from: https://parse.bot/settings
"""
from parse_apis.oddspedia_api import Oddspedia, MarketGroupId
oddspedia = Oddspedia()
# List all available sports
for sport in oddspedia.sports.list():
print(sport.name, sport.slug, sport.count)
# Get leagues for football
football = oddspedia.sport("football")
for league in football.leagues.list(top_only="1"):
print(league.league_name, league.category_name, league.match_count_prematch)
# Browse today's matches for a sport
for summary in football.matches.list():
detail = summary.details()
print(detail.ht, "vs", detail.at, detail.league_name, detail.venue_name)
# Find arbitrage opportunities (sure bets)
for surebet in oddspedia.surebets.list(sports="1", profit_range="1.00,50.00"):
print(surebet.ht, "vs", surebet.at, surebet.payout, surebet.league_name)
# Get full odds comparison for this match
comparison = surebet.odds_comparison.get(market_group_id=MarketGroupId.HOME_AWAY)
for market in comparison.prematch:
print(market.name, market.oddsnames)
# Get value bets
for vbet in oddspedia.valuebets.list(overvalue_range="30.00,100.00"):
print(vbet.ht, "vs", vbet.at, vbet.overvalue, vbet.probability)
# Get dropping odds with automatic pagination
for drop in oddspedia.oddsdrops.list(drop_range="20.00,100.00"):
print(drop.ht, "vs", drop.at, drop.max_drop, drop.sport_name)
# Get hot bets based on team form
for hotbet in oddspedia.hotbets.list(min_percent=70):
print(hotbet.stats.combined_percentage, hotbet.max_odd.value, hotbet.match.match_key)
# Get detailed match info directly
match = oddspedia.matches.get(match_key="1956093")
print(match.ht, match.at, match.venue_name, match.venue_city, match.ht_form)
# List all bookmakers
for bookie in oddspedia.bookmakers.list():
print(bookie.name, bookie.slug, bookie.rating)
Extract arbitrage betting opportunities (sure bets) across bookmakers. Returns matches where combined odds across outcomes guarantee profit, sorted by profit percentage. Each surebet includes match details, league, sport, market type, and best odds from different bookmakers for each outcome.
| Param | Type | Description |
|---|---|---|
| sports | string | Comma-separated sport IDs to filter by (e.g. '1' for Football, '2' for Ice Hockey, '3' for Basketball). Omitting returns all sports. |
| geo_code | string | Two-letter country code for geo-targeted odds (e.g. 'US', 'GB'). Omitting returns global odds. |
| language | string | Language code for response content. |
| bookmakers | string | Comma-separated bookmaker IDs to filter by. Omitting returns all bookmakers. |
| profit_range | string | Min,max profit percentage range as two comma-separated decimal values. |
{
"type": "object",
"fields": {
"data": "array of surebet opportunities with match, odds, and payout details",
"sports": "array of available sports with event counts",
"markets": "array of market types with counts",
"bookmakers": "array of bookmaker references",
"generated_at": "string timestamp of response generation"
},
"sample": {
"data": {
"data": [
{
"at": "Red Bull Bragantino",
"ht": "Sporting Cristal",
"id": 10102495,
"md": "2026-07-23 00:30:00+00",
"odds": [
{
"type": "Over",
"values": [
{
"odd": "2.43",
"link": "https://example.com",
"bookie_name": "Unibet",
"bookie_slug": "unibet"
}
]
}
],
"payout": 111.63,
"ot_name": "Total Over/Under",
"handicap": "2.5",
"match_key": 1956093,
"group_name": "Over/Under",
"sport_name": "Football",
"sport_slug": "football",
"last_change": "2026-06-10 07:47:43",
"league_name": "Copa Sudamericana",
"league_slug": "copa-sudamericana",
"category_name": "South America"
}
],
"sports": [
{
"id": 1,
"name": "Football",
"slug": "football",
"count": 23
}
],
"markets": [
{
"id": 3,
"count": 17
}
],
"bookmakers": [
{
"id": 170,
"name": "Stake.com",
"slug": "stake-com"
}
],
"generated_at": "2026-06-10 07:48:56"
},
"status": "success"
}
}About the Oddspedia API
Arbitrage and Value Bet Data
The get_surebets endpoint returns an array of current arbitrage opportunities, each containing match identifiers, sport and league context, per-bookmaker odds for each outcome, and a calculated profit percentage. You can filter by comma-separated sport IDs (e.g. '1' for Football), a geo_code for region-specific odds, and a profit_range to target a specific margin band. The get_value_bets endpoint follows the same structure but focuses on bets where offered odds exceed calculated fair probability, with an overvalue_range filter and odds_min/odds_max bounds.
Odds Movement and Trending Bets
The get_dropping_odds endpoint tracks matches where odds have declined significantly within a chosen period, returning current and previous odds alongside bookmaker details. Pagination is supported via page, and drop_range lets you target specific movement thresholds. The get_hot_bets POST endpoint surfaces statistically trending bets based on team form and historical hit rates, returning full league and category structures, a total_success_rate, and per-bet bookmaker references. A min_percent integer (51–100) constrains results to bets meeting a combined success threshold.
Match and League Context
The get_match_info endpoint accepts a match_key from any listing endpoint and returns venue, team form, scores, season, weather, and league metadata for that fixture. The get_odds_comparison endpoint takes the same match_key plus an optional market_group_id (Moneyline, Spread, or Total) and returns the full odds grid keyed by period and bookmaker. Upstream match keys are shared across get_surebets, get_dropping_odds, get_value_bets, and get_hot_bets, so results can be cross-referenced directly.
Reference and Listing Endpoints
The get_sports_list endpoint returns all tracked sports with their IDs, slugs, and current sure-bet event counts — useful for populating sport filter values. The get_leagues_by_sport endpoint lists competitions per sport with match counts and an optional top_only flag. The get_bookmakers_list endpoint returns bookmaker IDs, names, slugs, numeric ratings, user ratings, and brand colors, optionally filtered by geo_code. The get_matches_by_sport endpoint lists upcoming and live matches for a sport on a single calendar day, returning max odds and bookmaker details keyed by match ID.
The Oddspedia API is a managed, monitored endpoint for oddspedia.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when oddspedia.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 oddspedia.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 an arbitrage alert system using
get_surebetsfiltered byprofit_rangeand bookmaker IDs. - Track odds drift over time by polling
get_dropping_oddsfor specific sports anddrop_rangethresholds. - Populate a value-bet dashboard using
get_value_betswithovervalue_rangeandodds_min/odds_maxbounds. - Enrich betting data with venue, team form, and weather by calling
get_match_infofor eachmatch_key. - Compare full bookmaker grids for a given match using
get_odds_comparisonwith Moneyline, Spread, or Total market groups. - Filter available bookmakers by region with
get_bookmakers_listusing ageo_codefor market-specific coverage. - List today's fixtures for a sport and their current max odds using
get_matches_by_sportwith astart_date/end_datewindow.
| 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 Oddspedia have an official developer API?+
What does `get_surebets` return, and can I filter it by region?+
geo_code (two-letter country code) to receive region-specific odds, by sports to limit to certain sport IDs, and by bookmakers to restrict which bookmakers appear. A profit_range parameter accepts min and max decimal values.Does the API cover historical odds data or only current opportunities?+
get_dropping_odds tracks movements over up to one day (period: '1day'), and get_matches_by_sport is limited to a single calendar day per request. Historical odds archives are not currently exposed. You can fork this API on Parse and revise it to add historical data endpoints if that coverage is available on Oddspedia.Can I retrieve odds for in-play or live matches specifically?+
get_matches_by_sport returns both upcoming and live matches for the current day, and the odds data includes bookmaker details. There is no dedicated in-play-only filter parameter across the listing endpoints. You can fork this API on Parse and revise it to add an in-play filter endpoint.How do `match_key` values work across endpoints?+
match_key is a unique match identifier returned in the data arrays of get_surebets, get_dropping_odds, get_value_bets, and get_hot_bets. The same key is accepted by both get_match_info and get_odds_comparison, so you can chain any listing endpoint with detailed match or odds data without a separate lookup step.