{ "openapi": "3.0.1", "info": { "title": "Invaluable Auctions Scraper - Lots, Prices Realized & Artists", "description": "Scrape Invaluable auction lots with prices realized, upcoming lots open for bidding, and the artist directory. 130 fields including provenance, literature, condition and medium. 28 filters.", "version": "0.2", "x-build-id": "QGQW7WUg5poqzbX1X" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parseforge~invaluable-auctions-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parseforge-invaluable-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/parseforge~invaluable-auctions-scraper/runs": { "post": { "operationId": "runs-sync-parseforge-invaluable-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/parseforge~invaluable-auctions-scraper/run-sync": { "post": { "operationId": "run-sync-parseforge-invaluable-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": { "resultType": { "title": "What to scrape", "enum": [ "past", "upcoming", "artists" ], "type": "string", "description": "`past` reads the archive of ~83 million lots that already went under the hammer, with prices realized. `upcoming` reads the ~232,000 lots currently open for bidding, with live bid counts and geo. `artists` reads Invaluable's artist directory with lifetime lot counts.", "default": "past" }, "searchQuery": { "title": "Search keyword", "type": "string", "description": "Full-text query across lot title, description and artist. Leave empty to browse a category, a house or a date range without a keyword." }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Ceiling on rows written to the dataset. One search request returns up to 100 rows, so this is also the main lever on run cost." }, "sortBy": { "title": "Sort order", "enum": [ "relevance", "priceDesc", "priceAsc", "dateDesc", "dateAsc", "lotNumberAsc", "bidCountDesc", "bidCountAsc", "currentBidDesc", "currentBidAsc", "newestListed", "alphabetical" ], "type": "string", "description": "Which Invaluable sort index to read. Price and date orders exist on the archive; bid count, current bid and newest-listed exist on upcoming lots.", "default": "relevance" }, "categories": { "title": "Departments", "uniqueItems": true, "type": "array", "description": "Top-level Invaluable departments. Empty means every department.", "items": { "type": "string", "enum": [ "Fine Art", "Collectibles", "Decorative Art", "Furniture", "Jewelry", "Dolls, Bears & Toys", "Wines & Spirits", "Asian Art & Antiques", "Firearms", "Automobiles, Boats & Airplanes", "Heavy Equipment", "Farm & Agriculture", "Commercial & Industrial", "Real Estate", "Estate & Storage" ] } }, "subcategories": { "title": "Categories", "uniqueItems": true, "type": "array", "description": "Second taxonomy level, e.g. Painting, Rings, Whiskey. Works on both past and upcoming lots.", "items": { "type": "string", "enum": [ "Painting", "Chinese", "Memorabilia", "Decor & Accessories", "Military & Wartime", "Books, Maps & Manuscripts", "Prints", "Coins, Money & Stamps", "General", "Ceramics & Pottery", "American Indian Art", "Sculpture", "Tables, Stands & Consoles", "Rings", "Couture, Fashion & Accessories", "Glass", "Porcelain & China", "Necklaces & Pendants", "Ethnographic & Indigenous Artifacts", "Japanese", "Lamps & Lights", "Silver & Vertu", "Ephemera, Cards & Documents", "Tools", "Toys", "Rugs & Carpets", "Trains", "Autographs", "Chairs", "Cabinets, Armoires & Cupboards", "Rifles", "Drawings", "Antiquities: Greek, Roman & Egyptian", "Electronics", "Clocks", "Bracelets", "Photography", "Earrings", "Watches, Men's", "Posters", "Mixed Media", "Sporting, Angling & Hunting", "Pins & Brooches", "Pistols", "Revolvers", "Historical, Political & Space", "Loose Stones & Beads", "Southeast Asian", "Vintage", "Mirrors", "Shotguns", "Handguns", "Watches, Women's", "Pens", "Benches & Stools", "Pocket Watches", "Sofas, Couches & Chaises", "Indian & South Asian", "Shelves & Bookcases", "Natural History, Fossils & Minerals", "Dolls", "Musical Instruments & Equipment", "Automobiles", "Games", "Bears", "Men's Jewelry", "Beds", "Boats", "Costume", "Red", "Animation Art", "Dressers & Vanities", "Transportation", "Korean", "Accessories", "Whiskey", "Lawn & Garden Equipment", "Police Collectibles", "Sparkling", "Attachments", "Dessert & Sweet", "Heavy Equipment", "Office Furniture", "Cognac", "Commercial & Industrial", "Farm Equipment", "Tractors", "Trucks & Trailers", "Airplanes", "Farm & Agriculture", "Restaurant Equipment", "ATVs", "Appliances", "Construction Equipment", "Homes", "Home Contents", "White" ] } }, "styles": { "title": "Styles / third level (upcoming only)", "type": "array", "description": "Third taxonomy level, e.g. Landscape, Abstract, Portrait, Nude. Invaluable only publishes this level on upcoming lots, so it is ignored for `past`.", "items": { "type": "string" } }, "auctionHouses": { "title": "Auction houses", "type": "array", "description": "Exact house names as Invaluable spells them, e.g. `Sotheby's`, `Bonhams`. Multiple names are ORed.", "items": { "type": "string" } }, "artistNames": { "title": "Artists", "type": "array", "description": "Exact artist names, e.g. `Pablo Picasso`. Multiple names are ORed.", "items": { "type": "string" } }, "countries": { "title": "Seller countries", "uniqueItems": true, "type": "array", "description": "Country of the selling house.", "items": { "type": "string", "enum": [ "United States of America", "United Kingdom", "France", "Germany", "Italy", "Spain", "Austria", "Belgium", "Netherlands", "Switzerland", "Portugal", "Ireland", "Luxembourg", "Poland", "Czech Republic", "Romania", "San Marino", "Canada", "Australia", "Japan", "China", "Hong Kong", "Singapore", "Thailand", "Indonesia", "Korea, South (Republic)", "Israel", "Qatar", "South Africa", "Colombia", "Uruguay" ] } }, "states": { "title": "Seller state / province (upcoming only)", "type": "array", "description": "State or province of the selling house, e.g. `New York`. Invaluable only indexes this on upcoming lots.", "items": { "type": "string" } }, "currencies": { "title": "Sale currencies", "uniqueItems": true, "type": "array", "description": "Currency the sale is denominated in.", "items": { "type": "string", "enum": [ "USD", "EUR", "GBP", "AUD", "CAD", "CHF", "JPY", "HKD", "SGD", "KRW", "THB", "COP", "ZAR", "PLN" ] } }, "saleTypes": { "title": "Sale type (upcoming only)", "uniqueItems": true, "type": "array", "description": "Live auction, timed online auction, or view-only listing.", "items": { "type": "string", "enum": [ "Live", "Timed", "View Only" ] } }, "catalogRefs": { "title": "Catalog references", "type": "array", "description": "Scrape only these sales, by Invaluable catalog reference (the code in a /catalog/ URL).", "items": { "type": "string" } }, "houseRefs": { "title": "House references", "type": "array", "description": "Scrape only these houses, by Invaluable house reference. More precise than a name.", "items": { "type": "string" } }, "artistRefs": { "title": "Artist references", "type": "array", "description": "Scrape only these artists, by Invaluable artist reference.", "items": { "type": "string" } }, "priceResultMin": { "title": "Minimum price realized", "minimum": 0, "type": "integer", "description": "Hammer price floor, in the sale's own currency. Past lots only." }, "priceResultMax": { "title": "Maximum price realized", "minimum": 0, "type": "integer", "description": "Hammer price ceiling, in the sale's own currency. Past lots only." }, "estimateMin": { "title": "Minimum low estimate", "minimum": 0, "type": "integer", "description": "Keeps lots whose low estimate is at least this." }, "estimateMax": { "title": "Maximum high estimate", "minimum": 0, "type": "integer", "description": "Keeps lots whose high estimate is at most this." }, "currentBidMin": { "title": "Minimum current bid", "minimum": 0, "type": "integer", "description": "Live bid floor. Most useful on upcoming lots." }, "currentBidMax": { "title": "Maximum current bid", "minimum": 0, "type": "integer", "description": "Live bid ceiling." }, "minBidCount": { "title": "Minimum bid count", "minimum": 0, "type": "integer", "description": "Keeps lots that already attracted at least this many bids." }, "dateFrom": { "title": "Sale date from", "type": "string", "description": "Inclusive lower bound on the sale date, `YYYY-MM-DD`." }, "dateTo": { "title": "Sale date to", "type": "string", "description": "Inclusive upper bound on the sale date, `YYYY-MM-DD`." }, "soldOnly": { "title": "Only lots with a published price", "type": "boolean", "description": "Keeps lots where a hammer price was published. Invaluable writes 0 both for unsold lots and for houses that withhold results.", "default": false }, "unsoldOnly": { "title": "Only lots with no published price", "type": "boolean", "description": "The inverse: bought-in lots and sales whose house does not publish results.", "default": false }, "onlineOnly": { "title": "Online-only sales", "type": "boolean", "description": "Keeps lots from sales that ran online only.", "default": false }, "withImagesOnly": { "title": "Only lots with a photo", "type": "boolean", "description": "Drops lots the house listed without an image.", "default": false }, "withArtistOnly": { "title": "Only lots with an attributed artist (upcoming only)", "type": "boolean", "description": "Keeps lots Invaluable matched to an artist record. Only indexed on upcoming lots.", "default": false }, "featuredOnly": { "title": "Only featured lots (upcoming only)", "type": "boolean", "description": "Keeps lots the house paid to feature. Only indexed on upcoming lots.", "default": false }, "excludeClosed": { "title": "Exclude closed lots (upcoming only)", "type": "boolean", "description": "Drops lots whose bidding already closed.", "default": false }, "lotUrls": { "title": "Specific lot URLs or references", "type": "array", "description": "Skip search entirely and read these lots directly. Accepts a full invaluable.com lot URL or a bare lot reference. Every row is fully enriched.", "items": { "type": "string" } }, "includeDescription": { "title": "Add the catalogue description", "type": "boolean", "description": "Adds `lotDescription` and `extraText`, the full catalogue text the house wrote for the lot. Comes from the search index, so it costs no extra request.", "default": false }, "includeEstimates": { "title": "Add the pre-sale estimates", "type": "boolean", "description": "Adds `estimateLow` and `estimateHigh`. The `estimateMin` / `estimateMax` filters work whether or not this is on, so you can narrow by estimate without buying the columns.", "default": false }, "includeBidding": { "title": "Add bidding data", "type": "boolean", "description": "Adds `currentBid`, `bidCount` and `reservePrice`. The `currentBidMin`, `currentBidMax` and `minBidCount` filters work whether or not this is on.", "default": false }, "includeImages": { "title": "Add the primary image URLs", "type": "boolean", "description": "Adds `imageUrl`, `thumbnailUrl` and the pixel dimensions of the main photo. `hasImage` and the `withImagesOnly` filter stay free.", "default": false }, "includeGeo": { "title": "Add venue coordinates", "type": "boolean", "description": "Adds `latitude`, `longitude` and `stateName`. Invaluable only indexes coordinates on upcoming lots.", "default": false }, "includeEngagement": { "title": "Add engagement counters", "type": "boolean", "description": "Adds `watcherCount`, `favoriteCount` and `activityCount` — how much attention the lot is getting on Invaluable.", "default": false }, "includeLotDetails": { "title": "Add full lot details (extra request per lot)", "type": "boolean", "description": "Adds provenance, literature, exhibited, condition, medium, dimensions, signature, marks, buyer premium and view counts from the lot own page. One rate-limited request per lot: the slowest and most proxy-hungry option here.", "default": false }, "includeAllImages": { "title": "Add every photo (rides along with lot details)", "type": "boolean", "description": "Adds the full photo array at thumbnail, medium and large resolution with pixel dimensions. Shares the lot-details request, so switching both on costs one request, not two.", "default": false }, "includeCatalogDetails": { "title": "Add sale details (cached per sale)", "type": "boolean", "description": "Adds the sale title, description, venue address, viewing notes and timezone. One request per sale, reused across every lot in it.", "default": false }, "includeArtistProfile": { "title": "Add artist biography (cached per artist)", "type": "boolean", "description": "Adds the artist dates, profession, aliases, genres and biography. One request per artist, reused across the run.", "default": false }, "includeHouseProfile": { "title": "Add auction house profile (cached per house)", "type": "boolean", "description": "Adds the house address, phone, founding date and profile text. One request per house, reused across the run.", "default": false }, "convertToUsd": { "title": "Add USD-normalised prices", "type": "boolean", "description": "Adds `priceResultUsd`, `estimateLowUsd`, `estimateHighUsd` and `currentBidUsd` using Invaluable own conversion rates, so lots in 14 currencies compare directly.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Search needs no proxy and runs proxy-free by default. The optional blocks that fetch a lot, sale, artist or house page do need one: that API answers a short burst per IP and then returns empty bodies. Turn on Apify Proxy, ideally residential, whenever you tick one of those.", "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 } } }, "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 } } } } } } } } } }