{ "openapi": "3.0.1", "info": { "title": "Yu-Gi-Oh Card Database & Prices - YGOProDeck API Wrapper", "description": "A complete Yu-Gi-Oh card database pulled from YGOProDeck: search by type, race, attribute, level, or archetype; fetch by exact name; walk a set or banlist; or grab the full ~13k-card corpus. Includes rules text, every printing, banlist status, and live marketplace prices.", "version": "0.1", "x-build-id": "GJUDMq5FLeawz2udb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~ygoprodeck-yugioh-cards-api-wrapper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-ygoprodeck-yugioh-cards-api-wrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/jungle_synthesizer~ygoprodeck-yugioh-cards-api-wrapper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-ygoprodeck-yugioh-cards-api-wrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/jungle_synthesizer~ygoprodeck-yugioh-cards-api-wrapper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-ygoprodeck-yugioh-cards-api-wrapper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "sp_intended_usage", "sp_improvement_suggestions" ], "properties": { "sp_intended_usage": { "title": "What is the intended usage of this data?", "minLength": 1, "type": "string", "description": "What will this data feed? E.g. lead lists, KYB checks, price tracking." }, "sp_improvement_suggestions": { "title": "How can we improve this crawler for you?", "minLength": 1, "type": "string", "description": "Provide any feedback or suggestions for improvements." }, "sp_contact": { "title": "Contact email (optional)", "minLength": 1, "type": "string", "description": "We'll personally help with your use case. No spam." }, "mode": { "title": "Mode", "enum": [ "search", "by_name", "by_archetype", "by_set", "by_banlist", "full_dump" ], "type": "string", "description": "Filter search, by name, by archetype, by set, by banlist, or full corpus dump." }, "cardTypes": { "title": "Card Types", "type": "array", "description": "When mode is Filter Search, one or more card types to match (union).", "items": { "type": "string", "enum": [ "Effect Monster", "Flip Effect Monster", "Flip Tuner Effect Monster", "Fusion Monster", "Gemini Monster", "Link Monster", "Normal Monster", "Normal Tuner Monster", "Pendulum Effect Fusion Monster", "Pendulum Effect Monster", "Pendulum Effect Ritual Monster", "Pendulum Flip Effect Monster", "Pendulum Normal Monster", "Pendulum Tuner Effect Monster", "Ritual Effect Monster", "Ritual Monster", "Skill Card", "Spell Card", "Spirit Monster", "Synchro Monster", "Synchro Pendulum Effect Monster", "Synchro Tuner Monster", "Token", "Toon Monster", "Trap Card", "Tuner Monster", "Union Effect Monster", "XYZ Monster", "XYZ Pendulum Effect Monster" ] } }, "races": { "title": "Race / Spell-Trap Type", "type": "array", "description": "When mode is Filter Search, one or more monster races (or Spell/Trap sub-types) to match (union).", "items": { "type": "string", "enum": [ "Aqua", "Beast", "Beast-Warrior", "Continuous", "Counter", "Creator God", "Cyberse", "Dinosaur", "Divine-Beast", "Dragon", "Equip", "Fairy", "Field", "Fiend", "Fish", "Illusion", "Insect", "Machine", "Normal", "Plant", "Psychic", "Pyro", "Quick-Play", "Reptile", "Ritual", "Rock", "Sea Serpent", "Spellcaster", "Thunder", "Warrior", "Winged Beast", "Wyrm", "Zombie" ] } }, "attributes": { "title": "Attribute", "type": "array", "description": "When mode is Filter Search, one or more monster attributes to match (union).", "items": { "type": "string", "enum": [ "DARK", "DIVINE", "EARTH", "FIRE", "LIGHT", "WATER", "WIND" ] } }, "level": { "title": "Level / Rank", "type": "integer", "description": "When mode is Filter Search, monster level/rank filter (0 = ignore).", "default": 0 }, "archetypes": { "title": "Archetypes", "type": "array", "description": "When mode is By Archetype, one or more archetype names (e.g. 'Blue-Eyes', 'Branded', 'Sky Striker').", "items": { "type": "string" } }, "cardName": { "title": "Card Names", "type": "array", "description": "When mode is By Name, list of card names (exact match).", "items": { "type": "string" } }, "setNames": { "title": "Set Names", "type": "array", "description": "When mode is By Set, one or more full set names (e.g. 'Metal Raiders').", "items": { "type": "string" } }, "banlists": { "title": "Banlist Formats", "type": "array", "description": "When mode is By Banlist, which format(s) to walk.", "items": { "type": "string", "enum": [ "tcg", "ocg", "goat" ] } }, "includePrices": { "title": "Include Prices", "type": "boolean", "description": "Include cardmarket / tcgplayer / ebay / amazon / coolstuffinc prices.", "default": true }, "includeAllPrintings": { "title": "Include All Printings", "type": "boolean", "description": "Include every printing (set / rarity / set price) for each card.", "default": true }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum cards to return. 0 = unlimited (use with Full Corpus Dump).", "default": 10 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }