This is the card search interface to a card database API. The API takes the search string and looks for a matching alias. If one isn't found it parses the string into search tags for various attributes and full-text search terms.
Any word with a colon in it is interpreted as a tag, and everything else that isn't part of a tag is a full text search term. A tag has a name which is the part before the colon and a value which is the part after the colon. The API will give warnings for tags that it doesn't recognize or values that it can't parse.
Tags can be negated by adding a ! to the beginning of the value. If you want the value to have spaces in it, you can quote it but the quote parsing is not very sophisticated. If the tag uses numeric values, you can include comparison operators (>, <=, etc...) in the value; equality is the default. You can also give the name of another numeric tag to do comparisons between attributes e.g. cost:<power.
Full text search terms are used to look for matches in the gametext, name, card number+set (e.g. 203CN, f2RR), traits and a couple of other things.
Human readable tag list
For a machine readable list, see the API documentation for /tags
- bonus (numeric) - point value for problems and troublemakers
- card_guid - this card's card_guid (this is more for other programs using the API)
- color - one of the six colors, "None" (troublemakers and other colorless cards), "Wild" (the show must go on) or one or more colors e.g. "Blue/White" for problems and color fixers. In the latter case, it's more of an affinity rather than a card color.
- cost (numeric) - the card's AT cost
- flavortext - flavor text, where present
- gametext - the card's game text (manes have Front: and Back: labels for either side's text)
- name - the card's full name (only, not short names or aliases)
- number - the number in the set
- power (numeric) - printed power
- prireq (numeric) - problem power requirement for the only/first color
- rarity - the card's rarity
- req (numeric) - the color requirement
- rev or revision - the revision to look in (this is special; see below)
- secreq (numeric) - problem power requirement for not-the-only/second color
- set - the set the card's from
- status - legality status (Harmony format)
- trait or traits - traits, usually separated by a comma though Enterplay messes this up sometimes
- type - the card's type
- wildreq or wild (numeric) - the problem power requirement for the opponent
The revision tag is special. If you don't specify one, the API assumes you want the live revision, which is the state of the game as you'd play it now.
Results are all cards which match all criteria. It's possible to specify tags more than once but if you give mutually exclusive criteria you get no results.
Examples
Note that there are NO SPACES between the tag and value
- cost:1 req:<=1 trait:pegasus
- gametext:"Reaction:" type:friend
- dismiss a resource
- color:orange power:>2 req:<=1
- wildreq:>7 bonus:<3
- rev:OCR2 the high ground