Scryfall

aid: scryfall
name: Scryfall
description: Scryfall is the most comprehensive free Magic - The Gathering card database. The Scryfall API exposes Cards (search,
  autocomplete, named, random, collection, by various IDs), Sets, Rulings, Symbology, Catalogs, Bulk Data downloads, and card-object
  Migrations. The service is community-funded (Patreon / Ko-fi) and offered free of charge under the Wizards of the Coast
  Fan Content Policy for community software, research, and content. The API is HTTPS-only, requires a descriptive User-Agent
  and Accept header on every request, and asks that clients keep sustained traffic under 10 requests per second.
type: Index
url: https://raw.githubusercontent.com/api-evangelist/scryfall/main/apis.yml
humanURL: https://scryfall.com/docs/api
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-type: opensource
x-tier: 3
x-tier-reason: enriched-via-full-pipeline
x-source: public-apis/public-apis
x-category: Games & Comics
tags:
- Games And Comics
- Magic The Gathering
- Card Data
- Open Data
- Free
- Community Funded
- Public APIs
apis:
- aid: scryfall:scryfall-api
  name: Scryfall API
  description: The Scryfall REST API exposes Magic - The Gathering card data, set metadata, Oracle rulings, symbology, catalogs
    of in-game data points, daily bulk-data exports, and card-object migration records. The Cards surface alone supports lookup
    by Scryfall ID, set+number, Multiverse ID, MTGO ID, Arena ID, TCGplayer ID, Cardmarket ID, exact/fuzzy name, autocomplete,
    random draw, and batch collection. All responses use a discriminated object model keyed by the 'object' field.
  humanURL: https://scryfall.com/docs/api
  baseURL: https://api.scryfall.com
  tags:
  - Cards
  - Sets
  - Rulings
  - Symbology
  - Catalogs
  - Bulk Data
  - Magic The Gathering
  properties:
  - type: Documentation
    url: https://scryfall.com/docs/api
  - type: APIReference
    url: https://scryfall.com/docs/api/cards
  - type: OpenAPI
    url: openapi/scryfall-openapi.yml
  - type: JSONSchema
    url: json-schema/scryfall-card-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-card-face-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-related-card-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-image-uris-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-legalities-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-prices-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-set-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-ruling-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-card-symbol-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-catalog-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-bulk-data-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-migration-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-list-schema.json
  - type: JSONSchema
    url: json-schema/scryfall-error-schema.json
  - type: JSONStructure
    url: json-structure/scryfall-card-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-set-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-ruling-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-card-symbol-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-catalog-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-bulk-data-structure.json
  - type: JSONStructure
    url: json-structure/scryfall-migration-structure.json
  - type: JSONLD
    url: json-ld/scryfall-context.jsonld
  - type: Examples
    url: examples/scryfall-card-example.json
  - type: Examples
    url: examples/scryfall-card-list-example.json
  - type: Examples
    url: examples/scryfall-set-example.json
  - type: Examples
    url: examples/scryfall-ruling-example.json
  - type: Examples
    url: examples/scryfall-card-symbol-example.json
  - type: Examples
    url: examples/scryfall-catalog-example.json
  - type: Examples
    url: examples/scryfall-bulk-data-example.json
  - type: Examples
    url: examples/scryfall-migration-example.json
  - type: Examples
    url: examples/scryfall-error-example.json
  - type: RateLimits
    url: rate-limits/scryfall-rate-limits.yml
  - type: Authentication
    url: https://scryfall.com/docs/api
  - type: ErrorCodes
    url: https://scryfall.com/docs/api/errors
common:
- type: Website
  url: https://scryfall.com
- type: Documentation
  url: https://scryfall.com/docs/api
- type: APIReference
  url: https://scryfall.com/docs/api/cards
- type: GettingStarted
  url: https://scryfall.com/docs/api
- type: Blog
  url: https://scryfall.com/blog/category/api
