Api Guide

The strictly better cards on this site can be retrieved and searched with API requests.

General stuff

Results are sent in json format with UTF-8 character encoding.

A maximum of 50 results per request are sent to limit the size of responses.
To retrieve the second page of your results append ?page=2 to end of your url.

All obsolete cards

Use following urls to get all obsolete cards.


You should treat the API entries with healthy skepticism as they are mainly inserted by the community.
To mitigate issues evaluate number of up/down votes and labels array of each entry in your own app.
You can find out more labels on About page.


You may also search for specific obsolete cards by appending their name to end of the url.
Partial matches are also supported.


Functional Reprints

Many cards have functional reprints. Eg. Llanowar Elves, Elvish Mystic and Fyndhorn Elves function just the same.
Use following url to find all cards that have functional reprints grouped by the functionality.

Note that cards with different types are not grouped as functionally equal.



All available API requests are throttled to prevent excessive use. Current limit is 100 requests per minute.
You may monitor your available requests with HTTP response headers X-RateLimit-Limit and X-RateLimit-Remaining.
If rate limit is exceeded, you will receive status code 429 and X-RateLimit-Reset header with timestamp when you may continue doing more requests.


You are free to use the API and it's results for any purpose for which I may not be held liable for.
However, you must still adhere to Wizards of the Coast Fan Content Policy.