{
  "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": "3PO3O5jo5XqOTx3CX"
  },
  "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",
        "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",
              "Thematic"
            ],
            "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"
              ]
            }
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Top-level categories to include, matched as OR. Empty = all. E.g. Sport, Non-Sport; the sold archive also carries named collections. A value that matches nothing stops the run and lists the ones available in the chosen mode, so a typo costs nothing.",
            "items": {
              "type": "string"
            }
          },
          "itemTypes": {
            "title": "Item Types",
            "type": "array",
            "description": "Item types to include, matched as OR. Empty = all. E.g. Single Cards, Jerseys, Memorabilia, Cases/Boxes/Packs. A value that matches nothing stops the run and lists the ones available in the chosen mode, so a typo costs nothing.",
            "items": {
              "type": "string"
            }
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Free-text keyword (player, set, card name)."
          },
          "keywords": {
            "title": "More Keywords",
            "type": "array",
            "description": "Extra keywords searched in the same run, each with every other filter applied. Lots found by more than one keyword are returned once, and Max Items caps the run as a whole.",
            "items": {
              "type": "string"
            }
          },
          "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
          },
          "minGrade": {
            "title": "Min grade",
            "minimum": 0,
            "type": "number",
            "description": "Only graded lots at or above this numeric grade (e.g. 9). Applied on our side after fetching, so ungraded lots and lots whose title carries no numeric grade are dropped. Combine with Grader, keyword or sub-category to keep the scan small."
          },
          "maxGrade": {
            "title": "Max grade",
            "minimum": 0,
            "type": "number",
            "description": "Only graded lots at or below this numeric grade (e.g. 10). Same rules as Min grade."
          },
          "yearMin": {
            "title": "Min year",
            "minimum": 0,
            "type": "integer",
            "description": "Only lots whose title states a card year at or after this (e.g. 1986). Lots with no year in the title are dropped."
          },
          "yearMax": {
            "title": "Max year",
            "minimum": 0,
            "type": "integer",
            "description": "Only lots whose title states a card year at or before this. Same rules as Min year."
          },
          "rookiesOnly": {
            "title": "Rookies only",
            "type": "boolean",
            "description": "Only lots whose title says Rookie, RC or 1st Bowman.",
            "default": false
          },
          "autographedOnly": {
            "title": "Autographs only",
            "type": "boolean",
            "description": "Only lots whose title says Auto, Autograph, Signed or Signature.",
            "default": false
          },
          "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."
          },
          "includeLotDetails": {
            "title": "Include Lot Details",
            "type": "boolean",
            "description": "Marketplace and past-auctions modes: add description, category, sub-category, item type, serial number and auction name to every lot (the search listing leaves them empty). Each enriched lot is billed one extra record charge. Lot mode always includes them at no extra charge.",
            "default": false
          },
          "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}