Pricing

Pay per usage

Try for free

Go to Apify Store

Football Odds Scraper: Historical & Closing Lines, 40+ Books

Try for free

Football (soccer) odds from up to 42 bookmakers — 1X2, over/under, BTTS, Asian handicap — with opening and closing lines, no-vig consensus and line movement. Recent matches from 1,000+ competitions or full seasons of any league, odds history back to the mid-2000s. Scores, xG, goal events.

Pricing

Pay per usage

Rating

0.0

(0)

Developer

Sports Odds Lab

Actor stats

Bookmarked

Total users

Monthly active users

20 hours ago

Last modified

Categories

Developer tools

Automation

You can access the Football Odds Scraper: Historical & Closing Lines, 40+ Books programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in API & Integrations in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "0.2",
    "x-build-id": "jSsTSfAbiuJbmdCOX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/sports-odds-lab~football-odds-results/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-sports-odds-lab-football-odds-results",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/sports-odds-lab~football-odds-results/runs": {
      "post": {
        "operationId": "runs-sync-sports-odds-lab-football-odds-results",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/sports-odds-lab~football-odds-results/run-sync": {
      "post": {
        "operationId": "run-sync-sports-odds-lab-football-odds-results",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "mode": {
            "title": "What to scrape",
            "enum": [
              "recent",
              "seasons"
            ],
            "type": "string",
            "description": "Recent matches: every competition from up to 7 days back to 7 days ahead (upcoming matches with current odds). Full seasons: complete seasons of the leagues you list below, history back to about 2008 — add the leagues in the 'Full seasons' section.",
            "default": "recent"
          },
          "statuses": {
            "title": "Match status",
            "type": "array",
            "description": "Finished includes matches decided after extra time or penalties and awarded results. In 'Full seasons' mode only finished (and postponed/cancelled) matches exist.",
            "items": {
              "type": "string",
              "enum": [
                "finished",
                "scheduled",
                "live",
                "other"
              ],
              "enumTitles": [
                "Finished",
                "Scheduled",
                "Live",
                "Postponed / cancelled / abandoned"
              ]
            },
            "default": [
              "finished",
              "scheduled"
            ]
          },
          "daysBack": {
            "title": "Days back",
            "minimum": 0,
            "maximum": 7,
            "type": "integer",
            "description": "How many past days to include (0 = today only). Up to 7.",
            "default": 1
          },
          "daysAhead": {
            "title": "Days ahead",
            "minimum": 0,
            "maximum": 7,
            "type": "integer",
            "description": "How many upcoming days to include. Up to 7. Upcoming matches carry the current prices instead of closing lines.",
            "default": 0
          },
          "countries": {
            "title": "Countries",
            "type": "array",
            "description": "Optional. Country or region names as shown on Flashscore, e.g. England, Spain, Brazil, Europe (UEFA club and national-team competitions), World (friendlies, FIFA). Leave empty for every country.",
            "items": {
              "type": "string"
            }
          },
          "competitions": {
            "title": "Competitions",
            "type": "array",
            "description": "Optional. 'Country: Competition' as shown on Flashscore, e.g. 'England: Premier League', 'Spain: LaLiga', 'Europe: Champions League'. Stages are included automatically ('Argentina: Liga Profesional' also matches its Apertura and Clausura). A name without a country (e.g. 'Premier League') matches that name in every country.",
            "items": {
              "type": "string"
            }
          },
          "includeWomen": {
            "title": "Include women's football",
            "type": "boolean",
            "description": "Women's leagues, cups and national-team matches.",
            "default": true
          },
          "includeYouth": {
            "title": "Include youth and reserve teams",
            "type": "boolean",
            "description": "U17–U23, reserve, B-team and academy competitions.",
            "default": true
          },
          "leagues": {
            "title": "Leagues",
            "type": "array",
            "description": "'Country: League' as shown on Flashscore — e.g. 'England: Premier League', 'Spain: LaLiga', 'Germany: Bundesliga', 'Brazil: Serie A Betano', 'Europe: Champions League' — or the league's Flashscore URL. Every stage of a season is included (play-offs, championship and relegation groups).",
            "items": {
              "type": "string"
            }
          },
          "seasons": {
            "title": "Seasons",
            "type": "array",
            "description": "Optional. Seasons as the league names them: 2024-2025 for autumn–spring leagues, 2024 for calendar-year leagues (MLS, Brazil, Scandinavia). Leave empty to use 'Last seasons'.",
            "items": {
              "type": "string"
            }
          },
          "lastSeasons": {
            "title": "Last seasons",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "Used when Seasons is empty: the current season (matches played so far) plus this many minus one previous seasons. 5 = the current season and the four before it.",
            "default": 1
          },
          "markets": {
            "title": "Betting markets",
            "type": "array",
            "description": "Full-time markets to collect. 1X2 is always included — it shows which bookmakers priced the match.",
            "items": {
              "type": "string",
              "enum": [
                "1x2",
                "overUnder",
                "btts",
                "asianHandicap",
                "doubleChance"
              ],
              "enumTitles": [
                "1X2 (match result)",
                "Over/Under goals",
                "Both teams to score",
                "Asian handicap",
                "Double chance"
              ]
            },
            "default": [
              "1x2",
              "overUnder",
              "btts"
            ]
          },
          "overUnderLines": {
            "title": "Over/Under lines",
            "type": "array",
            "description": "Goal lines to return, e.g. 1.5, 2.5, 3.5. Enter 'all' for every line each bookmaker offers (0.5 to 6.5, quarter lines included).",
            "default": [
              "2.5"
            ],
            "items": {
              "type": "string"
            }
          },
          "asianHandicapLines": {
            "title": "Asian handicap lines",
            "enum": [
              "main",
              "all"
            ],
            "type": "string",
            "description": "The main line is the one whose consensus is closest to 50/50 (reported as ahLine; the opening main line as ahLineOpening).",
            "default": "main"
          },
          "bookmakers": {
            "title": "Only these bookmakers",
            "type": "array",
            "description": "Optional. Names or parts of names, e.g. bet365, Betano, Unibet. Leave empty for all available (up to 42).",
            "items": {
              "type": "string"
            }
          },
          "includeOdds": {
            "title": "Include odds",
            "type": "boolean",
            "description": "Opening and latest (closing) odds per bookmaker plus the no-vig consensus.",
            "default": true
          },
          "onlyWithOdds": {
            "title": "Skip matches without odds",
            "type": "boolean",
            "description": "Do not save (and do not pay for) matches that no bookmaker priced. About 1 in 5 matches, mostly amateur and youth football.",
            "default": true
          },
          "includeStats": {
            "title": "Include match statistics",
            "type": "boolean",
            "description": "xG, xGOT, xA, possession, shots, big chances, corners, passes, fouls, cards and more for finished and live matches (full detail for major competitions).",
            "default": true
          },
          "includeEvents": {
            "title": "Include goals and cards",
            "type": "boolean",
            "description": "Every goal with minute, scorer, assist and score after the goal; penalties (scored and missed), own goals, yellow and red cards.",
            "default": true
          },
          "maxMatches": {
            "title": "Max matches",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after saving this many matches (0 = no limit). A busy weekend day has 1,500+ matches; a full season of a top league 300–400.",
            "default": 0
          },
          "concurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 32,
            "type": "integer",
            "description": "Advanced. Higher is faster; the default is safe.",
            "default": 16
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Football Odds API — Historical & Closing Lines, 40+ Books OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for Football Odds Scraper: Historical & Closing Lines, 40+ Books from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

Football Odds Scraper: Historical & Closing Lines, 40+ Books API in Python

Football Odds Scraper: Historical & Closing Lines, 40+ Books API in JavaScript

Football Odds Scraper: Historical & Closing Lines, 40+ Books API through CLI

Football Odds Scraper: Historical & Closing Lines, 40+ Books API

Bet365 Live Odds & In-Play Data Scraper

sian.agency/bet365-live-odds-scraper

Scrape live Bet365 in-play betting odds, running scores, and pre-match lines across soccer, basketball, tennis, baseball, hockey, esports and more. Clean structured rows with Asian handicaps, over/under totals and match timers. Export directly to JSON, CSV or Excel.

SIÁN OÜ

Flashscore Betting Odds Extractor

extractify-labs/flashscore-matches-odds

Extract live and opening betting odds from Flashscore for football and basketball. Get odds by bookmaker, bet type, and match for odds comparison, arbitrage detection, and prediction models.

Extractify Labs

113

SportsLine Scraper - Odds, Expert Picks & Projections

parseforge/sportsline-scraper

Scrape SportsLine betting data across 16 leagues. Odds from seven sportsbooks per game, public betting splits, final scores with graded outcomes back to 2018, expert picks with writeups, futures, injuries and SportsLine model simulations.

ParseForge

Sports Betting Odds Scraper — NFL, NBA, Soccer, Tennis & Props

zhorex/sports-odds-aggregator

Keyless sports odds API: live and pre-match odds from Pinnacle and Bovada — moneyline, spreads, totals, specials, player props, de-vigged fair odds, line movement and best-price flags. NFL, College Football, MLB, NBA, NHL, UFC, tennis and soccer odds (Premier League, La Liga, Champions League).

Sami

149

Tennis Odds Scraper: Opening & Closing Lines, 40+ Bookmakers

tennis-odds-lab/tennis-odds-results

Every ATP, WTA, Challenger and ITF match with opening and closing match-winner odds from up to 42 bookmakers, no-vig consensus probabilities, line movement, scores and serve/return stats. Built for tennis models, CLV tracking and backtesting.

Tennis Odds Lab

Action Network Scraper - Odds, Splits & Props

parseforge/action-network-scraper

Scrape Action Network sports odds with public betting splits, line movement, player props, weather, injuries and ATS standings. NFL, NBA, MLB, NHL, NCAAF, soccer, UFC and tennis. No login, no API key, no proxy.

ParseForge

Sportsbook Review Scraper - NFL, NBA & MLB Odds, Betting Lines

parseforge/sportsbook-review-scraper

Scrape NFL, NBA, MLB, NHL and college odds from SportsbookReview. Point spreads, moneylines and totals from 5 sportsbooks, with opening lines, line movement, betting splits and history back to 2008.

ParseForge

ESPN Odds & Line Movement Scraper

incognito_mode/espn-odds-scraper

Betting lines for NFL, NBA, MLB, NHL, NCAA, WNBA and soccer, back to 2014 and up to 17 sportsbooks a game. Moneyline, spread and total with opening and closing prices, de-vigged fair odds, the book's hold, line movement, and how every bet settled — computed from the final score.

Elena Vance

BetExplorer Odds Scraper

parseforge/betexplorer-odds-scraper

Scrape BetExplorer matches with opening and closing odds, bookmaker counts, scores and decades of season archives. Export to CSV, Excel, JSON or XML.

ParseForge

Live Odds Scraper: NFL, NBA, MLB In-Play & Closing Lines

scrapersdelight/sports-odds-scraper

Opening, closing and current moneyline, spread and total for every game in American, decimal and fractional odds, plus the in-play line while a game runs and the graded result after it ends. NFL, NCAAF, NCAAB, NBA, MLB, NHL, WNBA and 20 soccer leagues. No API key, no browser.

Scrapers Delight

OddsPortal Scraper

piotrv1001/oddsportal-scraper

The OddsPortal Scraper extracts fixtures, results and betting odds from OddsPortal.com, capturing every bookmaker's price, average and best odds, payouts, final scores and full market books with opening and closing lines - ideal for betting models and odds backtesting.