GET /cards/autocomplete
Supported formats: json
Returns a Catalog object containing up to 20 full English card names that could be autocompletions of the given string parameter.
This method is designed for creating assistive UI elements that allow users to free-type card names.
The names are sorted with the nearest match first, highly favoring results that begin with your given string.
Spaces, punctuation, and capitalization are ignored.
If q
is less than 2 characters long, or if no names match,
the Catalog will contain 0 items (instead of returning any errors).
Parameter | Type | Atn | Details |
---|---|---|---|
q
|
String | The string to autocomplete. | |
format
|
String | Optional |
The data format to return. This method only supports json .
|
pretty
|
Boolean | Optional | If true, the returned JSON will be prettified. Avoid using for production code. |
include_extras
|
Boolean | Optional | If true, extra cards (tokens, planes, vanguards, etc) will be included. Defaults to false. |
Example Request
Autocomplete the string thal
GET
https://api.scryfall.com/cards/autocomplete?q=thal