{ "openapi": "3.0.1", "info": { "title": "Goldin Auctions Scraper & API: Sold Comps, Live Bids & Grades", "description": "Goldin Auctions scraper and API for sports card and collectible lots. Pull live bids or the sold-price archive with grade, year, serial number and all-in price with buyer's premium. Look up lots by link, search many keywords, filter by grader, sport, year, price and auction date. No login.", "version": "0.4", "x-build-id": "SuUOFfvFdAUybBmPV" }, "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": { "lotUrls": { "title": "Lot links", "type": "array", "description": "Goldin lot links (goldin.co/item/...) or lot slugs to look up one by one, live or already sold. Leave empty to search instead. Links that cannot be found are skipped and mentioned in the run message.", "default": [], "items": { "type": "string" } }, "keyword": { "title": "Keyword", "type": "string", "description": "Search lots by player, card name, set, or item description. Leave empty (with no lot links) to browse all lots.", "default": "" }, "keywords": { "title": "More keywords", "type": "array", "description": "Extra search phrases, each run as its own search in one go (for example one per player). Lots found by more than one phrase are returned once.", "default": [], "items": { "type": "string" } }, "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 of hundreds of thousands of past lots.", "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": "" }, "auctionName": { "title": "Auction name contains", "type": "string", "description": "Only lots from auctions whose name contains this text, for example Elite, Pokemon, or a month and year. Leave empty for all auctions.", "default": "" }, "soldAfter": { "title": "Sold or ended after", "type": "string", "description": "Only lots whose auction ended on or after this date (YYYY-MM-DD). Works for sold history and for live lots by their end date." }, "soldBefore": { "title": "Sold or ended before", "type": "string", "description": "Only lots whose auction ended on or before this date (YYYY-MM-DD)." }, "graders": { "title": "Grading companies", "type": "array", "description": "Only return lots certified by one of these companies, using Goldin's own certification data. Leave empty to include ungraded lots and all graders.", "items": { "type": "string", "enum": [ "PSA", "BGS", "CGC", "SGC", "AFA", "WATA", "VMG", "AMG", "BECKETT", "VGA", "JSA", "CAS", "NGC", "PCGS", "CSG", "CBCS", "UNGRADED", "OTHER" ], "enumTitles": [ "PSA", "BGS (Beckett)", "CGC", "SGC", "AFA", "WATA", "VMG", "AMG", "Beckett", "VGA", "JSA", "CAS", "NGC", "PCGS", "CSG", "CBCS", "Ungraded", "Other graders" ] }, "default": [] }, "categories": { "title": "Categories", "type": "array", "description": "Goldin categories to include, for example Sport or Non-Sport. Leave empty for all.", "default": [], "items": { "type": "string" } }, "subCategories": { "title": "Sports and franchises", "type": "array", "description": "Sub-categories to include, for example Basketball, Baseball, Football, Soccer, Hockey, Pokemon, Marvel, or Star Wars. Leave empty for all.", "default": [], "items": { "type": "string" } }, "itemTypes": { "title": "Item types", "type": "array", "description": "Item types to include, for example Single Cards, Memorabilia, Comics, Cases/Boxes/Packs, or Graded Magazines. Leave empty for all.", "default": [], "items": { "type": "string" } }, "minGrade": { "title": "Minimum grade", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only return lots whose numeric grade is at or above this value (1 to 10, e.g. 9 keeps PSA 9, 9.5 and 10), the core card-comp dimension. Lots with no numeric grade in the title (ungraded or authentic-only) are skipped when this is set. Leave at 0 for no limit.", "default": 0 }, "maxGrade": { "title": "Maximum grade", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only return lots whose numeric grade is at or below this value (1 to 10). Pair with Minimum grade to pull one grade tier, for example 9 to 9 for PSA 9 comps only. Leave at 0 for no limit.", "default": 0 }, "yearMin": { "title": "Year, from", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only return cards from this year or later. Leave at 0 for no limit.", "default": 0 }, "yearMax": { "title": "Year, to", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Only return cards from this year or earlier. Leave at 0 for no limit.", "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. Leave at 0 for no limit.", "default": 0 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Maximum number of lots to return in this run. Large runs may need a longer run timeout.", "default": 20 }, "onlyNewOrChanged": { "title": "Incremental monitor mode", "type": "boolean", "description": "Only return lots that are new or whose price or bid count changed since your last run with the same monitor state name. Pair with an Apify schedule to track a card or keyword over time. In this mode Max items limits how many lots are checked per run.", "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" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Goldin's data works without a proxy, which is the cheapest and fastest option. Kept for compatibility with saved inputs; it is not used.", "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 } } } } } } } } } }