{ "openapi": "3.0.1", "info": { "title": "Courtyard.io scraper", "description": "Extract graded trading card, coin, and watch data from Courtyard.io: grading, fair market value, live orderbook, vault status, and blockchain provenance for every asset.", "version": "0.1", "x-build-id": "PsUf0mGdpTgNV1pae" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~courtyard-io-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-courtyard-io-scraper", "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/getascraper~courtyard-io-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-courtyard-io-scraper", "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/getascraper~courtyard-io-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-courtyard-io-scraper", "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": { "assetUrls": { "title": "Asset URLs or IDs", "type": "array", "description": "Direct Courtyard.io asset links (e.g. https://courtyard.io/asset/efcb845d...) or bare 64-character asset IDs, one per line. This is the fastest and most reliable way to pull specific graded cards, coins, or watches you already know about. Leave empty to discover assets automatically instead (see 'Discovery mode' below).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "discoveryMode": { "title": "Discovery mode", "enum": [ "marketplace", "vending-machine", "vending-machine-coins", "vending-machine-watches", "leaderboard" ], "type": "string", "description": "When 'Asset URLs or IDs' is empty, this Actor browses Courtyard.io's marketplace and collects assets automatically. Choose which listing surface to browse.", "default": "marketplace" }, "category": { "title": "Category filter", "enum": [ "any", "Pokemon", "Basketball", "Baseball", "Football", "Soccer", "Hockey", "Magic The Gathering", "One Piece", "Yu-Gi-Oh!", "Marvel", "Disney", "Star Wars", "Watches", "Coins" ], "type": "string", "description": "Restrict discovery to one category. 'Any' browses the default unfiltered feed for the chosen discovery mode.", "default": "any" }, "maxItems": { "title": "Max assets", "minimum": 1, "type": "integer", "description": "Maximum number of assets to scrape and push to the dataset. When using 'Asset URLs or IDs', this caps how many of the provided links are processed. When discovering automatically, this controls how far the Actor scrolls the listing page before stopping.", "default": 50 }, "deepScrape": { "title": "Include price history & transaction history", "type": "boolean", "description": "When enabled, fetches two extra API calls per asset: the full per-grade price history (comparable sales across every graded population of the same card/item) and the on-chain transaction history (transfer hashes, wallet addresses, payment amounts). Roughly triples request volume per asset. Disable for a faster, lighter run when you only need the core listing, grading, and live orderbook data.", "default": true }, "includeLikesCount": { "title": "Include likes count", "type": "boolean", "description": "Adds the public likes/favorites count for each asset with one extra lightweight API call.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Courtyard.io's discovery pages (courtyard.io) only need a standard datacenter proxy. The underlying api.courtyard.io detail endpoint is gated by a browser-TLS fingerprint check (not an IP-reputation check), which this Actor already satisfies via got-scraping's browser impersonation, so datacenter proxy is sufficient here too.", "default": { "useApifyProxy": true } } } }, "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 } } }, "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 } } } } } } } } } }