football.com APIwww.football.com ↗
Access prematch events, live scores, and detailed betting markets from football.com via 3 endpoints covering eFootball and football odds.
curl -X POST 'https://api.parse.bot/scraper/2c0cd3e4-e7a9-47ad-97d9-b2e8fd33b8e4/get_prematch_events' \
-H 'X-API-Key: $PARSE_API_KEY' \
-H 'Content-Type: application/json' \
-d '{}'Get upcoming prematch events for a given sport with pagination. Returns events grouped by tournament with betting odds for main markets (1X2, Over/Under, Double Chance).
| Param | Type | Description |
|---|---|---|
| page_num | integer | Page number for pagination. |
| sport_id | string | Sport identifier in sr:sport:<id> format. sr:sport:137 is eFootball, sr:sport:1 is Football. |
| page_size | integer | Number of events per page (1-100). |
{
"type": "object",
"fields": {
"events": "array of event objects with odds",
"page_num": "integer current page",
"page_size": "integer page size",
"more_events": "boolean indicating if more pages exist"
},
"sample": {
"events": [
{
"status": "Not start",
"game_id": "33278",
"markets": [
{
"id": "1",
"name": "1X2",
"outcomes": [
{
"id": "1",
"desc": "Home",
"odds": "2.30"
},
{
"id": "2",
"desc": "Draw",
"odds": "4.25"
},
{
"id": "3",
"desc": "Away",
"odds": "2.30"
}
]
}
],
"category": "GT Sports League",
"event_id": "sr:match:71930632",
"away_team": "Germany (Hulk)",
"home_team": "England (Rossi)",
"start_time": 1780730100000,
"tournament": "GT Leagues",
"total_markets": 2
}
],
"page_num": 1,
"page_size": 5,
"more_events": true
}
}About the football.com API
The football.com API provides 3 endpoints for retrieving betting odds, live scores, and match details from football.com's sports betting platform. The get_prematch_events endpoint returns upcoming events grouped by tournament with odds for markets like 1X2, Over/Under, and Double Chance, while get_live_events delivers real-time scores, current period, and live odds for in-progress matches. Both eFootball (sr:sport:137) and Football (sr:sport:1) are supported.
Prematch Events and Odds
get_prematch_events accepts a sport_id in sr:sport:<id> format, a page_num, and a page_size (1–100 events per page). The response returns an array of event objects grouped by tournament, each carrying odds for the main betting markets: 1X2, Over/Under, and Double Chance. The more_events boolean field tells you whether additional pages exist, making it straightforward to paginate through a full fixture list.
Event Details and Full Markets
get_event_details takes a single required event_id in sr:match:<id> format — obtainable from get_prematch_events — and returns the complete betting picture for that fixture. The response includes home_team, away_team, tournament, category, sport, start_time (epoch milliseconds), and a markets array. Each market object contains outcomes with individual odds and probabilities, and a market description. This is the endpoint to use when you need the full odds depth beyond the headline markets.
Live Events
get_live_events takes an optional sport_id and returns a total count alongside an events array. Each live event includes the current score, match period, time played, and current betting odds. The endpoint covers both eFootball and association football depending on the sport_id supplied, and reflects the state of matches at the time of the call.
- Display a live scoreboard for eFootball matches with current odds using get_live_events
- Build a pre-match odds aggregator by paginating through get_prematch_events for multiple sport IDs
- Monitor odds movement across 1X2 and Over/Under markets for upcoming fixtures
- Populate a tournament-grouped fixture calendar from the tournament field in prematch event responses
- Compare outcome probabilities across all available markets for a specific match using get_event_details
- Trigger alerts when a match transitions from prematch to live by cross-referencing get_prematch_events and get_live_events
| 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.