Getting Started

Installation

To use SportsCardTool, first install it using pip:

pip install SportsCardTool

Usage

Scraping a year of data:

from SportsCardTool import grab_card_list, dump_data, grab_year_links

# Find All Cards for 2023 Season, returned as list of dictionaries
year_links = grab_year_links(["2023"])
card_list = grab_card_list(year_link)

# Create CSV to allow for manipulation via pandas
dump_data(mock_data, "2023_cards.csv")

Grabbing cards from scraped data

from SportsCardTool import QueryBuilder

qb = QueryBuilder()

# Construct query requesting Barry Bonds cards from 2000 with an autograph and a print run of 25 or 250
qb.add_item({"name": "Barry Bonds", "year": "2000", "auto": "True", "serial": "25,250"})

# Make request and return in form of tuple (list[dict], int)
data = qb.grab_data()

print(data[0])
[
   {
      "_id": "641f49185ee984b20a66ef77",
      "auto": true,
      "back_img": null,
      "front_img": null,
      "group": "fleer-ultra",
      "listing": "2000 Fleer Ultra Fresh Ink #11 Barry Bonds",
      "mem": false,
      "name": "Barry Bonds",
      "number": "11",
      "price": 0,
      "rc": false,
      "serial": 250,
      "set": "fleer-ultra-fresh-ink-baseball-trading-card-checklist",
      "team": "San Francisco Giants",
      "year": 2000
   },
   {
      "_id": "641f49185ee984b20a66f5f4",
      "auto": true,
      "back_img": null,
      "front_img": null,
      "group": "fleer-ultra",
      "listing": "2000 Fleer Ultra Fresh Ink #11 Barry Bonds",
      "mem": false,
      "name": "Barry Bonds",
      "number": "11",
      "price": 0,
      "rc": false,
      "serial": 250,
      "set": "fleer-ultra-fresh-ink-baseball-trading-card-checklist",
      "team": "San Francisco Giants",
      "year": 2000
   },
   {
      "_id": "641f49185ee984b20a674b2f",
      "auto": true,
      "back_img": null,
      "front_img": null,
      "group": "upper-deck",
      "listing": "2000 Upper Deck  Game Jersey Autograph Numbered #BB Barry Bonds",
      "mem": true,
      "name": "Barry Bonds",
      "number": "BB",
      "price": 0,
      "rc": false,
      "serial": 25,
      "set": "upper-deck-game-jersey-autograph-numbered-baseball-trading-card-checklist",
      "team": "San Francisco Giants",
      "year": 2000
   },
   {
      "_id": "641f49185ee984b20a678e31",
      "auto": true,
      "back_img": null,
      "front_img": null,
      "group": "upper-deck-pros-and-prospects",
      "listing": "2000 Upper Deck Pros and Prospects Game Jersey Autograph Gold #BB Barry Bonds",
      "mem": true,
      "name": "Barry Bonds",
      "number": "BB",
      "price": 0,
      "rc": false,
      "serial": 25,
      "set": "upper-deck-pros-and-prospects-game-jersey-autograph-gold-baseball-trading-card-checklist",
      "team": "San Francisco Giants",
      "year": 2000
   },
   {
      "_id": "641f49185ee984b20a67958c",
      "auto": true,
      "back_img": null,
      "front_img": null,
      "group": "sp-authentic",
      "listing": "2000 SP Authentic Chirography Gold #GBB Barry Bonds",
      "mem": false,
      "name": "Barry Bonds",
      "number": "GBB",
      "price": 0,
      "rc": false,
      "serial": 25,
      "set": "sp-authentic-chirography-gold-baseball-trading-card-checklist",
      "team": "San Francisco Giants",
      "year": 2000
   }
]