{ "openapi": "3.0.1", "info": { "title": "Goldin Auctions Scraper - Sports Cards & Collectibles", "description": "Scrape Goldin Auctions (eBay-owned) for marketplace listings and past-auction results. Captures weekly / premium / elite auction tiers with PSA / BGS / SGC / CGC grade normalization, final-sale prices, buyer's-premium %, bid counts, and reserve-met detection.", "version": "0.1", "x-build-id": "eGUiCjJDSuesUOcbr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jungle_synthesizer~goldin-auctions-marketplace-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jungle_synthesizer-goldin-auctions-marketplace-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/jungle_synthesizer~goldin-auctions-marketplace-scraper/runs": { "post": { "operationId": "runs-sync-jungle_synthesizer-goldin-auctions-marketplace-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/jungle_synthesizer~goldin-auctions-marketplace-scraper/run-sync": { "post": { "operationId": "run-sync-jungle_synthesizer-goldin-auctions-marketplace-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", "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": [ "marketplace", "past_auctions", "lot" ], "type": "string", "description": "Active marketplace listings, past auction results archive, or a single lot URL." }, "auctionTier": { "title": "Auction Tier", "enum": [ "", "Weekly", "Premium", "Elite" ], "type": "string", "description": "Filter by auction tier. Blank = all. Goldin's search has no tier parameter, so lots are scanned and filtered on our side." }, "sport": { "title": "Sport / Sub-Category", "type": "array", "description": "Sub-categories to include, matched as OR. Empty = all. E.g. Baseball, Basketball, Pokemon, Soccer, Racing, Star Wars, Wrestling. Free text rather than a dropdown because Goldin carries 240+ sub-categories and keeps adding them; a value that matches nothing stops the run and lists the ones available, so a typo costs nothing.", "items": { "type": "string" } }, "grader": { "title": "Grader", "type": "array", "description": "Grading services to include, matched as OR. Empty = all. The full list Goldin uses, not just the big four: Other alone covers ~40k sold lots, and WATA / AFA / CAS matter for sealed games and toys.", "items": { "type": "string", "enum": [ "PSA", "PSA/DNA", "PSA/DNA GU", "Beckett", "Beckett Ungraded", "BGS", "SGC", "CGC", "CGC Signature Series", "CGC Qualified", "CGC Ungraded", "CGC/JSA Authentic Autograph", "CBCS", "CSG", "NGC", "PCGS", "JSA", "WATA", "AFA", "CAS", "VGA", "VMG", "AMG", "IGS", "TAG", "Rewind", "CIB", "VAULT", "Pop Culture/Entertainment", "Multiple", "Other", "Ungraded" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Free-text keyword (player, set, card name)." }, "priceMin": { "title": "Min Price (USD)", "type": "integer", "description": "Minimum final / current price.", "default": 0 }, "priceMax": { "title": "Max Price (USD)", "type": "integer", "description": "Maximum final / current price. 0 = no cap.", "default": 0 }, "soldAfter": { "title": "Sold After (YYYY-MM-DD)", "type": "string", "description": "Past-auction mode: only include lots sold on or after this date (YYYY-MM-DD). Goldin's search has no date parameter and no sort, so lots are scanned and filtered on our side — within the 20,000-lot search cap. Narrow with keyword, sub-category or price to bring the window you want inside that cap." }, "soldBefore": { "title": "Sold Before (YYYY-MM-DD)", "type": "string", "description": "Past-auction mode: only include lots sold on or before this date (YYYY-MM-DD). Same scan-and-filter caveat as Sold After." }, "lotUrls": { "title": "Lot URLs", "type": "array", "description": "When mode=lot, list of Goldin lot URLs (goldin.co/auctions/...).", "items": { "type": "string" } }, "maxItems": { "title": "Max Items", "type": "integer", "description": "Maximum lots to return. 0 = unlimited. Goldin's search returns at most 20,000 lots per query, so a single run cannot exceed that however high this is set — split large jobs by sub-category or price range.", "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 } } }, "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 } } } } } } } } } }