czapi 0.0.3

CurlingZone scraper API.

Welcome to czapi

A basic API for scraping curling boxscores off of the popular CurlingZone website.

Install

pip install czapi

How to use

import czapi.api as api

General Information

Event & game information can be accessed in two ways.

1. Using the game id (cz_game_id) as provided by CurlingZone.
2. Using the event id (cz_event_id) as provided by CurlingZone.
   • If using the event id for boxscores, the draw id (cz_draw_id) and game number (game_number) must also be provided.

Event Details

Here is an example of getting event details using both methods mentioned above.

event_name = api.get_event_name(cz_event_id = 6100)
event_name

'Curling Night in America'

event_date = api.get_event_date(cz_game_id = 253869)
event_date

'Aug 22 - 24, 2019'

Boxscore

Here is an example of getting the boxscore information using only the game id.

game_result_dict = api.get_full_boxscore(cz_game_id = 271145)
game_result_dict

{'Wayne Tuck Jr.': {'href': 'event.php?view=Team&eventid=6400&teamid=144353&profileid=12486#1',
  'hammer': True,
  'score': ['0', '2', '0', '0', '0', '0', '1', '1', '1', '0'],
  'finalscore': '5',
  'date': 'Jan 17 - 19, 2020',
  'event': 'Ontario Tankard - Open Qualifier',
  'hash': '91877086316aa83ea479d50515bddaaac92bcb34e4f6611c3b893de32dd8c9fe'},
 'Matthew Hall': {'href': 'event.php?view=Team&eventid=6400&teamid=144347&profileid=12435#1',
  'hammer': False,
  'score': ['0', '0', '4', '0', '0', '1', '0', '0', '0', '2'],
  'finalscore': '7',
  'date': 'Jan 17 - 19, 2020',
  'event': 'Ontario Tankard - Open Qualifier',
  'hash': '91877086316aa83ea479d50515bddaaac92bcb34e4f6611c3b893de32dd8c9fe'}}

Output above should match the results from here.

Here is an example of getting the boxscore information using the event id, draw id and game number.

another_game_result_dict = api.get_full_boxscore(cz_event_id = 6100, cz_draw_id = 3, game_number = 1)
another_game_result_dict

{'Joel Retornaz': {'href': 'event.php?view=Team&eventid=6100&teamid=136100&profileid=12467#1',
  'hammer': False,
  'score': ['0', '1', '0', '1', '1', '0', '2', '0'],
  'finalscore': '5',
  'date': 'Aug 22 - 24, 2019',
  'event': 'Curling Night in America',
  'hash': '7055aa6331cda8edb23322869371a3e3e9cefc0830e63a64ca363ee0a8d716c0'},
 'John Shuster': {'href': 'event.php?view=Team&eventid=6100&teamid=136086&profileid=12473#1',
  'hammer': True,
  'score': ['1', '0', '1', '0', '0', '2', '0', '3'],
  'finalscore': '7',
  'date': 'Aug 22 - 24, 2019',
  'event': 'Curling Night in America',
  'hash': '7055aa6331cda8edb23322869371a3e3e9cefc0830e63a64ca363ee0a8d716c0'}}

Output above should match the results from here.

About czapi

czapi is a Python library for scraping curling linescores.