punters-client 1.0.0b8

Scraping Meets

Meets represent a collection of races occurring at a given track on a given date. To scrape a list of meets occurring on a specified date, execute the following code in your Python interpreter:

>>> from datetime import datetime
>>> date = datetime(2016, 2, 1)
>>> meets = scraper.scrape_meets(date)

The scrape_meets method will return a list of dictionaries representing all meets occurring in Australia on the specified date. Accordingly, a meet’s details can be accessed as follows:

>>> meet = meets[index]
>>> track = meet['track']

Scraping Races

Races represent a collection of runners competing in a single event at a meet. To scrape a list of races occurring at a specified meet, execute the following code in your Python interpreter:

>>> races = scraper.scrape_races(meet)

The scrape_races method will return a list of dictionaries representing all races occurring at the specified meet. Accordingly, a race’s details can be accessed as follows:

>>> race = races[index]
>>> number = race['number']

Scraping Runners

Runners represent a single combination of horse, jockey and trainer competing in a race. To scrape a list of runners competing in a specified race, execute the following code in your Python interpreter:

>>> runners = scraper.scrape_runners(race)

The scrape_runners method will return a list of dictionaries representing all runners occurring at the specified race. Accordingly, a runner’s details can be accessed as follows:

>>> runner = runners[index]
>>> number = runner['number']

Scraping Horses, Jockeys and Trainers

Horses, jockeys and trainers represent the distinct components of a runner. To scrape the profile for a runner’s horse, jockey or trainer, execute the following code in your Python interpreter as appropriate:

>>> horse = scraper.scrape_horse(runner)
>>> jockey = scraper.scrape_jockey(runner)
>>> trainer = scraper.scrape_trainer(runner)

The scrape_horse, scrape_jockey and scrape_trainer methods all return a dictionary representing the horse/jockey/trainer’s profile. Accordingly, profile details can be accessed as follows:

>>> name = horse['name']
>>> name = jockey['name']
>>> name = trainer['name']

Scraping Performances

Performances represent the results of completed runs for a horse/jockey. To scrape a list of performances for a given horse/jockey, execute the following code in your Python interpreter as appropriate:

>>> performances = scraper.scrape_performances(horse)
>>> performances = scraper.scrape_performances(jockey)

NOTE: Due to the sheer volume of performances associated with any given jockey, it is only possible to recover a short and incomplete list of the most recent performances as at the time of scraping from www.punters.com.au. This should not be an issue with most horses.

The scrape_performances method returns a list of dictionaries representing the past performances for the specified horse/jockey. Accordingly, a performance’s details can be accessed as follows:

>>> performance = performances[index]
>>> result = performance['result']