odds API Python Client

Extract odds data with our odds API Python client. Get programmatic access to betting lines from BetMGM, Caesars, DraftKings, FanDuel, Bet365, sportsbook odds data, moneylines, point spreads, over/under totals, NFL, NBA, NHL, CFB, CBB, UCL, UFC leagues, and more using simple Python code. Start free, no credit card required.

Try odds API Python Client

Trusted by industry leaders all over the world

Integrate our odds API

The Apify API client for Python is the official library that allows you to use odds API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.

Python

JavaScript

HTTP

MCP

1from apify_client import ApifyClient
2
3# Initialize the ApifyClient with your Apify API token
4# Replace '<YOUR_API_TOKEN>' with your token.
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7# Prepare the Actor input
8run_input = {
9    "league": "NHL",
10    "sportsbook": "Consensus",
11}
12
13# Run the Actor and wait for it to finish
14run = client.actor("harvest/sportsbook-odds-scraper").call(run_input=run_input)
15
16# Fetch and print Actor results from the run's dataset (if there are any)
17print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
18for item in client.dataset(run["defaultDatasetId"]).iterate_items():
19    print(item)
20
21# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

odds API

odds API in JavaScript

odds MCP server

odds API in CLI

Get data with odds API Python client

Use our Python API client to extract comprehensive sportsbook odds data by providing league selection, optional date filters, team abbreviations, and sportsbook preferences. The API returns structured data, including team details, scheduled game times, moneylines, point spreads, over/under totals, current and opening odds, and best line indicators across multiple sportsbooks.

Input

{
 "date": "2024-11-28",
 "team": "MIA",
 "league": "NFL",
 "sportsbook": "DraftKings"
}

Output

[
 {
  "odds": [
   {
    "moneyLine": {
     "isBestAwayLine": true,
     "isBestHomeLine": false,
     "currentAwayOdds": "+145",
     "currentHomeOdds": "-175",
     "openingAwayOdds": "+130",
     "openingHomeOdds": "-155"
    },
    "overUnder": {
     "currentTotal": "47",
     "openingTotal": "48.5",
     "currentOverOdd": "-108",
     "isBestOverLine": true,
     "openingOverOdd": "-110",
     "currentUnderOdd": "-112",
     "isBestUnderLine": false,
     "openingUnderOdd": "-110"
    },
    "sportsbook": "draftkings",
    "pointSpread": {
     "isBestAwayLine": true,
     "isBestHomeLine": false,
     "currentAwayOdds": "-115",
     "currentHomeOdds": "-105",
     "openingAwayOdds": "-110",
     "openingHomeOdds": "-110",
     "currentAwayHandicap": "+3.5",
     "currentHomeHandicap": "-3.5",
     "openingAwayHandicap": "+3",
     "openingHomeHandicap": "-3"
    }
   }
  ],
  "awayTeam": {
   "abbr": "MIA",
   "location": "Miami",
   "nickName": "Dolphins",
   "shortName": "MIA",
   "mediumName": "Miami"
  },
  "homeTeam": {
   "abbr": "GB",
   "location": "Green Bay",
   "nickName": "Packers",
   "shortName": "GB",
   "mediumName": "Green Bay"
  },
  "scheduledTime": "2024-11-29T01:20:00Z"
 }
]

How to use odds API

Sign up for Apify account01

Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.

Get started for free

Install Apify Python client02

Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with odds API from your Python applications.

Get your Apify API token03

Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.

Integrate odds API04

Navigate to the odds API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more. Use the provided Python code examples to integrate odds API into your Python application.

Open odds Python API

Get your odds data via API05

The odds API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.

Why use Apify?

Never get blocked

Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.

Customers love us

We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.

Monitor your runs

With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.

Export to various formats

Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.

Integrate Apify to your workflow

You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.

Large developer community

Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!

Python-ready odds data extraction

Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.

Frequently asked questions

No, there is no official Python API client for sportsbook odds from the major betting platforms. This Apify Actor serves as an unofficial Python solution that scrapes odds data from BetMGM, Caesars, DraftKings, FanDuel, and Bet365 to provide comprehensive betting information in a structured format. The Python scraper operates within the terms of use of the sportsbooks' websites while respecting all applicable legal requirements.

Yes, you can try the sportsbook odds Python API client for free! Apify offers a free tier that allows you to test the Python client with limited usage. The Python API client connects to an Actor that has a base pricing of $25.00/month plus usage costs, but you can start with the free trial to explore the data extraction capabilities through the Python client and see if it meets your betting analysis or research needs before committing to a paid plan.

The Python odds API client provides comprehensive betting data including team information (names, abbreviations, locations), scheduled game times, moneylines with current and opening odds, point spreads with handicaps and odds, over/under totals with current and opening lines, and best line indicators. Data covers popular leagues like NFL, CFB, NBA, CBB, NHL, UCL, and UFC from major sportsbooks including BetMGM, Caesars, DraftKings, FanDuel, and Bet365.

Yes, it is legal to use a Python API client to access publicly available sportsbook odds data for personal use, research, and analysis purposes. This Python API client operates within the terms of use of the sportsbooks' websites and respects all applicable legal requirements. However, users should always ensure they comply with local laws and regulations regarding data usage, and consider the intended use of the data accessed through the Python API client, especially for commercial purposes.

Getting started with our odds Python API is easy — simply create a free Apify account, get your API token, and start using the odds API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.