scryfall-api/devmugi.mtgcards.scryfall.api/CardsApi/search

search

suspend fun search(q: String, unique: UniqueModes? = null, order: SortingCards? = null, dir: SortDirection? = null, includeExtras: Boolean? = false, includeMultilingual: Boolean? = false, includeVariations: Boolean? = false, page: Int? = 1, format: String? = "json", pretty: Boolean? = false): ScryfallList<Card>

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. https://scryfall.com/docs/api/cards/search https://scryfall.com/docs/syntax

Parameters

A fulltext search query. Make sure that your parameter is properly encoded. Maximum length: 1000 Unicode characters.

unique

The strategy for omitting similar cards. See UniqueModes

order

The method to sort returned cards. See SortingCards

dir

The direction to sort returned cards. See SortDirection

includeExtras

If true, extra cards (tokens, planes, etc) will be included. Equivalent to adding include:extras to the fulltext search. Defaults to false.

includeMultilingual

If true, cards in every language supported by Scryfall will be included. Defaults to false.

includeVariations

If true, rare care variants will be included, like the Hairy Runesword. Defaults to false.

page

The page of results to return. Defaults to 1.

format

The data format to return: json or csv. Defaults to json.

pretty

If true, the returned JSON will be prettified. Avoid using for production code.