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.

https://www.strictlybetter.eu/api/obsoletes
https://www.strictlybetter.eu/api/obsoletes?page=2

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.


Searching

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

https://www.strictlybetter.eu/api/obsoletes/Lightning%20Strike
https://www.strictlybetter.eu/api/obsoletes/Lightning
https://www.strictlybetter.eu/api/obsoletes/Lightning?page=2


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.

https://www.strictlybetter.eu/api/functional_reprints

Throttling

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.


Legal

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.