{ "openapi": "3.0.1", "info": { "title": "Invaluable Scraper", "description": "Scrape Invaluable prices realized and upcoming lots: price, estimates, bids, watchers, artist, auction house, location, category, description and photo. 100M+ past lots with every filter and no result cap. Fast: 1,000 lots in seconds.", "version": "1.0", "x-build-id": "ijQYgoFfghjaVxIwH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/normdata~invaluable-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-normdata-invaluable-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~invaluable-scraper/runs": { "post": { "operationId": "runs-sync-normdata-invaluable-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~invaluable-scraper/run-sync": { "post": { "operationId": "run-sync-normdata-invaluable-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 when a search has hundreds of thousands). The Apify Free plan is always capped at 10." }, "mode": { "title": "What to scrape", "enum": [ "sold", "past", "upcoming" ], "type": "string", "description": "Prices realized are past lots that sold, with the price. All past lots adds the ones that did not sell or have no price reported. Upcoming lots are open for bidding now or in future auctions, with the current bid.", "default": "sold" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "One search per line, e.g. \"rolex submariner\", \"tiffany lamp\", \"banksy\". Leave empty to browse a whole category, artist or auction house.", "items": { "type": "string" } }, "categories": { "title": "Categories", "type": "array", "description": "Pick one or more of 108 Invaluable categories and subcategories. Each one is searched separately and combined with the search terms.", "items": { "type": "string", "enum": [ "URF9IESAHL", "KEDZ10Y647", "I13Z7CQUX6", "OY2OUC9LF6", "GEKIBCU9K0", "QC1A8YCACY", "WIARM9WZTW", "MMPDEN06C8", "MDVKEEPFN1", "G95IHKRVHB", "GTVT6ZM3QZ", "BQWOG3FLWY", "PCM15ZAEJA", "5FFNCDPPYM", "EOB7P0TJ34", "NVAZ3UE29G", "SV4INCVA01", "OKYXW1QPNP", "WNDJ7L05CS", "WHUZCHPFAQ", "WXMDZM23Q2", "0EIGHLOFDZ", "9RFC2VPWGO", "4E71Y757DJ", "5ZZ5EOVHXB", "SYHOQE2P4A", "HHO7L7CYWT", "159SUKPT23", "CNWPZEY4P5", "84S3Q8AQNQ", "TOQS909GY1", "SHXN7Y5YVF", "N3JKCFQTNA", "HV9SJ0PETO", "V1810UB55N", "W7JLTHSDLU", "SN06I92UXA", "HVPO5ZEMD1", "YIWIKOSRZQ", "G51MM3JCDR", "HVLGMC4OMS", "0HV8BV6K8Y", "4WSXVOTIS6", "SGRGS21XHW", "YNK73TVSPF", "1C0ZT2W77O", "1GO1XYQ22C", "Q2ENTPZUZ4", "Q98XC2KX80", "IXXFYRCCES", "SG2BIX3JPJ", "X40D0LU64C", "Z3K5WYSB8R", "AF14022FJQ", "5FM3GDY2EF", "QB7AGYS9KO", "SGERF8GX5G", "MH70PM0ARM", "4V19IKE39A", "RWL1SBCJ8X", "5EAIKMJEME", "SSADM5PDL5", "OCHEHPBN2A", "66MNH3RVXU", "Q1M0GV0I2V", "OQO01MZVPQ", "8RA3GB6FWF", "GPI4WFSDTE", "77XL1D8362", "M6LMPIAVCG", "MIYYXXKHP7", "XGC3VSBGB1", "1D7I67OQBU", "9CP1X2GQ1T", "ZG423REXF2", "FRT16H4VXB", "FKAJ7AFLJ9", "TJYLLGLDKA", "8NR4UKTNYX", "SRKP7QTRCL", "O6BTRZR4OK", "AD458E49G9", "CYM81HY1JA", "YKGNZXS2MH", "SD21QYCFQN", "9OACJQ50M0", "18N22YFW7F", "OG1XEE04VI", "Q5BUT80T6S", "7KBYXLPOCW", "O62XLMG5L9", "TQ0X13A58C", "OKRAO7JCZY", "QE9HEBWJZR", "K9OGPEH0Q1", "WBQ0TKYDMB", "MU8Q47SBT3", "YTSQ6JFY66", "R5NXKCYKEM", "S80JXOMMHQ", "5P1KWJO0ML", "TPY5XXMX9V", "RL3109RDRM", "I1KC063J1X", "UYBWZR9OLE", "B244HNR1T1", "JQMYCL2KT7", "8W9YX2GQGI" ], "enumTitles": [ "Asian Art & Antiques", "Asian Art & Antiques > Chinese Art & Antiques", "Asian Art & Antiques > Indian & South Asian Art & Antiques", "Asian Art & Antiques > Japanese Art & Antiques", "Asian Art & Antiques > Korean Antiques & Art", "Asian Art & Antiques > Southeast Asian Art & Antiques", "Automobiles, Boats & Airplanes", "Automobiles, Boats & Airplanes > Airplanes", "Automobiles, Boats & Airplanes > Automobiles", "Automobiles, Boats & Airplanes > Boats", "Automobiles, Boats & Airplanes > Transportation Vehicles", "Collectibles", "Collectibles > Advertising, Paper & Ephemera", "Collectibles > Animation Art", "Collectibles > Autographs", "Collectibles > Books, Maps & Manuscripts", "Collectibles > Coins, Money & Stamps", "Collectibles > Couture, Fashion & Accessories", "Collectibles > Electronics Collectibles", "Collectibles > Historical, Political & Space Collectibles", "Collectibles > Memorabilia", "Collectibles > Military & Wartime Collectibles", "Collectibles > Musical Instruments & Equipment", "Collectibles > Natural History Collectibles, Fossils & Minerals", "Collectibles > Pens", "Collectibles > Police Collectibles", "Collectibles > Sporting, Fishing & Hunting Collectibles", "Collectibles > Tools", "Commercial & Industrial", "Commercial & Industrial > Commercial & Industrial", "Commercial & Industrial > Commercial Fixtures", "Commercial & Industrial > Commercial Tools", "Commercial & Industrial > Office Furniture", "Decorative Art", "Decorative Art > American Indian Art", "Decorative Art > Ceramics & Pottery", "Decorative Art > Ethnographic & Indigenous Artifacts", "Decorative Art > Glass", "Decorative Art > Greek, Roman & Egyptian Antiquities", "Decorative Art > Porcelain & China", "Decorative Art > Silver & Vertu", "Dolls, Bears & Toys", "Dolls, Bears & Toys > Bears", "Dolls, Bears & Toys > Dolls", "Dolls, Bears & Toys > Games", "Dolls, Bears & Toys > Model Trains", "Dolls, Bears & Toys > Toys", "Farm & Agriculture", "Farm & Agriculture > Farm Equipment", "Farm & Agriculture > Livestock", "Fine Art", "Fine Art > Drawings", "Fine Art > Mixed Media Art", "Fine Art > Paintings", "Fine Art > Photography", "Fine Art > Posters", "Fine Art > Prints", "Fine Art > Sculptures", "Firearms > Handguns", "Firearms > Pistols", "Firearms > Revolvers", "Firearms > Rifles", "Firearms > Shotguns", "Furniture", "Furniture > Beds", "Furniture > Benches & Stools", "Furniture > Cabinets, Armoires & Cupboards", "Furniture > Chairs", "Furniture > Clocks", "Furniture > Decor & Accessories", "Furniture > Dressers & Vanities", "Furniture > Lamps & Lights", "Furniture > Mirrors", "Furniture > Rugs & Carpets", "Furniture > Shelves & Bookcases", "Furniture > Sofas, Couches & Chaises", "Furniture > Tables, Stands & Consoles", "Guns & Firearms", "Heavy Equipment", "Heavy Equipment > Heavy Equipment", "Heavy Equipment > Lawn & Garden Equipment", "Heavy Equipment > Tractors", "Heavy Equipment > Trucks & Trailers", "Jewelry", "Jewelry > Bracelets", "Jewelry > Costume Jewelry", "Jewelry > Earrings", "Jewelry > Loose Stones & Beads", "Jewelry > Men's Jewelry", "Jewelry > Men's Watches", "Jewelry > Necklaces & Pendants", "Jewelry > Pins & Brooches", "Jewelry > Pocket Watches & Accessories", "Jewelry > Rings", "Jewelry > Vintage Jewelry", "Jewelry > Women's Watches", "Real Estate", "Real Estate > Commercial Real Estate", "Real Estate > Homes", "Real Estate > Land", "Wines & Spirits", "Wines & Spirits > Cognacs", "Wines & Spirits > Dessert & Sweet Wines", "Wines & Spirits > Red Wines", "Wines & Spirits > Sparkling Wines", "Wines & Spirits > Whiskeys", "Wines & Spirits > White Wines", "Wines & Spirits > Wine & Spirit Accessories" ] } }, "artists": { "title": "Artists or makers", "type": "array", "description": "Invaluable artist names, e.g. \"Andy Warhol\", \"Rene Lalique\", \"Salvador Dali\". Each one is searched separately. A name Invaluable does not list as an artist is searched as keywords.", "items": { "type": "string" } }, "auctionHouses": { "title": "Auction houses", "type": "array", "description": "Keep only lots from these houses, e.g. \"Leonard Joel\", \"Freeman's | Hindman\". A name matches every house holding all its words. A 10 character house ID works too.", "items": { "type": "string" } }, "dateFrom": { "title": "Auction date from", "type": "string", "description": "Past lots: sold on or after this date. Upcoming lots: auction on or after it. A date like \"2024-01-01\", or a period like \"30 days\" (ago for past lots, from now for upcoming lots)." }, "dateTo": { "title": "Auction date to", "type": "string", "description": "Same format as \"Auction date from\", e.g. \"2024-12-31\" or \"7 days\"." }, "countries": { "title": "Auction house country", "type": "array", "description": "Keep only lots sold by houses in ANY of these countries.", "items": { "type": "string", "enum": [ "United States of America", "United Kingdom", "Germany", "Australia", "Austria", "Belgium", "Canada", "France", "Italy", "Spain", "Switzerland", "Netherlands", "Ireland", "Norway", "Sweden", "Denmark", "Portugal", "Israel", "Hong Kong", "Japan", "Singapore", "Qatar", "San Marino", "Monaco", "Hungary", "Poland", "Czech Republic", "Croatia, Republic of (Hrvatska)", "Romania", "South Africa", "Uruguay", "Malaysia", "Kenya" ], "enumTitles": [ "United States", "United Kingdom", "Germany", "Australia", "Austria", "Belgium", "Canada", "France", "Italy", "Spain", "Switzerland", "Netherlands", "Ireland", "Norway", "Sweden", "Denmark", "Portugal", "Israel", "Hong Kong", "Japan", "Singapore", "Qatar", "San Marino", "Monaco", "Hungary", "Poland", "Czech Republic", "Croatia", "Romania", "South Africa", "Uruguay", "Malaysia", "Kenya" ] } }, "states": { "title": "State or region", "type": "array", "description": "Upcoming lots only. Keep only houses in ANY of these states or regions, written in full, e.g. \"Florida\", \"New York\", \"New South Wales\", \"Greater London\".", "items": { "type": "string" } }, "minPrice": { "title": "Min price realized", "minimum": 0, "type": "integer", "description": "Past lots only. Lots that sold for at least this much." }, "maxPrice": { "title": "Max price realized", "minimum": 0, "type": "integer", "description": "Past lots only. Lots that sold for at most this much." }, "minEstimate": { "title": "Min estimate", "minimum": 0, "type": "integer", "description": "Lots whose estimate range reaches at least this amount." }, "maxEstimate": { "title": "Max estimate", "minimum": 0, "type": "integer", "description": "Lots whose estimate range starts at or below this amount." }, "minCurrentBid": { "title": "Min current bid", "minimum": 0, "type": "integer", "description": "Upcoming lots only." }, "maxCurrentBid": { "title": "Max current bid", "minimum": 0, "type": "integer", "description": "Upcoming lots only." }, "minBids": { "title": "Min bids", "minimum": 0, "type": "integer", "description": "Lots with at least this many bids." }, "maxBids": { "title": "Max bids", "minimum": 0, "type": "integer", "description": "Lots with at most this many bids. 0 finds lots nobody has bid on yet." }, "saleTypes": { "title": "Auction type", "type": "array", "description": "Upcoming lots only. Keep only ANY of these.", "items": { "type": "string", "enum": [ "Live", "Timed", "View Only" ], "enumTitles": [ "Live auction", "Timed auction", "View only (no online bidding)" ] } }, "titleExcludes": { "title": "Title must not contain", "type": "array", "description": "Drop lots whose title or description contains any of these words, e.g. \"reproduction\", \"style of\", \"after\". Not case sensitive.", "items": { "type": "string" } }, "urls": { "title": "Invaluable links (filters above are then ignored)", "type": "array", "description": "Lot pages (/auction-lot/...), auctions (/catalog/...: every lot in the sale), artist pages (/artist/...), auction house pages (/auction-house/...), category pages (/paintings/cc-...) or searches (/search?keyword=...). \"What to scrape\" and \"Sort by\" still apply.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sortBy": { "title": "Sort by", "enum": [ "recent", "oldest", "price_high", "price_low", "most_bids", "newly_listed", "lot_number", "best" ], "type": "string", "description": "Order of the results. Matters most when you set a Maximum.", "default": "recent" }, "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).", "default": false }, "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." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Optional, off by default. Invaluable works without one. Turn it on only if runs fail to connect. Proxy traffic is billed to your Apify account." } } }, "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 } } } } } } } } } }