2018-10-28 05:49:01 +00:00
# **class** `scrython.cards.Collector()`
2018-10-28 05:52:40 +00:00
These docs will likely not be as detailed as the official Scryfall Documentation, and you should reference that for more information.
2018-10-28 05:49:01 +00:00
2018-10-28 05:52:40 +00:00
>In the event that a key isn't found or has been changed, you can access the full JSON output with the `scryfallJson` variable (`Collector().scryfallJson`).
2018-10-28 05:53:50 +00:00
2018-10-28 05:49:01 +00:00
## Args
|arg|type|description|
|:---:|:---:|:---:|
|lang|string, optional|Defaults to \'en\'. A 2-|
## Returns
N/A
## Raises
|exception type|reason|
|:---:|:---:|
|Exception|If the \'code\' parameter is not provided.|
|Exception|If the \'collector_number\' parameter is not provided.|
|Exception|If the object returned is an error.|
## Examples
```python
>>> card = scrython.cards.Collector(code="exo", collector_number="96")
>>> card.id()
```
## Methods
---
### `all_parts()`
```
This this card is closely related to other cards, this property will be an list with it
Returns:
list
```
---
### `arena_id()`
```
The Arena ID of the card, if any
Returns:
int: The Arena ID of the card, if any
```
---
### `artist()`
```
The artist of the card
Returns:
string
```
---
### `border_color()`
```
The color of the card border
Returns:
string
```
---
### `card_faces()`
```
If it exists, all parts found on a card's face will be found as an object from this list
Returns:
list
```
---
### `cmc()`
```
A float of the converted mana cost of the card
Returns:
float: The cmc of the card
```
---
### `collector_number()`
```
The collector number of the card
Returns:
string
```
---
### `color_identity()`
```
A list of strings with all colors found on the card itself
Returns:
list
```
---
### `color_indicator()`
```
An list of all colors found in this card's color indicator
Returns:
list
```
---
### `colors()`
```
A list of strings with all colors found in the mana cost
Returns:
list
```
---
### `digital()`
```
Returns True if the card is the digital version
Returns:
boolean
```
---
### `edhrec_rank()`
```
The rank of the card on edhrec.com
Returns:
int: The rank of the card on edhrec.co
```
---
### `flavor_text()`
```
The flavor text of the card, if any
Returns:
string
```
---
### `foil()`
```
True if this printing exists in a foil version
Returns:
boolean
```
---
### `frame()`
```
The year of the card frame
Returns:
string
2019-04-01 17:01:17 +00:00
```
---
2019-09-26 00:36:08 +00:00
### `frame_effects()`
2019-04-01 17:01:17 +00:00
```
The card's frame effect, if any. (miracle, nyxtouched, etc.)
Returns:
2019-09-26 00:36:08 +00:00
list: The card's frame effects.
2019-04-01 17:01:17 +00:00
2018-10-28 05:49:01 +00:00
```
---
### `full_art()`
```
Returns True if the card is considered full art
Returns:
boolean
```
---
2019-04-01 17:01:17 +00:00
### `games()`
2018-10-28 05:49:01 +00:00
```
2019-04-01 17:01:17 +00:00
A list of games that this card print is available in.
2018-10-28 05:49:01 +00:00
Returns:
2019-04-01 17:01:17 +00:00
array: A list of games
2018-10-28 05:49:01 +00:00
```
---
### `hand_modifier()`
```
This cards hand modifier value, assuming it's a Vanguard card
Returns:
string
```
---
### `highres_image()`
```
Determine if a card has a highres scan available
Returns:
boolean
```
---
### `id()`
```
A unique ID for the returned card object
Returns:
string
```
---
### `illustration_id()`
```
The related id of the card art
Returns:
string
```
---
### `image_uris()`
```
All image uris of the card in various qualities
2018-10-30 18:12:37 +00:00
An index and an image type must be supplied a single uri.
If the card has additional faces, the returned dict will
default to the front of the card.
2018-10-28 05:49:01 +00:00
Returns:
2018-10-30 18:12:37 +00:00
dict: If given no arguments
string: If given an index and image_type
Raises:
Exception: If given no index
KeyError: If the given image type is not a known type
2018-10-28 05:49:01 +00:00
```
---
### `lang()`
```
The language of the card
Returns:
string
```
---
### `layout()`
```
The image layout of the card. (normal, transform, etc)
Returns:
string
```
---
### `legalities()`
```
A dictionary of all formats and their legality
Returns:
dict
```
---
### `life_modifier()`
```
This is the cards life modifier value, assuming it's a Vanguard card
Returns:
string
```
---
### `loyalty()`
```
This card's loyalty. Some loyalties may be X rather than a number
Returns:
string
```
---
### `mana_cost()`
```
The full mana cost using shorthanded mana symbols
Returns:
string
```
---
### `mtgo_foil_id()`
```
The corresponding MTGO foil ID of the card
Returns:
integer: The Magic Online foil id of the card
```
---
### `mtgo_id()`
```
The official MTGO id of the of the card
Returns:
integer: The Magic Online id of the card
```
---
### `multiverse_ids()`
```
The official Gatherer multiverse ids of the card
Returns:
list
```
---
### `name()`
```
The oracle name of the card
Returns:
string
```
---
### `nonfoil()`
```
True if this printing does not exist in foil
Returns:
boolean
```
---
### `object()`
```
Returns the type of object it is
(card, error, etc)
Returns:
string
```
---
### `oracle_id()`
```
A unique ID for this card's oracle text
Returns:
string
```
---
### `oracle_text()`
```
The official oracle text of a card
Returns:
string
```
---
### `oversized()`
```
True if this printing is an oversized card
Returns:
boolean
```
---
### `power()`
```
The power of the creature, if applicable
Returns:
string
2019-04-01 17:01:17 +00:00
```
---
### `prices()`
```
Returns prices from modes `usd` , `usd_foil` , `eur` , and `tix`
Args:
mode (string): The prices to get
Raises:
KeyError: If the mode parameter does not match a known key
Returns:
float: The prices as a float
2018-10-28 05:49:01 +00:00
```
---
### `printed_name()`
```
If the card is in a non-English language, this will be the name as it appears on the card
Returns:
string
```
---
### `printed_text()`
```
If the card is in a non-English language, this will be the rules text as it appears on the card
Returns:
string
```
---
### `printed_type_line()`
```
If the card is in a non-English language, this will be the type line as it appears on the card
Returns:
string
```
---
### `prints_search_uri()`
```
A link to where you can begin paginating all re/prints for this card on Scryfall’
Returns:
string
2019-04-01 17:01:17 +00:00
```
---
### `promo()`
```
True if this card is a promotional print.
Returns:
boolean
2018-10-28 05:49:01 +00:00
```
---
### `purchase_uris()`
```
A dictionary of links to purchase the card
Returns:
dict
```
---
### `rarity()`
```
The rarity of the card
Returns:
string
```
---
### `related_uris()`
```
A dictionary of related websites for this card
Returns:
dict
2019-04-01 17:01:17 +00:00
```
---
### `released_at()`
```
The date this card was first released.
Returns:
string: The date in ISO format
2018-10-28 05:49:01 +00:00
```
---
### `reprint()`
```
Returns True if the card has been reprinted before
Returns:
boolean
```
---
### `reserved()`
```
Returns True if the card is on the reserved list
Returns:
boolean
```
---
### `rulings_uri()`
```
The API uri for the rulings of the card
Returns:
string
```
---
### `scryfall_set_uri()`
```
The full link to the set on Scryfall
Returns:
string
```
---
### `scryfall_uri()`
```
The full Scryfall page of the card
As if it was a URL from the site.
Returns:
string
```
---
### `set_code()`
```
The 3 letter code for the set of the card
Returns:
string
```
---
### `set_name()`
```
The full name for the set of the card
Returns:
string
```
---
### `set_search_uri()`
```
Same output as set_uri
Returns:
string
```
---
### `set_uri()`
```
The API uri for the full set list of the card
Returns:
string
```
---
### `story_spotlight()`
```
True if this card is featured in the story
Returns:
boolean
```
---
2019-04-01 17:01:17 +00:00
### `tcgplayer_id()`
2018-10-28 05:49:01 +00:00
```
2019-04-01 17:01:17 +00:00
The `productId` of the card on TCGplayer.
2018-10-28 05:49:01 +00:00
Returns:
2019-04-01 17:01:17 +00:00
integer: The TCGplayer id of the card
2018-10-28 05:49:01 +00:00
```
---
### `toughness()`
```
The toughness of the creature, if applicable
Returns:
string
```
---
### `type_line()`
```
The full type line of the card
Returns:
string
```
---
### `uri()`
```
The Scryfall API uri for the card
Returns:
string
```
---
### `watermark()`
```
The associated watermark of the card, if any
Returns:
string
```
