get_cards_by_search: Search for cards on Scryfall

In delabj/scryAnotherDay: A Wrapper for the Scryfall API

Description

Get a list of cards found using a fulltext search string. This string uses the same syntax as Scryfall's site This is pagenated, returning a maximum of 175 cards at a time

Usage

get_cards_by_search(
  q = "*",
  unique = "cards",
  order = "name",
  dir = "auto",
  include_extras = FALSE,
  include_variations = FALSE,
  page = 1,
  format = "csv",
  pretty = FALSE
)

Arguments

q	the string query using Scryfall Syntax
unique	the roll-up mode for removing duplicates. See details
order	the method to sort returned cards. See details
dir	direction to sort cards
include_extras	Should the search include extra cards (tokens, planes, vanguards, etc)
include_variations	Should rare card varients be included Defaults to false
page	the page to return defaults to 1
format	The format to return the data in. json or CSV
pretty	Should the JSON be prettified

Details

unique This parameter specifies if Scryfall should remove duplicate results in your query. The options are:

• "cards" (default): Removes duplicate game-play objects (cards that share a name and have the same functionality).

• "art" : Returns only one copy of each unique artwork for matching cards.

• "prints": Returns all prints for all cards matched (disables rollup).

order This parameter determines how Scryfall should sort the returned cards.

• "name" (default): by card name

• "set": by their set and collector number

• "released": by release date

• "rarity": by card Rarity

• "usd": by card lowest known US dollar price

• "tix": by lowest known TIX price

• "eur": by lowest known Euro price

• "cmc": by converted mana cost

• "power": by power

• "toughness": by toughness

• "edhrec": by edhrec ranking

• "artist" by front side artist name

Value

A list or data.frame depending on output selected

Examples

# Find Jace Planeswalker Cards

jace_pw_cards <- get_cards_by_search(
  'jace t:planeswalker',
  include_variations = TRUE,
  format = 'csv'
)

# Number Crunch lands between Creeping Tar Pit and Dark Depths

  lands_poss <- get_cards_by_search(
  'crunch>"creeping tar pit"
  crunch<"dark depths"
  f:vintage -in:ptk
  not:reserved',
  order = 'usd',
  format = 'csv'
)

# Get unique arts of a Card

unique_arts <- get_cards_by_search(
  'stone rain',
  format = 'csv',
  unique = 'art'
)

unique_prints <- get_cards_by_search(
  'giant spider',
  format = 'json',
  unique = 'prints'
)

delabj/scryAnotherDay documentation built on May 13, 2021, 9:22 p.m.