Betexplorer APIBetexplorer.com ↗
Search upcoming football matches across multiple dates and instantly compare 1X2 betting odds from BetExplorer to find the best lines for your picks. Access daily match schedules with real-time odds data to help inform your betting decisions.
curl -X GET 'https://api.parse.bot/scraper/5daf70d1-eaad-46ba-afbb-c57c0d5ebc3e/search_matches?date=2026-07-24' \ -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 betexplorer-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.
"""Walkthrough: BetExplorer SDK — bounded, re-runnable; every call capped."""
from parse_apis.betexplorer_com_api import BetExplorer, InvalidDate
client = BetExplorer()
# Search today's football matches with odds
for match in client.matches.search(limit=3):
print(match.home_team, "vs", match.away_team, "| Odds:", match.odds_home, match.odds_draw, match.odds_away)
# Search a specific date
match = client.matches.search(date="2026-07-24", limit=1).first()
if match:
print(match.country, match.league, match.home_team, match.away_team, match.score, match.status)
# Handle invalid date input
try:
client.matches.search(date="not-a-date", limit=1).first()
except InvalidDate as e:
print("invalid date:", e)
print("exercised: matches.search")
Retrieve all football matches scheduled or completed for a given date, grouped by country and league. Each match includes home/away teams, match status (FIN, upcoming time, live minute), final score when available, and 1X2 betting odds (home win, draw, away win). Results cover all leagues worldwide for the requested day. Odds are average closing odds; upcoming matches or reserve-league matches may have null odds.
| Param | Type | Description |
|---|---|---|
| date | string | Date to retrieve matches for, ISO format YYYY-MM-DD. Defaults to today (UTC). |
{
"type": "object",
"fields": {
"date": "the date queried, ISO format YYYY-MM-DD",
"matches": "array of match objects with event_id, country, league, home_team, away_team, time, status, score, odds_home, odds_draw, odds_away"
},
"sample": {
"data": {
"date": "2026-07-24",
"matches": [
{
"time": "",
"score": "3:0",
"league": "CECAFA Kagame Cup",
"status": "FIN",
"country": "Africa",
"event_id": "QgLJobgJ",
"away_team": "CF GR/SIAF",
"home_team": "Vipers",
"odds_away": "6.25",
"odds_draw": "3.55",
"odds_home": "1.45"
},
{
"time": "",
"score": "2:1",
"league": "Liga Profesional",
"status": "FIN",
"country": "Argentina",
"event_id": "pSjL3djo",
"away_team": "Rosario Central",
"home_team": "Belgrano",
"odds_away": "2.97",
"odds_draw": "2.91",
"odds_home": "2.57"
},
{
"time": "21:45",
"score": null,
"league": "Liga Profesional",
"status": "",
"country": "Argentina",
"event_id": "MosWPn7m",
"away_team": "Central Cordoba",
"home_team": "Gimnasia Mendoza",
"odds_away": null,
"odds_draw": null,
"odds_home": null
}
]
},
"status": "success"
}
}About the Betexplorer API
The Betexplorer API on Parse exposes 1 endpoint for the publicly available data on Betexplorer.com. Calls return JSON over HTTPS and are billed per successful response.
Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.