{"openapi":"3.1.0","info":{"title":"Marvel Snap API","version":"1.0.0","description":"Marvel Snap card data as an API, built on the open snap.fan dataset for Second Dinner's hit mobile card game. Search and filter the full card pool by name, energy cost, power, series or card type, fetch any card by its key or name for its cost, power, ability text, collectible series and official art, and pull a random card. Real card data, no key needed upstream. Ideal for deck builders, card-search and collection tools, tier-list sites and Marvel Snap fan apps.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/marvelsnap-api","description":"oanor gateway"}],"tags":[{"name":"Marvel Snap"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/card":{"get":{"operationId":"get_v1_card","tags":["Marvel Snap"],"summary":"A single card by key or name","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Card name or key, e.g. Abomination","schema":{"type":"string"},"example":"Abomination"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"card":{"key":"Abomination","url":"/cards/Abomination/","cost":5,"name":"Abomination","image":"https://game-assets.snap.fan/card_variant_images/Abomination-1a5e6f63520f5b991a8000712f6ee5c99e8a5b1fdafc1c30e8016452894b58a5.webp","power":9,"series":"Starter","ability":"Foolish rabble! You are beneath me!","variants":11,"card_type":0,"is_released":true,"series_short":"Starter","is_collectable":true,"starts_in_hand":false}},"meta":{"timestamp":"2026-06-08T01:18:26.142Z","request_id":"7556491a-c522-414e-8fbd-100671f98b35"},"status":"ok","message":"Card retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cards":{"get":{"operationId":"get_v1_cards","tags":["Marvel Snap"],"summary":"Search & filter cards","description":"","parameters":[{"name":"name","in":"query","required":false,"description":"Name contains","schema":{"type":"string"}},{"name":"cost","in":"query","required":false,"description":"Energy cost, e.g. 1","schema":{"type":"string"},"example":"1"},{"name":"power","in":"query","required":false,"description":"Power value","schema":{"type":"string"}},{"name":"series","in":"query","required":false,"description":"Collectible series","schema":{"type":"string"}},{"name":"card_type","in":"query","required":false,"description":"Card type","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (default 30, max 200)","schema":{"type":"string"},"example":"30"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"cards":[{"key":"Agent13","url":"/cards/Agent13/","cost":1,"name":"Agent 13","image":"https://game-assets.snap.fan/card_variant_images/Agent13-13b8e1d703500e08840e9f30ac37fbcaa678a2554469d2c776cf25115a3f7099.webp","power":2,"series":"Series 2 (Collection Level 222-486)","ability":"On Reveal: Add a random card to your hand.","variants":13,"card_type":0,"is_released":true,"series_short":"Series 2","is_collectable":true,"starts_in_hand":false},{"key":"Agony","url":"/cards/Agony/","cost":1,"name":"Agony","image":"https://game-assets.snap.fan/card_variant_images/Agony-bc7a99adadd46713e87a1b57c81dfc7b7fb05dc08c15ecb86820018b071e140a.webp","power":2,"series":"Series 4","ability":"After you play a card here, merge this into it.","variants":4,"card_type":0,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"AmericaChavez","url":"/cards/AmericaChavez/","cost":1,"name":"America Chavez","image":"https://game-assets.snap.fan/card_variant_images/AmericaChavez-b5c51b4fa1a2a087d0900d9c5bdbac95b26515c1a1666b6f5f89773c636e10d9.webp","power":2,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: Give the top card of your deck +3 Power.","variants":18,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false},{"key":"AntMan","url":"/cards/AntMan/","cost":1,"name":"Ant Man","image":"https://game-assets.snap.fan/card_variant_images/AntMan-1fc54d6792e09d72aafbaeefdff87c9a9cfdee9979a3f54bcff90bf4ffac0df2.webp","power":1,"series":"Recruit Season","ability":"Ongoing: If your side of this location is full, +4 Power.","variants":13,"card_type":0,"is_released":true,"series_short":"Recruit","is_collectable":true,"starts_in_hand":false},{"key":"Arana","url":"/cards/Arana/","cost":1,"name":"Araña","image":"https://game-assets.snap.fan/card_variant_images/Arana-ce1e3385e13b4fd68e5039b5773519248525e684e90c633d13be59daa95f2ebf.webp","power":2,"series":"Series 5","ability":"Activate: After you play your next card, give it +1 Power and move it to the right.","variants":10,"card_type":0,"is_released":true,"series_short":"Series 5","is_collectable":true,"starts_in_hand":false},{"key":"Bast","url":"/cards/Bast/","cost":1,"name":"Bast","image":"https://game-assets.snap.fan/card_variant_images/Bast-1028c1afae5b18b37730507787f50c7e647302ef27ff83ca15fa4577730f8df8.webp","power":1,"series":"Series 3 (Collection Level 486+)","ability":"On Reveal: Set the Power of all cards in your hand to 3.","variants":7,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"Batroc","url":"/cards/Batroc/","cost":1,"name":"Batroc the Leaper","image":"https://game-assets.snap.fan/card_variant_images/Batroc-2bcaf53e9a5cd28b192d76c4e34fae1acc9d046336d4b2104d20b09d3f5f8cc7.webp","power":2,"series":"Series 4","ability":"When a card moves, follow it to gain +2 Power. (once per turn)","variants":3,"card_type":0,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"BlackCat","url":"/cards/BlackCat/","cost":1,"name":"Black Cat","image":"https://game-assets.snap.fan/card_variant_images/BlackCat-cefb454d4c241f1699a8ddb9326a10d42946ae5786c97da4b604ddb5a7e5f6c6.webp","power":4,"series":"Series 3 (Collection Level 486+)","ability":"End of Turn: Discard this from your hand.","variants":22,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"BlackKnight","url":"/cards/BlackKnight/","cost":1,"name":"Black Knight","image":"https://game-assets.snap.fan/card_variant_images/BlackKnight-d6e28c53a6363ebcc48ec9808b13355c95e4af48436473e04773c564ca163f4b.webp","power":2,"series":"Series 4","ability":"After you discard a card, add the Ebony Blade to your hand with that card's Power. (once per game)","variants":11,"card_type":0,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"Blade","url":"/cards/Blade/","cost":1,"name":"Blade","image":"https://game-assets.snap.fan/card_variant_images/Blade-4ed76380b64240a9bf0e796ebc37fb24dd30be51cbf9dfc0cda85dd13abdfe68.webp","power":3,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: Discard the rightmost card from your hand.","variants":19,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false},{"key":"Clea","url":"/cards/Clea/","cost":1,"name":"Clea","image":"https://game-assets.snap.fan/card_variant_images/Clea-a529c8d5093e35a12c89156e0a0fb6b6cc4ad7599869536dde92d2e93bc54138.webp","power":3,"series":"Series 5","ability":"When this is Empowered, add Flames of the Faltine to your hand. (if in hand or in play)","variants":7,"card_type":0,"is_released":true,"series_short":"Series 5","is_collectable":true,"starts_in_hand":false},{"key":"Deadpool","url":"/cards/Deadpool/","cost":1,"name":"Deadpool","image":"https://game-assets.snap.fan/card_variant_images/Deadpool-a5dc40fe983c98a608ace9b8229bb6d9a88f1ff3e55d980879bd84b41033a16f.webp","power":1,"series":"Series 3 (Collection Level 486+)","ability":"When Destroyed: Return this to your hand with double the Power.","variants":31,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"DeafeningChord","url":"/cards/DeafeningChord/","cost":1,"name":"Deafening Chord","image":"https://game-assets.snap.fan/card_variant_images/DeafeningChord-a683f70c04fad8f27121f06e1cb92ed6c0c6ad5b85ca5bebaa045743574d7616.webp","power":0,"series":"Series 4","ability":"On Reveal: Remove the text of a 3-Cost or lower enemy character here.","variants":2,"card_type":1,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"EbonyMaw","url":"/cards/EbonyMaw/","cost":1,"name":"Ebony Maw","image":"https://game-assets.snap.fan/card_variant_images/EbonyMaw-a7e745b4b1068a1425e6d497881c8227fbee3d41d4f70b4808e0ddfe14cbc524.webp","power":7,"series":"Series 2 (Collection Level 222-486)","ability":"You can't play this after turn 3. Ongoing: You can't play cards here.","variants":8,"card_type":0,"is_released":true,"series_short":"Series 2","is_collectable":true,"starts_in_hand":false},{"key":"Echo","url":"/cards/Echo/","cost":1,"name":"Echo","image":"https://game-assets.snap.fan/card_variant_images/Echo-2eb40a319f3d4247600afb0dfdd518690daa71557ffc2875cc68ddf0cfa79042.webp","power":2,"series":"Series 3 (Collection Level 486+)","ability":"After your opponent plays an Ongoing card here, remove its abilities.","variants":9,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"Elektra","url":"/cards/Elektra/","cost":1,"name":"Elektra","image":"https://game-assets.snap.fan/card_variant_images/Elektra-596601e2b1efa4da4be257cba04684c9efd84268eb3b6651b07d7fa45e2a97a7.webp","power":2,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: Destroy an enemy 1-Cost card here.","variants":21,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false},{"key":"GhostSpider","url":"/cards/GhostSpider/","cost":1,"name":"Ghost-Spider","image":"https://game-assets.snap.fan/card_variant_images/GhostSpider-f84661a735d817978d9174512691236eb8ac84ed438cbf4d91a367bbc540da2c.webp","power":3,"series":"Series 3 (Collection Level 486+)","ability":"On Reveal: The last card you played moves here.","variants":29,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"Hawkeye","url":"/cards/Hawkeye/","cost":1,"name":"Hawkeye","image":"https://game-assets.snap.fan/card_variant_images/Hawkeye-f6e3594441598d6dc10ae975f35b928834ba9f6ef413d35abc0497aefc7a2977.webp","power":1,"series":"Starter","ability":"On Reveal: If you play a card at this location next turn, +3 Power.","variants":14,"card_type":0,"is_released":true,"series_short":"Starter","is_collectable":true,"starts_in_hand":false},{"key":"Headpool","url":"/cards/Headpool/","cost":1,"name":"Headpool","image":"https://game-assets.snap.fan/card_variant_images/Headpool-7a2ae898bc536f22241fb22fd533cd55ad838c0ec3c9a805b71dbf49852efe9f.webp","power":1,"series":"Series 5","ability":"When Destroyed: Return this to your hand, then give all cards in your hand +1 Power.","variants":6,"card_type":0,"is_released":true,"series_short":"Series 5","is_collectable":true,"starts_in_hand":false},{"key":"HowardTheDuck","url":"/cards/HowardTheDuck/","cost":1,"name":"Howard the Duck","image":"https://game-assets.snap.fan/card_variant_images/HowardTheDuck-924a9cf65a5faa3707ac66f1d4552c508cc3a5b8fdd6f277dc1274d3afc2050b.webp","power":2,"series":"Series 3 (Collection Level 486+)","ability":"Ongoing: Tap this to see the top card of your deck.","variants":11,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"HydraBob","url":"/cards/HydraBob/","cost":1,"name":"Hydra Bob","image":"https://game-assets.snap.fan/card_variant_images/HydraBob-1fde4ab5e69dec5a15ac7714ca198bbbb7862ae232d0bc6abd88f131c4a9ea15.webp","power":4,"series":"Series 5","ability":"End of Turn: This moves if a player Snapped.","variants":11,"card_type":0,"is_released":true,"series_short":"Series 5","is_collectable":true,"starts_in_hand":false},{"key":"Iceman","url":"/cards/Iceman/","cost":1,"name":"Iceman","image":"https://game-assets.snap.fan/card_variant_images/Iceman-0657f1ec73f3eac2a0b83dea3c7988ffa55cf20597dc12bae57ee26dc7476743.webp","power":2,"series":"Series 2 (Collection Level 222-486)","ability":"On Reveal: Give a card in your opponent's hand +1 Cost. (maximum 6)","variants":14,"card_type":0,"is_released":true,"series_short":"Series 2","is_collectable":true,"starts_in_hand":false},{"key":"IronFist","url":"/cards/IronFist/","cost":1,"name":"Iron Fist","image":"https://game-assets.snap.fan/card_variant_images/IronFist-d676c662a8f34dfdaf10b08195d265ef56b4455462d8d968b93513c4db2a4e72.webp","power":3,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: After you play your next card, move it one location to the left.","variants":10,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false},{"key":"JimHammond","url":"/cards/JimHammond/","cost":1,"name":"Jim Hammond Human Torch","image":"https://game-assets.snap.fan/card_variant_images/JimHammond-57218e5ad157ca5a81922271d837fde3846c927b40bc29fef539bcb77b76dc40.webp","power":2,"series":"Series 5","ability":"At the start of each turn, +1 Power for each bonus Energy you have.","variants":6,"card_type":0,"is_released":true,"series_short":"Series 5","is_collectable":true,"starts_in_hand":false},{"key":"KingEitri","url":"/cards/KingEitri/","cost":1,"name":"King Eitri","image":"https://game-assets.snap.fan/card_variant_images/KingEitri-312526b3cb9f5cb01f013b5971e8f1420cd56d59cbceed18cc0fe106d9abd22d.webp","power":3,"series":"Series 4","ability":"Activate: Draw a created card from your deck.","variants":2,"card_type":0,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"Kingpin","url":"/cards/Kingpin/","cost":1,"name":"Kingpin","image":"https://game-assets.snap.fan/card_variant_images/Kingpin-a8f5307a1ff643d8f21525244c8a76197741ad7e6de02c71dd743b2459fdadbb.webp","power":3,"series":"Series 3 (Collection Level 486+)","ability":"When an enemy card moves here, afflict it with -2 Power.","variants":9,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"KittyPryde","url":"/cards/KittyPryde/","cost":1,"name":"Kitty Pryde","image":"https://game-assets.snap.fan/card_variant_images/KittyPryde-7310e24d50de3f3dbb344749a2278b6897472cfab07b75ff1f563e3c37a06b63.webp","power":1,"series":"Series 3 (Collection Level 486+)","ability":"When this returns to your hand, +1 Power. Returns at the start of each turn.","variants":24,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false},{"key":"Korg","url":"/cards/Korg/","cost":1,"name":"Korg","image":"https://game-assets.snap.fan/card_variant_images/Korg-2c07b35fd60cd9a559f7d763083d66a4745a8814653e9a0822f415f828621bcc.webp","power":2,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: Shuffle a Rock into your opponent's deck.","variants":10,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false},{"key":"Loki","url":"/cards/Loki/","cost":1,"name":"Loki","image":"https://game-assets.snap.fan/card_variant_images/Loki-3baca87bd3df9a24782ddd77d1ea6bb87eb2703c8fe86fa5d65c79c0888d46d6.webp","power":2,"series":"Series 4","ability":"On Reveal: Replace your deck with your opponent's starting deck. Give those cards -1 Cost.","variants":25,"card_type":0,"is_released":true,"series_short":"Series 4","is_collectable":true,"starts_in_hand":false},{"key":"MBaku","url":"/cards/MBaku/","cost":1,"name":"M'Baku","image":"https://game-assets.snap.fan/card_variant_images/MBaku-eb1c7342fe1239e1f24d9e2bc30b6b1b9712c2332a0b0ed98fe20f711011543e.webp","power":3,"series":"Series 3 (Collection Level 486+)","ability":"At the end of the game, this jumps from your deck to your lowest-Power location. (that isn't full)","variants":6,"card_type":0,"is_released":true,"series_short":"Series 3","is_collectable":true,"starts_in_hand":false}],"count":30,"total":66},"meta":{"timestamp":"2026-06-08T01:18:26.229Z","request_id":"71399fc5-50e6-4086-92ba-2ac463ae0a53"},"status":"ok","message":"Cards retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/random":{"get":{"operationId":"get_v1_random","tags":["Marvel Snap"],"summary":"A random card","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"card":{"key":"DoctorStrange","url":"/cards/DoctorStrange/","cost":2,"name":"Doctor Strange","image":"https://game-assets.snap.fan/card_variant_images/DoctorStrange-b05d7d9c7f09c8981d5800833bbfe8f8d27777917e7907e15d0f3586ba484f1e.webp","power":4,"series":"Series 1 (Collection Level 18-214)","ability":"On Reveal: Move your highest-Power card(s) to this location.","variants":21,"card_type":0,"is_released":true,"series_short":"Series 1","is_collectable":true,"starts_in_hand":false}},"meta":{"timestamp":"2026-06-08T01:18:26.325Z","request_id":"8deefc4e-ab46-4485-b0b8-9d41cda06710"},"status":"ok","message":"Random card retrieved successfully","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Service description & endpoints","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"service":"marvelsnap-api","endpoints":{"GET /v1/card":"A single card by key or name (key= | name=, e.g. Abomination).","GET /v1/meta":"This document.","GET /v1/cards":"Search/filter cards (name=, cost=, power=, series=, card_type=, limit=).","GET /v1/random":"A random card."},"description":"Marvel Snap card data via the open snap.fan API: search and filter the full card pool by name, cost, power, series or card type; fetch a single card with its ability text and art; and pull a random card. Real data, no key."},"meta":{"timestamp":"2026-06-08T01:18:26.423Z","request_id":"804befef-071a-411c-8fec-4ffee23538f2"},"status":"ok","message":"Meta","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":10300,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":370,"monthly_call_quota":141000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1620,"monthly_call_quota":735000,"rps_limit":25,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5950,"monthly_call_quota":3380000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/marvelsnap-api"}