Card
A scooze CardModel is a database representation of a Magic: the Gathering card closely following the
Scryfall schema using Pydantic models for
data validation.
scooze.models.card
¶
CardModelData
¶
Bases: ScoozeBaseModel
A data model that supports all fields available from Scryfall's JSON data. Represents a specific printing of a card.
Attributes:
| Name | Type | Description |
|---|---|---|
arena_id |
int | None
|
This card's Arena ID, if applicable. |
scryfall_id |
str | None
|
Scryfall's unique ID for this card. |
lang |
Language | None
|
The language code for this print; see here |
mtgo_id |
int | None
|
This card's MTGO Catalog ID, if applicable. |
mtgo_foil_id |
int | None
|
This card's foil MTGO Catalog ID, if applicable. |
multiverse_ids |
list[int] | None
|
This card's multiverse IDs on Gatherer, if any. |
tcgplayer_id |
int | None
|
This card's ID on TCGplayer, or |
tcgplayer_etched_id |
int | None
|
This card's ID on TCGplayer, for the etched version if that is a separate product. |
cardmarket_id |
int | None
|
This card's ID on Cardmarket, or |
oracle_id |
str | None
|
A UUID for this card's oracle identity; shared across prints of the same card but not same-named objects with different gameplay properties. |
prints_search_uri |
str | None
|
A link to begin paginating through all prints of this card in Scryfall's API. |
rulings_uri |
str | None
|
A link to rulings for this card in Scryfall's API. |
scryfall_uri |
str | None
|
A link to the Scryfall page for this card. |
uri |
str | None
|
A link to this card in Scryfall's API. |
all_parts |
list[RelatedCardModel] | None
|
RelatedCards for tokens/meld pairs/other associated parts to this card, if applicable. |
card_faces |
list[CardFaceModel] | None
|
All component CardFaces of this card, for multifaced cards. |
cmc |
float | None
|
This card's mana value/converted mana cost. |
color_identity |
set[Color] | None
|
This card's color identity, for Commander variant deckbuilding. |
color_indicator |
set[Color] | None
|
color_indicator: The colors in this card's color indicator, if it has one. |
colors |
set[Color] | None
|
This card's colors. |
edhrec_rank |
int | None
|
This card's rank/popularity on EDHREC, if applicable. |
hand_modifier |
str | None
|
This card's Vanguard hand size modifier, if applicable. |
keywords |
set[str] | None
|
Keywords and keyword actions this card uses. |
legalities |
dict[Format, Legality] | None
|
Formats and the legality status of this card in them. |
life_modifier |
str | None
|
This card's Vanguard life modifier value, if applicable. |
loyalty |
str | None
|
This card's starting planeswalker loyalty, if applicable. |
mana_cost |
str | None
|
Mana cost, as string of mana symbols. (e.g. "{1}{W}{U}{B}{R}{G}") |
name |
str | None
|
This card's name. |
oracle_text |
str | None
|
This card's oracle text, if any. |
penny_rank |
int | None
|
This card's rank/popularity on Penny Dreadful. |
power |
str | None
|
Power of this card, if applicable. |
produced_mana |
set[Color] | None
|
Which colors of mana this card can produce. |
reserved |
bool | None
|
Whether this card is on the Reserved List. |
toughness |
str | None
|
Toughness of this card, if applicable. |
type_line |
str | None
|
This card's type line. (e.g. "Creature — Ooze") |
artist |
str | None
|
Artist for this card. |
artist_ids |
list[str] | None
|
List of Scryfall IDs for artists of this card. |
attraction_lights |
set[int] | None
|
Attraction lights lit on this card, if applicable. |
booster |
bool | None
|
Whether this card can be opened in booster packs. |
border_color |
BorderColor | None
|
Border color of this card, from among black, white, borderless, silver, and gold. |
card_back_id |
str | None
|
Scryfall UUID of the card back design for this card. |
collector_number |
str | None
|
This card's collector number; can contain non-numeric characters. |
content_warning |
bool
|
True if use of this print should be avoided; see here |
digital |
bool | None
|
True if this card was only released in a video game. |
finishes |
set[Finish] | None
|
Finishes this card is available in, from among foil, nonfoil, and etched. |
flavor_name |
str | None
|
Alternate name for this card, such as on Godzilla series. |
flavor_text |
str | None
|
Flavor text on this card, if any. |
frame_effects |
set[FrameEffect] | None
|
Special frame effects on this card; see here |
frame |
Frame | None
|
This card's frame layout; see here |
full_art |
bool | None
|
Whether this print is full-art. |
games |
set[Game] | None
|
Which games this print is available on, from among paper, mtgo, and arena. |
highres_image |
bool | None
|
Whether this card has a high-res image available. |
illustration_id |
str | None
|
A UUID for the particular artwork on this print, consistent across art reprints. |
image_status |
ImageStatus | None
|
The quality/status of images available for this card. Either missing, placeholder, lowres, or highres_scan. |
image_uris |
ImageUrisModel | None
|
Links to images of this card in various qualities. |
layout |
Layout | None
|
This card's printed layout; see here |
oversized |
bool | None
|
Whether this card is oversized. |
preview |
PreviewModel | None
|
Information about where, when, and how this print was previewed. |
prices |
PricesModel | None
|
Prices for this card on various marketplaces. |
printed_name |
str | None
|
Printed name of this card, for localized non-English cards. |
printed_text |
str | None
|
Printed text of this card, for localized non-English cards. |
printed_type_line |
str | None
|
Printed type line of this card, for localized non-English cards. |
promo |
bool | None
|
Whether this print is a promo. |
promo_types |
set[str] | None
|
Which promo categories this print falls into, if any. |
purchase_uris |
PurchaseUrisModel | None
|
Links to purchase this print from marketplaces. |
rarity |
Rarity | None
|
The rarity of this print. |
related_uris |
RelatedUrisModel | None
|
Links to this print's listing on other online resources. |
released_at |
date | None
|
The date this card was first released. |
reprint |
bool | None
|
Whether this print is a reprint from an earlier set. |
scryfall_set_uri |
str | None
|
Link to the Scryfall set page for the set of this print. |
security_stamp |
SecurityStamp | None
|
Security stamp on this card, if any. |
set_name |
str | None
|
Full name of the set this print belongs to. |
set_search_uri |
str | None
|
Link to Scryfall API to start paginating through this print's full set. |
set_type |
SetType | None
|
An overall categorization for each set, provided by Scryfall. |
set_uri |
str | None
|
Link to the set for this print in Scryfall's API. |
set_code |
str | None
|
Set code of the set this print belongs to. |
set_id |
str | None
|
UUID of the set this print belongs to. |
story_spotlight |
bool | None
|
Whether this print is a Story Spotlight. |
textless |
bool | None
|
Whether this print is textless. |
variation |
bool | None
|
Whether this card print is a variation of another card. |
variation_of |
str | None
|
Which card this object is a variant of, if any. |
watermark |
str | None
|
Watermark printed on this card, if any. |
CardModel
¶
scooze.models.cardparts
¶
ImageUrisModel
¶
Bases: ScoozeBaseModel
URIs of images associated with this model on Scryfall.
Attributes:
| Name | Type | Description |
|---|---|---|
png |
str | None
|
Full card, high quality image with transparent background and rounded corners. |
border_crop |
str | None
|
Full card image with corners and majority of border cropped out. |
art_crop |
str | None
|
Rectangular crop to just art box; may not be perfect for cards with strange layouts. |
large |
str | None
|
Large JPG image (672x936) |
normal |
str | None
|
Medium JPG image (488x860) |
small |
str | None
|
Small JPG image (146x204) |
CardFaceModel
¶
Bases: ScoozeBaseModel
A model for a single face of a multi-faced CardModel.
Multi-faced cards include MDFCs, split cards, aftermath, etc;
see here
Attributes:
| Name | Type | Description |
|---|---|---|
name |
str
|
Name of this face. |
artist |
str | None
|
Illustrator for art on this face. |
artist_id |
str | None
|
Scryfall ID for the artist of this face. |
cmc |
float | None
|
Mana value of this face. |
color_indicator |
set[Color] | None
|
Color indicator on this face, if any. |
colors |
set[Color] | None
|
Colors of this face. |
flavor_text |
str | None
|
Flavor text of this face, if any. |
illustration_id |
str | None
|
Scryfall illustration ID of this face, if any. |
image_uris |
ImageUrisModel | None
|
URIs for images of this face on Scryfall. |
layout |
Layout | None
|
Layout of this face, if any. |
loyalty |
str | None
|
Starting planeswalker loyalty of this face, if any. |
mana_cost |
str
|
Mana cost of this face. |
oracle_id |
str | None
|
Oracle ID of this face, for reversible cards. |
oracle_text |
str | None
|
Oracle text of this face, if any. |
power |
str | None
|
Power of this face, if any. |
printed_name |
str | None
|
Printed name of this face, for localized non-English cards. |
printed_text |
str | None
|
Printed text of this face, for localized non-English cards. |
printed_type_line |
str | None
|
Printed type line of this face, for localized non-English cards. |
toughness |
str | None
|
Toughness of this face, if any. |
type_line |
str | None
|
Type line of this face, if any. |
watermark |
str | None
|
Watermark printed on this face, if any. |
PricesModel
¶
Bases: ScoozeBaseModel
A model for all price data associated with a CardModel.
Attributes:
| Name | Type | Description |
|---|---|---|
usd |
float | None
|
Price in US dollars, from TCGplayer. |
usd_foil |
float | None
|
Foil price in US dollars, from TCGplayer. |
usd_etched |
float | None
|
Etched foil price in US dollars, from TCGplayer. |
eur |
float | None
|
Price in Euros, from Cardmarket. |
eur_foil |
float | None
|
Foil price in Euros, from Cardmarket. |
tix |
float | None
|
Price in MTGO tix, from Cardhoarder. |
PreviewModel
¶
Bases: ScoozeBaseModel
A model for information about where and when a card was previewed.
Attributes:
| Name | Type | Description |
|---|---|---|
previewed_at |
date | None
|
Date/time of preview being shown or added to Scryfall. |
source |
str | None
|
Name of preview source. |
source_uri |
str | None
|
Location of preview source. |
PurchaseUrisModel
¶
Bases: ScoozeBaseModel
URIs to this card's listings on major marketplaces.
Attributes:
| Name | Type | Description |
|---|---|---|
tcgplayer |
str | None
|
Link to buy this card on the TCGplayer marketplace. |
cardmarket |
str | None
|
Link to buy this card on the Cardmarket marketplace. |
cardhoarder |
str | None
|
Link to buy this card digitally for MTGO on Cardhoarder. |
RelatedCardModel
¶
Bases: ScoozeBaseModel
Data about Scryfall objects related to this card (tokens, cards referenced by name, meld pairs, etc.)
Attributes:
| Name | Type | Description |
|---|---|---|
name |
str
|
Name of linked component. |
scryfall_id |
str
|
ID of linked component. |
component |
Component
|
One of |
type_line |
str
|
Type line of linked component. |
uri |
str
|
URI of linked component. |
RelatedUrisModel
¶
Bases: ScoozeBaseModel
Links to information about a Scryfall-based card object on other non-Scryfall resources.
Attributes:
| Name | Type | Description |
|---|---|---|
edhrec |
str | None
|
Link to EDHREC |
gatherer |
str | None
|
Link to gatherer.wizards.com |
tcgplayer_infinite_articles |
str | None
|
|
tcgplayer_infinite_decks |
str | None
|