Aller au contenu
GET /v1/search

Search the card pool with Scryfall query syntax

Essayez-le en direct

10 appels gratuits par jour — sans inscription, sans clé API. Passe par la passerelle oanor.

En-têtes personnalisés (facultatif)
api.oanor.com/mtg-api

Ça marche. Récupérez une clé API et utilisez-la dans votre projet.

Obtenez une clé API

Extraits de code

curl "https://api.oanor.com/mtg-api/v1/search" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/mtg-api/v1/search", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/mtg-api/v1/search");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/mtg-api/v1/search",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "page": 1,
        "cards": [
            {
                "id": "dc36acc6-db4b-45b7-b526-7966ff82a44f",
                "cmc": 0,
                "set": "evg",
                "name": "Goblin Burrows",
                "image": "https://cards.scryfall.io/normal/front/d/c/dc36acc6-db4b-45b7-b526-7966ff82a44f.jpg?1562939268",
                "power": null,
                "artist": "David Martin",
                "colors": [],
                "prices": {
                    "eur": "0.49",
                    "tix": null,
                    "usd": "0.76",
                    "eur_foil": null,
                    "usd_foil": null,
                    "usd_etched": null
                },
                "rarity": "uncommon",
                "loyalty": null,
                "keywords": [],
                "set_name": "Duel Decks Anthology: Elves vs. Goblins",
                "mana_cost": "",
                "toughness": null,
                "type_line": "Land",
                "legalities": {
                    "tlr": "legal",
                    "duel": "legal",
                    "brawl": "not_legal",
                    "penny": "not_legal",
                    "predh": "legal",
                    "future": "not_legal",
                    "legacy": "legal",
                    "modern": "not_legal",
                    "pauper": "not_legal",
                    "alchemy": "not_legal",
                    "pioneer": "not_legal",
                    "vintage": "legal",
                    "historic": "not_legal",
                    "standard": "not_legal",
                    "timeless": "not_legal",
                    "commander": "legal",
                    "gladiator": "not_legal",
                    "oldschool": "not_legal",
                    "premodern": "legal",
                    "oathbreaker": "legal",
                    "standardbrawl": "not_legal",
                    "paupercommander": "not_legal"
                },
                "oracle_text": "{T}: Add {C}. {1}{R}, {T}: Target Goblin creature gets +2/+0 until end of turn.",
                "released_at": "2014-12-05",
                "scryfall_uri": "https://scryfall.com/card/evg/58/goblin-burrows?utm_source=api",
                "color_identity": [
                    "R"
                ],
                "collector_number": "58"
            },
            {
                "id": "ca8a24e8-5305-46cf-8c5a-b5324c59bb97",
                "cmc": 0,
                "set": "sunf",
                "name": "Goblin Coward Parade",
                "image": "https://cards.scryfall.io/normal/front/c/a/ca8a24e8-5305-46cf-8c5a-b5324c59bb97.jpg?1675457084",
                "power": null,
                "artist": "Larissa Hasenheit & Mina Jeon",
                "colors": [],
                "prices": {
                    "eur": "0.21",
                    "tix": null,
                    "usd": "0.24",
                    "eur_foil": null,
                   
…