- type: ChangeLog
  url: https://scryfall.com/blog/category/api
- type: Support
  url: https://scryfall.com/contact
- type: Contact
  url: https://scryfall.com/contact
- type: Plans
  url: plans/scryfall-plans-pricing.yml
- type: RateLimits
  url: rate-limits/scryfall-rate-limits.yml
- type: SpectralRules
  url: rules/scryfall-rules.yml
- type: Vocabulary
  url: vocabulary/scryfall-vocabulary.yml
- type: JSONLD
  url: json-ld/scryfall-context.jsonld
- type: GitHubOrganization
  url: https://github.com/scryfall
- type: GitHubRepository
  name: scryfall/api-types
  url: https://github.com/scryfall/api-types
  description: A library describing the Scryfall API as a system of TypeScript types.
- type: GitHubRepository
  name: scryfall/google-sheets
  url: https://github.com/scryfall/google-sheets
  description: Custom =SCRYFALL() function for Google Sheets.
- type: GitHubRepository
  name: scryfall/manamoji-slack
  url: https://github.com/scryfall/manamoji-slack
  description: Slack emojis for Magic card symbols.
- type: GitHubRepository
  name: scryfall/manamoji-discord
  url: https://github.com/scryfall/manamoji-discord
  description: Discord emojis for Magic card symbols.
- type: GitHubRepository
  name: scryfall/thopter
  url: https://github.com/scryfall/thopter
  description: A Slack bot returning Magic card information, pictures, and prices.
- type: GitHubRepository
  name: scryfall/servo
  url: https://github.com/scryfall/servo
  description: A Discord bot that returns Magic card information and pictures.
- type: GitHubRepository
  name: scryfall/scion
  url: https://github.com/scryfall/scion
  description: An Alfred workflow to quickly search for Magic cards.
- type: GitHubRepository
  name: scryfall/gatherer-bugs
  url: https://github.com/scryfall/gatherer-bugs
  description: A public repository tracking bugs on gatherer.wizards.com.
- type: GitHubRepository
  name: scryfall/art-game
  url: https://github.com/scryfall/art-game
  description: The MTG art-guessing game on Scryfall.
- type: SDKs
  name: scryfall-client (JavaScript)
  url: https://github.com/crookedneighbor/scryfall-client
  description: Community-maintained JavaScript client for the Scryfall API.
- type: SDKs
  name: scryfall-sdk (TypeScript)
  url: https://www.npmjs.com/package/scryfall-sdk
  description: Community-maintained TypeScript SDK for the Scryfall API.
- type: SDKs
  name: scrython (Python)
  url: https://github.com/NandaScott/Scrython
  description: Community-maintained Python wrapper for the Scryfall API.
- type: SDKs
  name: scryfall (Rust)
  url: https://docs.rs/scryfall
  description: Community-maintained Rust client for the Scryfall API.
- type: Tools
  name: cryppadotta/scryfall-mcp
  url: https://github.com/cryppadotta/scryfall-mcp
  description: MCP server providing card details, rulings, and price lookups via the Scryfall API.
- type: Tools
  name: bmurdock/scryfall-mcp
  url: https://github.com/bmurdock/scryfall-mcp
  description: MCP server for Scryfall-backed Magic search, rules lookup, pricing, set discovery, and deckbuilding workflows.
- type: Tools
  name: andershaig/mcp-scryfall
  url: https://github.com/andershaig/mcp-scryfall
  description: MCP server for Scryfall's Magic card search inside Claude.
- type: Tools
  name: JoeMoCode/Scryfall-MCP
  url: https://github.com/joemocode/scryfall-mcp
  description: MCP server bringing Magic card data into Claude Desktop.
- type: Tools
  name: artillect/mtg-mcp-servers
  url: https://github.com/artillect/mtg-mcp-servers
  description: MCP servers for Scryfall card search plus LLM decklist and hand management.
