{ "openapi": "3.0.1", "info": { "title": "Goldin Auctions Scraper: Sports Cards, Prices & Sold Comps", "description": "Extract real Goldin Auctions sports card and memorabilia lots: live bids or an 800,000+ lot sold-price archive, with parsed year, grade, and serial number, plus an all-in price with premium included. Filter by tier, grader, price, and year. No login, no browser. Pay per result.", "version": "0.1", "x-build-id": "lbtcRFPrUEG9UHaxP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/getascraper~goldin-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-getascraper-goldin-auctions-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~goldin-auctions-scraper/runs": { "post": { "operationId": "runs-sync-getascraper-goldin-auctions-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~goldin-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-getascraper-goldin-auctions-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": { "keyword": { "title": "Keyword", "type": "string", "description": "Search Goldin's lots by player, card name, set, or item description. Leave empty to browse all lots instead of searching.", "default": "" }, "mode": { "title": "Mode", "enum": [ "active", "sold" ], "type": "string", "description": "Active returns live and upcoming lots you can still bid on. Sold returns Goldin's historical sold-price archive, confirmed to hold 800,000+ past lots, far deeper than the 20,000-lot cap other Goldin scrapers on the Store are limited to.", "default": "active" }, "auctionType": { "title": "Auction tier", "enum": [ "", "Weekly", "Elite", "Thematic", "Fixed_Price" ], "type": "string", "description": "Limit results to one of Goldin's real auction tiers. Leave as All tiers to include everything.", "default": "" }, "graders": { "title": "Grading companies", "type": "array", "description": "Only return lots graded by one of these companies. Grading info is parsed from each lot's own title (Goldin's search results don't return it as a separate field, the same real limitation every other Goldin scraper on the Store has), so results depend on the title actually naming the grader. Leave empty to include ungraded and all graders.", "items": { "type": "string", "enum": [ "PSA", "BGS", "CGC", "SGC", "AFA", "WATA", "VMG", "AMG", "BECKETT" ], "enumTitles": [ "PSA", "BGS (Beckett)", "CGC", "SGC", "AFA", "WATA", "VMG", "AMG", "Beckett" ] }, "default": [] }, "yearMin": { "title": "Year, from", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only return cards from this year or later, parsed from each lot's own title. None of the other Goldin scrapers on the Store expose year filtering at all.", "default": 0 }, "yearMax": { "title": "Year, to", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only return cards from this year or earlier.", "default": 0 }, "priceMin": { "title": "Price, from (USD)", "minimum": 0, "type": "integer", "description": "Only return lots priced at or above this amount.", "default": 0 }, "priceMax": { "title": "Price, to (USD)", "minimum": 0, "type": "integer", "description": "Only return lots priced at or below this amount.", "default": 0 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Goldin's search API is a plain, unauthenticated public endpoint, confirmed to work reliably with no proxy at all. Left here in case Goldin adds rate limiting later; the default (no proxy) is the cheapest and fastest option.", "default": { "useApifyProxy": false } }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of lots to return in this run.", "default": 20 }, "onlyNewOrChanged": { "title": "Incremental monitor mode", "type": "boolean", "description": "Only return lots that are new or whose price/bid count changed since your last run with the same monitor state name. Pair with an Apify schedule to track specific cards or a keyword over time. No competitor Goldin scraper on the Store offers this, despite their own users already re-running them dozens of times a month.", "default": false }, "stateName": { "title": "Monitor state name", "type": "string", "description": "Name for this run's incremental state, used only when incremental monitor mode is on. Use different names to track separate searches independently.", "default": "default" } } }, "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 } } } } } } } } } }