API Documentation

Scryfall provides a REST-like API for ingesting our card data programatically. The API exposes information available on the regular site in easy-to-consume formats.

Endpoint Details

The API is available at https://api.scryfall.com

API requests are only served over HTTPS, using TLS 1.0, 1.1, and 1.2. Requests will not be honored over plaintext HTTP.

The API uses UTF-8 character encoding for all responses. Many fields will include characters that are not in the ASCII range.

The API does not currently require any authentication: all methods are public.

Rate Limits and Good Citizenship

We kindly ask that you insert 50 – 100 milliseconds of delay between the requests you send to the server. (i.e., 10 requests per second on average).

We encourage you to cache the data you download from Scryfall or process it locally in your own database, at least for 24 hours. While we make incremental updates to card data daily, take note that:

  • We only update prices for cards once per day. Fetching card data more frequently than 24 hours will not yield new prices.
  • Updates to gameplay data (such as card names, Oracle text, mana costs, etc) are much less frequent. If you only need gameplay information, downloading card data once per week or right after set releases would most likely be sufficient.

Submitting excessive requests to the server may result in a HTTP 429 Too Many Requests status code. Continuing to overload the API after this point may result in a temporary or permanent ban of your IP address.

Disclaimer

The Scryfall API is provided AS IS, on an AS AVAILABLE basis. We make no guarantees about server uptime or the accuracy of any information provided.

The API may include information about the price of a card. Absolutely no guarantees are provided for this information. See stores for final prices.

The API may include information about the tournament legality of a card. Absolutely no guarantees are provided for this information. Please contact a local DCI Judge or Wizards of the Coast customer service for help with evaluating your deck for sanctioned events.

The literal and graphical information presented via the API about Magic: The Gathering, including card images, the mana symbols, and Oracle text, is copyright Wizards of the Coast, a subsidiary of Hasbro, Inc. Scryfall is not produced by, endorsed by, supported by, or affiliated with Wizards of the Coast.

If you build new software using Scryfall’s data, consider providing a disclaimer similar to the above statement with your product.