Art Collections

CollectorIQ auction lots

CollectorIQ auction records: past and upcoming lots with artist life years and nationality, medium, dimensions, signature, provenance, literature, exhibitions, condition, lot number and images, for art research and provenance checks.

collectorsiq-lotsartauctionscollectorsiqprice-databaselots

31,636 rows in the dataset · last run Oct 27, 2026

Prefer a file without code? Buy the CollectorIQ auction lots dataset or get a free 100-row sample.

Download the dataset

Get the full dataset as one CSV or JSONL file. If the data is older than maxAgeHours, it is refreshed automatically first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/collectorsiq-lots/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 31,636 rows, this download costs $19.02, down to $4.755 in volume (317 credits) when the data is fresh enough, or $38.04, down to $9.51 in volume (634 credits) when it has to be refreshed first.

This is a Standard dataset: 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To get exactly the targets you want, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/collectorsiq-lots/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxLots": 0,      "maxSales": 0,      "includePast": true,      "includeUpcoming": true    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected ($1.2, down to $0.3 in volume per 1,000 rows). A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Limits

maxLots
number
Max lots
0 means no limit.
Default
0
Range
at least 0
maxSales
number
Max sales / auctions
0 means no limit.
Default
0
Range
at least 0

Targeting

includePast
boolean
Include past (results) sales
Default
true
includeUpcoming
boolean
Include upcoming / live sales
Default
true
fetchLotDetails
boolean
Include full lot details
Adds provenance, literature, condition and the full image set. Turning this off is faster but returns fewer fields.
Default
true
startPage
number
Start page of past sales
Past results are listed newest first, 50 per page. Raise this to continue a deep history.
Default
1
Range
1 to 200000

Pacing

requestDelayMs
number
Delay between requests (ms)
Default
750
Range
0 to 60000

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "maxLots": {      "type": "number",      "minimum": 0,      "title": "Max lots",      "description": "0 means no limit.",      "default": 0    },    "maxSales": {      "type": "number",      "minimum": 0,      "title": "Max sales / auctions",      "description": "0 means no limit.",      "default": 0    },    "includePast": {      "type": "boolean",      "title": "Include past (results) sales",      "default": true    },    "includeUpcoming": {      "type": "boolean",      "title": "Include upcoming / live sales",      "default": true    },    "fetchLotDetails": {      "type": "boolean",      "title": "Include full lot details",      "description": "Adds provenance, literature, condition and the full image set. Turning this off is faster but returns fewer fields.",      "default": true    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 60000,      "title": "Delay between requests (ms)",      "default": 750    },    "startPage": {      "type": "number",      "minimum": 1,      "maximum": 200000,      "title": "Start page of past sales",      "description": "Past results are listed newest first, 50 per page. Raise this to continue a deep history.",      "default": 1    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/collectorsiq-lots/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "maxLots": 0,      "maxSales": 0,      "includePast": true,      "includeUpcoming": true    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

The fields this scraper delivers. Coverage is the share of rows that include each field.

Field	Type	Coverage
artist_birth_year	number	94%
artist_death_year	number	63%
artist_id	string	100%
artist_name	string	100%
artist_nationality	string	80%
condition_report	string	46%
creation_year	number	85%
depth_cm	number	10%
description	string	96%
dimensions_text	string	99%
edition	string	14%
exhibition_history	string	33%
extra	object	100%
height_cm	number	99%
image_url	string	100%
images	array	100%
literature	string	32%
lot_key	string	100%
lot_number	string	100%
medium	string	99%
object_category	string	100%
provenance	string	74%
sale_location	string	86%
sale_status	string	100%
sale_type	string	100%
signature	string	85%
source_lot_id	string	100%
title	string	100%
width_cm	number	97%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
sale_end_at	date	100%
sale_start_at	date	100%
updated_at	date	100%
_id	string	100%