- type: Pricing
  url: https://scryfall.com/donate
- type: TermsOfService
  url: https://scryfall.com/docs/api
- type: PrivacyPolicy
  url: https://scryfall.com/privacy
- type: Features
  data:
  - name: Comprehensive card database
    description: Every Magic - The Gathering printing across paper, MTGO, and Arena with localized translations.
  - name: Fulltext search query language
    description: Powerful Scryfall search syntax supporting color, type, format legality, set, price, oracle text, and more.
  - name: Daily bulk-data exports
    description: Five daily JSON exports - oracle_cards, unique_artwork, default_cards, all_cards, and rulings - for offline
      ingestion.
  - name: Multi-resolution card imagery
    description: Six image renderings per card - small, normal, large, png, art_crop, border_crop.
  - name: Up-to-date market prices
    description: USD / EUR / MTGO Tix pricing across normal, foil, and etched finishes.
  - name: Oracle rulings
    description: Wizards of the Coast Oracle rulings plus Scryfall editorial notes per card.
  - name: Symbology with SVG renderings
    description: All Magic mana and text symbols with parser endpoint and downloadable SVG art.
  - name: Catalogs of in-game data points
    description: Canonical lists of card names, creature types, supertypes, keyword abilities, and more for autocomplete and
      validation.
  - name: Free with attribution
    description: No API key, no paid tier - usage is governed by attribution and a documented rate-limit policy.
- type: UseCases
  data:
  - name: Deck building applications
    description: Powering search, autocomplete, and legality checks in deck-builder web and mobile apps.
  - name: Price tracking and portfolio tools
    description: Aggregating USD / EUR / Tix prices across reprints for collection valuation.
  - name: Discord and Slack card-lookup bots
    description: Inline card images, prices, and rulings inside team chat channels.
  - name: LLM and AI agent integrations
    description: MCP servers exposing card data, rulings, and search to Claude and other agents.
  - name: Research and dataset publishing
    description: Bulk-data exports feed academic and journalistic research on Magic's design history and card economy.
  - name: Spoiler and set-release coverage
    description: Tracking newly-spoiled cards into and through release day via the Sets and Cards endpoints.
  - name: Custom card-rendering and proxy printing
    description: High-resolution PNG and SVG art for personal-use proxies and educational content.
  - name: Tournament-legality verification
    description: Format-legality checks for Standard, Pioneer, Modern, Legacy, Vintage, Pauper, Commander, Brawl, Alchemy,
      and historic formats.
- type: Integrations
  data:
  - name: TCGplayer
    description: Cross-referenced card identifiers and purchase links via tcgplayer_id.
  - name: Cardmarket
    description: Cross-referenced card identifiers and purchase links via cardmarket_id.
  - name: Cardhoarder
    description: MTGO price feed integration and purchase links.
  - name: Wizards of the Coast Gatherer
    description: Cross-referenced via multiverse_ids for canonical Oracle text.
  - name: Magic Online (MTGO)
    description: Identifier mapping via mtgo_id and mtgo_foil_id.
  - name: Magic Arena
    description: Identifier mapping via arena_id.
  - name: EDHREC
    description: Commander-format recommendation data linked from card.related_uris.
  - name: Anthropic Claude (MCP)
    description: Multiple community MCP servers expose Scryfall to Claude Desktop and other MCP clients.
  - name: Google Sheets
    description: Official Scryfall =SCRYFALL() custom function for spreadsheet card lookups.
  - name: Alfred (macOS)
    description: Official Scryfall Scion workflow for fast card search from Alfred.
- type: Solutions
  data:
  - name: Community software
    description: Powering thousands of fan-built deck builders, collection trackers, and tools.
  - name: Magic content creators
    description: Source of authoritative card data and imagery for podcasts, articles, and video content.
  - name: Researchers
    description: Bulk-data exports enabling longitudinal analysis of Magic's design and economy.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com