{ "openapi": "3.0.1", "info": { "title": "Card Kingdom MTG Price & Stock Alert", "description": "Card Kingdom deal alert and listings scraper for United States: search any item, get price, location, photos, seller and posting time, with new-listing and price-drop alerts. Filter by price. No login.", "version": "1.0", "x-build-id": "H7xFGY00BmShXbba0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mrdoe~cardkingdom-mtg-deal-alert/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mrdoe-cardkingdom-mtg-deal-alert", "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/mrdoe~cardkingdom-mtg-deal-alert/runs": { "post": { "operationId": "runs-sync-mrdoe-cardkingdom-mtg-deal-alert", "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/mrdoe~cardkingdom-mtg-deal-alert/run-sync": { "post": { "operationId": "run-sync-mrdoe-cardkingdom-mtg-deal-alert", "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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One or more things to search Card Kingdom for, in English (a Magic: The Gathering card name), e.g. \"lightning bolt\", \"sol ring\", \"lotus\". Max results applies to each term separately.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price (optional)", "minimum": 0, "type": "number", "description": "Only return listings priced at or above this amount in USD. Listings without a price are skipped when a price filter is set." }, "maxPrice": { "title": "Maximum price (optional)", "minimum": 0, "type": "number", "description": "Only return listings priced at or below this amount in USD. Listings without a price are skipped when a price filter is set." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Skip cards that are out of stock in every condition.", "default": true }, "foil": { "title": "Foil", "enum": [ "any", "foil", "nonfoil" ], "type": "string", "description": "Only foil printings, only non-foil printings, or both.", "default": "any" }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "price_asc", "price_desc", "name_asc" ], "type": "string", "description": "Order of the results.", "default": "relevance" }, "maxItems": { "title": "Max results per term", "minimum": 1, "type": "integer", "description": "Stop once this many listings have been written to the dataset for each search term.", "default": 20 }, "monitorMode": { "title": "Monitor mode - only new listings and price drops", "type": "boolean", "description": "When on, the run compares against the previous monitored run of the same search and returns only listings that are new or whose price fell by at least the drop threshold. Turn this on for scheduled runs.", "default": false }, "minDropPercent": { "title": "Price-drop threshold % (monitor mode)", "minimum": 0, "maximum": 100, "type": "number", "description": "In monitor mode, report a price drop on an already-seen listing only when it is at least this many percent.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Card Kingdom works without a proxy at normal volumes.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }