GET /cards/search

Supported formats: json and csv

Returns a List object containing Cards found using a fulltext search string. This string supports the same fulltext search system that the main site uses.

This methods is paginated, returning 175 cards at a time. Review the documentation for paginating the List type.

If only one card is found, this method will still return a List.

If using the json format, review the documentation for paginating the JSON List type, and the Error type type to understand all of the possible output from this method.

Parameter Type Atn Details
q String A fulltext search query. Make sure that your parameter is properly encoded.
order String Optional The order to sort returned cards: name, set, tix, usd, eur, cmc, pow, tou, rarity, color, or edhrec.
page Integer Optional The page number to return, default 1.
format String Optional The data format to return: json or csv. Defaults to json.
pretty Boolean Optional If true, the returned JSON will be prettified. Avoid using for production code.

Missing Luxuries

Note that this search endpoint is more strict than the user-facing search system on Scryfall. In particular:

  • On Scryfall’s website, if your search does not match any cards, the search system automatically retries with include:extras added. This API method does not automatically retry your search.
  • On Scryfall’s website, if your search is only for a set (example: e:set), the system automatically redirects you to the ++e:set page for that set. This API method does not automatically redirect you.
  • On Scryfall’s website, certain searches trigger additional user interface elements that suggest expanding your search coverage (with o:changeling or ++ for example). This API method does not have this suggestion behavior.
  • This API method will not provide help with spelling errors.

Example Requests

Find red creatures with 3 power, sorted by converted mana cost