Fetching Sports Data

Complete example of fetching available sports and retrieving sport-specific data from Bet365

This guide demonstrates how to fetch sports data from Bet365 using the Android API session. You’ll learn how to initialize a session, navigate to the homepage, extract available sports, and retrieve detailed data for a specific sport.

Complete Example

Here’s a full working example based on the SDK’s main implementation:

import json
from bet365 import Bet365AndroidSession

# Load configuration
with open("config.json", encoding="utf8") as fp:
    config = json.load(fp)

print("Fetching soccer page using android api")

# Initialize session
session = Bet365AndroidSession(
    config["api_url"],
    config["api_key"],
    proxy=config["proxy"] or None,
    verify=False,
    host="www.bet365.com",
)

# Navigate to homepage
print("Going to homepage...")
session.go_homepage()

# Extract available sports
sports = session.extract_available_sports()

# Find soccer and get its data
soccer = next(filter(lambda m: m.name == "Soccer", sports))
session.get_sport_homepage(soccer)

# Wait for background threads to complete
if session.zap_thread is not None:
    session.zap_thread.join()

Step-by-Step Workflow

1. Initialize the Session

   Create a Bet365AndroidSession instance with your API credentials and configuration:

   session = Bet365AndroidSession(
       api_url="https://your-api-url.com",
       api_key="your_api_key",
       proxy="http://proxy:port",  # Optional
       verify=False,
       host="www.bet365.com"
   )
   

   The session automatically configures TLS fingerprinting to mimic Android app requests.

2. Go to Homepage

   Navigate to the Bet365 homepage to initialize cookies and configuration:

   session.go_homepage()
   

   This method:

   • Fetches the homepage HTML
   • Retrieves site configuration
   • Sets up necessary cookies (usdi, pstk)
   • Extracts the SST token for subsequent requests

   This step may take longer than expected due to curl_cffi initialization.

3. Extract Available Sports

   Retrieve the list of all available sports:

   sports = session.extract_available_sports()
   
   # Sports is a list of Sport objects
   for sport in sports:
       print(f"Name: {sport.name}, PD: {sport.PD}")
   

   Each Sport object contains:

   • name: The sport’s display name (e.g., “Soccer”, “Tennis”, “Basketball”)
   • PD: The sport’s path descriptor for API requests
4. Get Sport-Specific Data

   Fetch detailed data for a specific sport:

   # Find the sport you want
   soccer = next(filter(lambda m: m.name == "Soccer", sports))
   
   # Get sport homepage data
   session.get_sport_homepage(soccer)
   

   This retrieves “splash pods” containing:

   • Match listings
   • Betting markets
   • Odds data
   • Competition information
5. Process the Results

   The get_sport_homepage() method automatically parses the response and extracts match tables:

   # The method internally:
   # 1. Fetches splash pods for the sport
   # 2. Parses the response using get_parsers()
   # 3. Finds match sections with find_sections()
   # 4. Reads tables with read_table()
   # 5. Pretty prints and returns formatted data
   

   Match data is also saved to response.txt for debugging purposes.

Configuration File Format

Create a config.json file with the following structure:

{
  "api_url": "https://your-api-endpoint.com",
  "api_key": "your_api_key_here",
  "proxy": "http://proxy-server:port"
}

Set proxy to null or empty string if you don’t need a proxy.

Expected Output

When you run the script, you’ll see:

1. Session initialization confirmation
2. Homepage navigation status
3. Available sports list with names and PD values
4. Pretty-printed tables showing:
   • Match names
   • Betting markets
   • Odds values
   • Competition details

Common Use Cases

Fetch Multiple Sports

sports = session.extract_available_sports()

# Process multiple sports
for sport_name in ["Soccer", "Tennis", "Basketball"]:
    sport = next((s for s in sports if s.name == sport_name), None)
    if sport:
        print(f"Fetching {sport_name}...")
        session.get_sport_homepage(sport)

Next Steps

• Learn how to parse response data
• Implement error handling for robust scraping
• Explore the API Reference for more methods