{
  "openapi": "3.0.1",
  "info": {
    "title": "Goldin Scraper",
    "description": "Goldin sold prices and live lots for card collectors, dealers and investors: 800k+ sports cards, Pokemon, comics and memorabilia sold since 2012, with final price plus buyer's premium, grader, grade, pop, bids and auction. Every filter, no 20k cap, cert numbers and photos as an add-on.",
    "version": "1.0",
    "x-build-id": "cMoGeEKLYUNlcjRJe"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/normdata~goldin-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-normdata-goldin-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/normdata~goldin-scraper/runs": {
      "post": {
        "operationId": "runs-sync-normdata-goldin-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/normdata~goldin-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-normdata-goldin-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": {
          "maxItems": {
            "title": "Maximum lots",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many lots in total. Leave empty for no limit (every matching lot, even past the 20,000 results Goldin lists per search). The Apify Free plan is always capped at 10."
          },
          "status": {
            "title": "What to scrape",
            "enum": [
              "sold",
              "live"
            ],
            "type": "string",
            "description": "Sold lots are past sales with the final price (prices realized), back to 2012: about 800,000 lots. Live lots are open for bidding now (with the current bid) or for sale in the fixed price marketplace."
          },
          "searchTerms": {
            "title": "Search terms",
            "type": "array",
            "description": "One search per line, e.g. \"michael jordan rookie\", \"charizard 1st edition\", \"ohtani\". Leave empty to browse everything (narrowed by the filters below).",
            "items": {
              "type": "string"
            }
          },
          "matchDescriptions": {
            "title": "Match words in descriptions too",
            "type": "boolean",
            "description": "Off: every word of a search term must be in the lot title (Goldin also matches long description boilerplate, which brings unrelated lots). On: keep everything Goldin matches."
          },
          "urls": {
            "title": "...or paste goldin.co links",
            "type": "array",
            "description": "Lot pages (goldin.co/item/...) or whole auctions (goldin.co/auction/...: every lot in the auction). The filters are ignored with links.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "categories": {
            "title": "Category",
            "type": "array",
            "description": "Keep only lots in ANY of these Goldin categories.",
            "items": {
              "type": "string",
              "enum": [
                "Sport",
                "Non-Sport",
                "Treasures From The PSA Vault",
                "Sports Cards",
                "Non-Sports Cards",
                "Sports Memorabilia",
                "Oscar Alley Collection",
                "Video Games",
                "Full Tickets & Stubs",
                "Game-Used Memorabilia",
                "Game Used Memorabilia",
                "Non-Sports Memorabilia",
                "Karl Malone Collection",
                "1970 Topps Set Break",
                "Video Tapes",
                "1952 Topps Set Break",
                "Collectible Shoes",
                "SRP Apex Collection",
                "World's Finest Pele Card Collection",
                "2014 Prizm World Cup Collection",
                "Welsh Dragon Collection",
                "Tickets",
                "Art and Documents",
                "Kobe Bryant Cards & Collectibles",
                "\"Art, Lithos, Posters and more\"",
                "Pittsburgh Steelers Memorabilia",
                "Team Rocket Liquidation Collection",
                "National 2026",
                "OJ Simpson Collection",
                "Video",
                "Bill Mosman Check Collection",
                "Autographs",
                "Super Bowl Cards & Collectibles",
                "Sports",
                "The Beatles Collection",
                "Logan Paul's Booster Pack Break",
                "Vladimir Guerrero Jr. Collection",
                "VHS Tapes",
                "Barry Bonds Collection",
                "Birol Nadir Collection",
                "Stars Servin' up Love",
                "Experiences",
                "Costumes",
                "Entertainment",
                "Unopened Product (Cases / Boxes / Packs)",
                "Toys",
                "High Grade Hall of Fame Plaque Postcard Collection",
                "Leo D Sullivan Collection",
                "Logan Paul & Ken Goldin 1st Edition Pokemon Box Break",
                "Gregg Allman Collection",
                "Aters Collection",
                "Scott Spiegel Collection",
                "Lionsgate Partnership",
                "Mach-Hommy Collection",
                "Emmitt Smith Collection",
                "Non-Weapon Props",
                "Pete Rose Collection",
                "Reggie Jackson Collection",
                "Weapon Props",
                "Hugh Hefner Collection",
                "Unopened Product (Cases/Boxes/Packs)",
                "MNADV Charity Items",
                "Dave Wottle Collection",
                "Naismith Basketball Hall Of Fame"
              ],
              "enumTitles": [
                "Sport (329,357)",
                "Non-Sport (121,077)",
                "Treasures From The PSA Vault (50,060)",
                "Sports Cards (35,214)",
                "Non-Sports Cards (2,735)",
                "Sports Memorabilia (2,246)",
                "Oscar Alley Collection (2,238)",
                "Video Games (1,901)",
                "Full Tickets & Stubs (1,461)",
                "Game-Used Memorabilia (1,081)",
                "Game Used Memorabilia (799)",
                "Non-Sports Memorabilia (704)",
                "Karl Malone Collection (538)",
                "1970 Topps Set Break (489)",
                "Video Tapes (346)",
                "1952 Topps Set Break (289)",
                "Collectible Shoes (277)",
                "SRP Apex Collection (266)",
                "World's Finest Pele Card Collection (222)",
                "2014 Prizm World Cup Collection (185)",
                "Welsh Dragon Collection (174)",
                "Tickets (155)",
                "Art and Documents (136)",
                "Kobe Bryant Cards & Collectibles (130)",
                "\"Art, Lithos, Posters and more\" (111)",
                "Pittsburgh Steelers Memorabilia (101)",
                "Team Rocket Liquidation Collection (100)",
                "National 2026 (98)",
                "OJ Simpson Collection (93)",
                "Video (87)",
                "Bill Mosman Check Collection (81)",
                "Autographs (78)",
                "Super Bowl Cards & Collectibles (78)",
                "Sports (74)",
                "The Beatles Collection (73)",
                "Logan Paul's Booster Pack Break (72)",
                "Vladimir Guerrero Jr. Collection (68)",
                "VHS Tapes (66)",
                "Barry Bonds Collection (65)",
                "Birol Nadir Collection (65)",
                "Stars Servin' up Love (64)",
                "Experiences (60)",
                "Costumes (51)",
                "Entertainment (49)",
                "Unopened Product (Cases / Boxes / Packs) (45)",
                "Toys (43)",
                "High Grade Hall of Fame Plaque Postcard Collection (37)",
                "Leo D Sullivan Collection (37)",
                "Logan Paul & Ken Goldin 1st Edition Pokemon Box Break (36)",
                "Gregg Allman Collection (34)",
                "Aters Collection (33)",
                "Scott Spiegel Collection (33)",
                "Lionsgate Partnership (30)",
                "Mach-Hommy Collection (30)",
                "Emmitt Smith Collection (29)",
                "Non-Weapon Props (29)",
                "Pete Rose Collection (28)",
                "Reggie Jackson Collection (26)",
                "Weapon Props (25)",
                "Hugh Hefner Collection (24)",
                "Unopened Product (Cases/Boxes/Packs) (24)",
                "MNADV Charity Items (23)",
                "Dave Wottle Collection (20)",
                "Naismith Basketball Hall Of Fame (20)"
              ]
            }
          },
          "subCategories": {
            "title": "Sub-category",
            "type": "array",
            "description": "Keep only ANY of these: sport (Baseball, Basketball, Football, Soccer...), game (Pokemon, Magic...) or comic era.",
            "items": {
              "type": "string",
              "enum": [
                "Baseball",
                "Basketball",
                "Football",
                "Pokemon",
                "Soccer",
                "Pop Culture/Entertainment",
                "Modern Age",
                "Modern (1988 and newer)",
                "Hockey",
                "Silver Age",
                "Marvel",
                "Racing",
                "Bronze Age",
                "Boxing/MMA",
                "Star Wars",
                "History",
                "Golf",
                "Vintage (1987 and earlier)",
                "Modern (post-1990)",
                "Yu-Gi-Oh!",
                "Wrestling",
                "Other",
                "Modern (post-1980)",
                "Golden Age",
                "Rock N' Roll",
                "Magic The Gathering",
                "Tennis",
                "DC",
                "Disney",
                "One Piece",
                "Nintendo",
                "Sets and Collections",
                "Apparel",
                "Unopened Product (Cases / Boxes / Packs)",
                "Equipment",
                "Olympics",
                "Vintage (pre-1990)",
                "Pop",
                "Other Sport",
                "Garbage Pail Kids",
                "MetaZoo",
                "Rap/Hip-Hop",
                "Vintage (pre-1980)",
                "Sports Ticket Stubs",
                "Full Sports Tickets",
                "Presidents & Political Figures",
                "Harry Potter",
                "Alternative",
                "U.S. Coins",
                "Metal",
                "Return of the Jedi",
                "Alternative Rock",
                "Entertainment Memorabilia",
                "Sealed Video Games",
                "PlayStation",
                "Dragon Ball",
                "Music",
                "Relics",
                "Empire Strikes Back",
                "World Coins",
                "Other Sports",
                "Historical Figures",
                "Power of the Force",
                "Entertainment",
                "PiggyBanx",
                "Magic",
                "Photographs",
                "VHS",
                "Labubu",
                "Anime",
                "VeeFriends",
                "Multi-Sport",
                "Boxing",
                "Horror",
                "Historical Memorabilia",
                "MMA",
                "Non-Sports Autographs",
                "Militaria",
                "Hip-Hop/Rap",
                "TV",
                "Animation",
                "Contemporary",
                "The 3 Stooges",
                "Uncut Sheets",
                "NASA",
                "Vintage",
                "Nike",
                "Los Angeles Rams Partnership",
                "XBOX",
                "Funko Pop!",
                "Programs",
                "Sports",
                "Reggae",
                "Classic Hollywood",
                "Atari",
                "Medals",
                "Jazz",
                "Superhero",
                "Weiss Schwarz",
                "Contemporary TV",
                "Publications",
                "Air Jordan",
                "Disney Lorcana",
                "Historical",
                "Blues/Jazz",
                "1960's-1970's Film",
                "Ancient Coins",
                "Contemporary Film",
                "Animation - Who Framed Roger Rabbit?",
                "1990's Film",
                "U.S. Currency"
              ],
              "enumTitles": [
                "Baseball (137,288)",
                "Basketball (114,877)",
                "Football (74,862)",
                "Pokemon (55,575)",
                "Soccer (34,332)",
                "Pop Culture/Entertainment (19,269)",
                "Modern Age (10,512)",
                "Modern (1988 and newer) (9,527)",
                "Hockey (9,458)",
                "Silver Age (8,766)",
                "Marvel (7,517)",
                "Racing (6,730)",
                "Bronze Age (6,295)",
                "Boxing/MMA (5,912)",
                "Star Wars (3,762)",
                "History (3,373)",
                "Golf (3,205)",
                "Vintage (1987 and earlier) (2,524)",
                "Modern (post-1990) (2,269)",
                "Yu-Gi-Oh! (2,073)",
                "Wrestling (2,027)",
                "Other (1,948)",
                "Modern (post-1980) (1,937)",
                "Golden Age (1,919)",
                "Rock N' Roll (1,771)",
                "Magic The Gathering (1,632)",
                "Tennis (1,468)",
                "DC (1,350)",
                "Disney (1,345)",
                "One Piece (1,171)",
                "Nintendo (1,146)",
                "Sets and Collections (907)",
                "Apparel (846)",
                "Unopened Product (Cases / Boxes / Packs) (705)",
                "Equipment (657)",
                "Olympics (581)",
                "Vintage (pre-1990) (491)",
                "Pop (484)",
                "Other Sport (481)",
                "Garbage Pail Kids (458)",
                "MetaZoo (444)",
                "Rap/Hip-Hop (423)",
                "Vintage (pre-1980) (324)",
                "Sports Ticket Stubs (321)",
                "Full Sports Tickets (319)",
                "Presidents & Political Figures (319)",
                "Harry Potter (311)",
                "Alternative (307)",
                "U.S. Coins (305)",
                "Metal (296)",
                "Return of the Jedi (283)",
                "Alternative Rock (268)",
                "Entertainment Memorabilia (256)",
                "Sealed Video Games (254)",
                "PlayStation (209)",
                "Dragon Ball (202)",
                "Music (192)",
                "Relics (192)",
                "Empire Strikes Back (180)",
                "World Coins (175)",
                "Other Sports (163)",
                "Historical Figures (143)",
                "Power of the Force (139)",
                "Entertainment (133)",
                "PiggyBanx (132)",
                "Magic (128)",
                "Photographs (128)",
                "VHS (125)",
                "Labubu (123)",
                "Anime (122)",
                "VeeFriends (122)",
                "Multi-Sport (120)",
                "Boxing (116)",
                "Horror (116)",
                "Historical Memorabilia (115)",
                "MMA (114)",
                "Non-Sports Autographs (113)",
                "Militaria (110)",
                "Hip-Hop/Rap (109)",
                "TV (108)",
                "Animation (102)",
                "Contemporary (101)",
                "The 3 Stooges (100)",
                "Uncut Sheets (89)",
                "NASA (85)",
                "Vintage (80)",
                "Nike (76)",
                "Los Angeles Rams Partnership (64)",
                "XBOX (62)",
                "Funko Pop! (56)",
                "Programs (53)",
                "Sports (52)",
                "Reggae (52)",
                "Classic Hollywood (49)",
                "Atari (47)",
                "Medals (47)",
                "Jazz (46)",
                "Superhero (44)",
                "Weiss Schwarz (44)",
                "Contemporary TV (44)",
                "Publications (42)",
                "Air Jordan (41)",
                "Disney Lorcana (41)",
                "Historical (41)",
                "Blues/Jazz (35)",
                "1960's-1970's Film (25)",
                "Ancient Coins (25)",
                "Contemporary Film (24)",
                "Animation - Who Framed Roger Rabbit? (23)",
                "1990's Film (21)",
                "U.S. Currency (21)"
              ]
            }
          },
          "itemTypes": {
            "title": "Item type",
            "type": "array",
            "description": "Keep only ANY of these: single cards, memorabilia, comics, sealed boxes, tickets, video games...",
            "items": {
              "type": "string",
              "enum": [
                "Single Cards",
                "Memorabilia",
                "Comics",
                "Cases/Boxes/Packs",
                "Sets and Collections",
                "Game-Used Memorabilia",
                "Graded Magazines",
                "Original/Vintage Photos",
                "Tickets and Passes",
                "Signed Photos/Prints",
                "Video Games",
                "VHS and Betamax",
                "Toys",
                "Programs and Publications",
                "Vinyl Records",
                "Jerseys",
                "Music",
                "Posters",
                "Coins and Currency",
                "Photographs",
                "Art",
                "Uncut Sheets",
                "CDs and Cassettes",
                "CD's & Cassette's",
                "Musical Instruments",
                "Carded Figures",
                "Autograph Memorabilia",
                "Original / Vintage Photos",
                "Media",
                "Loose Figures",
                "Photos",
                "Animation",
                "Bats/Clubs/Sticks",
                "Signed Baseballs",
                "Cleats/Sneakers",
                "Game-Used Balls",
                "Bats / Clubs / Sticks",
                "Other Media",
                "Sneakers",
                "CDs & Cassettes",
                "Cleats / Sneakers",
                "Photos and Video Tapes",
                "Animation Cels & Art",
                "Props",
                "Comic Art",
                "Cut Signatures",
                "Props - Memorabilia",
                "Gloves",
                "Awards",
                "Manga",
                "Signed Cards",
                "Equipment",
                "Rings/Watches/Jewelry",
                "Experiences",
                "Costumes",
                "Single-Signed Baseballs",
                "Prints/Posters",
                "Signed Prints/Photos",
                "Letters and Documents",
                "Hats/Helmets",
                "Warmup Jackets / Shirts",
                "Letters & Documents",
                "Other",
                "Scripts",
                "Warmup Jackets/Shirts",
                "Pants",
                "Movie Props/Costumes",
                "Prop Weapons",
                "Movie Props",
                "Props - Costumes",
                "Playboy Graded Magazines",
                "Vehicles",
                "Hats / Helmets",
                "Memorabilia/Ephemera",
                "Miscellaneous Toys",
                "Warmups/Jackets",
                "Art / Posters",
                "Awards and Trophies",
                "Game-Used Balls/Pucks",
                "Fashion",
                "Movie Props/Memorabilia",
                "Collectible Shoes",
                "Marionettes",
                "Vintage Clothing",
                "Celebrity/Major Event Experiences",
                "LaserDisc",
                "CD's & Cassette Tapes",
                "Helmets / Masks",
                "Prototypes",
                "Memorabilia / Ephemera",
                "Playsets",
                "Lightsabers",
                "Stage-Used Memorabilia",
                "Clothing",
                "iPhone"
              ],
              "enumTitles": [
                "Single Cards (351,755)",
                "Memorabilia (36,446)",
                "Comics (31,837)",
                "Cases/Boxes/Packs (18,027)",
                "Sets and Collections (9,018)",
                "Game-Used Memorabilia (8,148)",
                "Graded Magazines (7,034)",
                "Original/Vintage Photos (6,921)",
                "Tickets and Passes (5,687)",
                "Signed Photos/Prints (5,293)",
                "Video Games (3,688)",
                "VHS and Betamax (2,256)",
                "Toys (2,230)",
                "Programs and Publications (1,669)",
                "Vinyl Records (1,445)",
                "Jerseys (1,294)",
                "Music (1,124)",
                "Posters (1,064)",
                "Coins and Currency (1,053)",
                "Photographs (865)",
                "Art (807)",
                "Uncut Sheets (481)",
                "CDs and Cassettes (459)",
                "CD's & Cassette's (452)",
                "Musical Instruments (397)",
                "Carded Figures (385)",
                "Autograph Memorabilia (371)",
                "Original / Vintage Photos (345)",
                "Media (343)",
                "Loose Figures (331)",
                "Photos (309)",
                "Animation (227)",
                "Bats/Clubs/Sticks (217)",
                "Signed Baseballs (201)",
                "Cleats/Sneakers (199)",
                "Game-Used Balls (193)",
                "Bats / Clubs / Sticks (178)",
                "Other Media (178)",
                "Sneakers (178)",
                "CDs & Cassettes (175)",
                "Cleats / Sneakers (163)",
                "Photos and Video Tapes (153)",
                "Animation Cels & Art (149)",
                "Props (137)",
                "Comic Art (136)",
                "Cut Signatures (135)",
                "Props - Memorabilia (131)",
                "Gloves (130)",
                "Awards (129)",
                "Manga (128)",
                "Signed Cards (124)",
                "Equipment (123)",
                "Rings/Watches/Jewelry (123)",
                "Experiences (115)",
                "Costumes (90)",
                "Single-Signed Baseballs (84)",
                "Prints/Posters (82)",
                "Signed Prints/Photos (80)",
                "Letters and Documents (78)",
                "Hats/Helmets (67)",
                "Warmup Jackets / Shirts (66)",
                "Letters & Documents (60)",
                "Other (59)",
                "Scripts (51)",
                "Warmup Jackets/Shirts (50)",
                "Pants (47)",
                "Movie Props/Costumes (45)",
                "Prop Weapons (44)",
                "Movie Props (42)",
                "Props - Costumes (42)",
                "Playboy Graded Magazines (41)",
                "Vehicles (41)",
                "Hats / Helmets (40)",
                "Memorabilia/Ephemera (39)",
                "Miscellaneous Toys (34)",
                "Warmups/Jackets (24)",
                "Art / Posters (23)",
                "Awards and Trophies (22)",
                "Game-Used Balls/Pucks (22)",
                "Fashion (20)",
                "Movie Props/Memorabilia (18)",
                "Collectible Shoes (17)",
                "Marionettes (17)",
                "Vintage Clothing (16)",
                "Celebrity/Major Event Experiences (15)",
                "LaserDisc (14)",
                "CD's & Cassette Tapes (13)",
                "Helmets / Masks (13)",
                "Prototypes (13)",
                "Memorabilia / Ephemera (12)",
                "Playsets (12)",
                "Lightsabers (11)",
                "Stage-Used Memorabilia (11)",
                "Clothing (10)",
                "iPhone (10)"
              ]
            }
          },
          "graders": {
            "title": "Grading company",
            "type": "array",
            "description": "Keep only items graded by ANY of these (as Goldin lists them).",
            "items": {
              "type": "string",
              "enum": [
                "PSA",
                "Ungraded",
                "Beckett",
                "Other",
                "CGC",
                "SGC",
                "CGC Signature Series",
                "WATA",
                "AMG",
                "AFA",
                "VMG",
                "JSA",
                "VGA",
                "BGS",
                "Multiple",
                "CAS",
                "Ursa Authentic",
                "Rewind",
                "NGC",
                "CGC Qualified",
                "CSG",
                "PCGS",
                "Coronado",
                "CBCS",
                "CGC Ungraded",
                "CGC/JSA Authentic Autograph",
                "PSA/DNA GU",
                "IGS",
                "PSA/DNA",
                "TAG"
              ],
              "enumTitles": [
                "PSA (316,363)",
                "Ungraded (50,690)",
                "Beckett (49,243)",
                "Other (34,285)",
                "CGC (30,639)",
                "SGC (12,634)",
                "CGC Signature Series (5,760)",
                "WATA (2,048)",
                "AMG (893)",
                "AFA (692)",
                "VMG (568)",
                "JSA (513)",
                "VGA (327)",
                "BGS (326)",
                "Multiple (318)",
                "CAS (233)",
                "Ursa Authentic (155)",
                "Rewind (129)",
                "NGC (94)",
                "CGC Qualified (90)",
                "CSG (52)",
                "PCGS (39)",
                "Coronado (38)",
                "CBCS (37)",
                "CGC Ungraded (15)",
                "CGC/JSA Authentic Autograph (10)",
                "PSA/DNA GU (9)",
                "IGS (8)",
                "PSA/DNA (7)",
                "TAG (3)"
              ]
            }
          },
          "auctionType": {
            "title": "Auction type",
            "enum": [
              "Elite",
              "Weekly",
              "Thematic",
              "Fixed_Price"
            ],
            "type": "string",
            "description": "Keep only one kind of sale."
          },
          "minPrice": {
            "title": "Min price",
            "minimum": 0,
            "type": "integer",
            "description": "Final price for sold lots, current bid or asking price for live lots."
          },
          "maxPrice": {
            "title": "Max price",
            "minimum": 0,
            "type": "integer",
            "description": "Same price as \"Min price\"."
          },
          "yearFrom": {
            "title": "Year from",
            "minimum": 0,
            "type": "integer",
            "description": "Year of the item (card season, issue year), e.g. 1952."
          },
          "yearTo": {
            "title": "Year to",
            "minimum": 0,
            "type": "integer",
            "description": "e.g. 1989."
          },
          "soldFrom": {
            "title": "Sold from",
            "type": "string",
            "description": "Sold lots only: sold on or after this date. A date like \"2025-01-01\", or a period like \"30 days\" or \"6 months\"."
          },
          "soldTo": {
            "title": "Sold to",
            "type": "string",
            "description": "Same format as \"Sold from\", e.g. \"2025-12-31\"."
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "recent",
              "price_high",
              "price_low",
              "most_bids",
              "least_bids",
              "most_views",
              "newly_listed"
            ],
            "type": "string",
            "description": "Order of the results. Matters most when you set a Maximum."
          },
          "titleIncludes": {
            "title": "Title must contain",
            "type": "array",
            "description": "Keep only lots whose title contains ANY of these words, e.g. \"rookie\", \"auto\", \"1/1\", \"pop 1\". Not case sensitive.",
            "items": {
              "type": "string"
            }
          },
          "titleExcludes": {
            "title": "Title must not contain",
            "type": "array",
            "description": "Drop lots whose title contains any of these words, e.g. \"lot of\", \"collection\", \"reprint\".",
            "items": {
              "type": "string"
            }
          },
          "minGrade": {
            "title": "Min grade",
            "minimum": 0,
            "maximum": 10,
            "type": "number",
            "description": "Keep only graded items with at least this grade, from 1 to 10, e.g. 9.5. Ungraded items are dropped when a grade range is set."
          },
          "maxGrade": {
            "title": "Max grade",
            "minimum": 0,
            "maximum": 10,
            "type": "number",
            "description": "Keep only graded items with at most this grade."
          },
          "minBids": {
            "title": "Min bids",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only lots with at least this many bids."
          },
          "maxBids": {
            "title": "Max bids",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only lots with at most this many bids. 0 finds live lots nobody has bid on yet."
          },
          "rookiesOnly": {
            "title": "Rookie cards only",
            "type": "boolean",
            "description": "Keep only lots with \"Rookie\" or \"RC\" in the title."
          },
          "autographedOnly": {
            "title": "Autographed only",
            "type": "boolean",
            "description": "Keep only signed or autographed items (\"Signed\", \"Auto\", \"Autograph\" in the title)."
          },
          "maxPrintRun": {
            "title": "Max print run",
            "minimum": 0,
            "type": "integer",
            "description": "Keep only serial numbered cards with a print run up to this, e.g. 25 keeps /25, /10, /5 and 1/1 cards."
          },
          "includeDetails": {
            "title": "Full lot details",
            "type": "boolean",
            "description": "Add the lot page to every lot: full description, category, item type, cert number, views, last bid time, listing date, seller and winner IDs, every photo and video, plus player, set and card number where Goldin lists them. Charged as an add-on per lot."
          },
          "onlyNew": {
            "title": "New lots only",
            "type": "boolean",
            "description": "For scheduled runs: save only lots this same search has not saved before. The first run saves everything; later runs save just what is new. Kept per search (terms, links and filters)."
          },
          "monitorName": {
            "title": "Monitor name",
            "type": "string",
            "description": "Optional. Give \"New lots only\" a fixed name to keep its memory even after you change the filters."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}