Artprice lots and marketplace
Artprice art market data: Artprice Marketplace artworks with asking price, seller, dimensions, edition, condition, description and full-size images, plus partner auction lots with estimates, starting prices, provenance, literature and images.
75,525 rows in the dataset · last run Nov 2, 2026
Prefer a file without code? Buy the Artprice lots and marketplace 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/artprice-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.csvAt its current 75,525 rows, this download costs $45.36, down to $11.34 in volume (756 credits) when the data is fresh enough, or $90.72, down to $22.68 in volume (1,512 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/artprice-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
maxLotsnumber
Max lots
0 means no limit.
- Default
0- Range
- at least 0
maxSalesnumber
Max sales / auctions
0 means no limit.
- Default
0- Range
- at least 0
Targeting
includePastboolean
Include past (results) sales
- Default
true
includeUpcomingboolean
Include upcoming / live sales
- Default
true
fetchLotDetailsboolean
Include full lot details
Adds provenance, literature, condition and the full image set. Turning this off is faster but returns fewer fields.
- Default
true
includeMarketplaceboolean
Include Artprice Marketplace listings
Artworks offered for sale by galleries and collectors on the Artprice Marketplace, with asking prices.
- Default
true
Pacing
requestDelayMsnumber
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.
{ "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 }, "includeMarketplace": { "type": "boolean", "title": "Include Artprice Marketplace listings", "description": "Artworks offered for sale by galleries and collectors on the Artprice Marketplace, with asking prices.", "default": true } }}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/artprice-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 | 54% |
| artist_death_year | number | 53% |
| artist_id | string | 98% |
| artist_name | string | 98% |
| asking_price | number | 93% |
| auction_house | string | 6% |
| condition_report | string | 63% |
| creation_date_text | string | 4% |
| creation_year | number | 83% |
| currency | string | 98% |
| depth_cm | number | 23% |
| description | string | 74% |
| dimensions_text | string | 99% |
| edition | string | 29% |
| estimate_high | number | 3% |
| estimate_low | number | 4% |
| extra | object | 98% |
| hammer_price | number | 4% |
| height_cm | number | 99% |
| image_url | string | 98% |
| images | array | 100% |
| last_sold_currency | string | 4% |
| last_sold_price | number | 4% |
| literature | string | 2% |
| lot_key | string | 100% |
| lot_number | string | 6% |
| medium | string | 6% |
| object_category | string | 98% |
| premium_price | number | 1% |
| provenance | string | 1% |
| sale_id | string | 1% |
| sale_location | string | 6% |
| sale_status | string | 100% |
| sale_title | string | 5% |
| sale_type | string | 100% |
| signature | string | 81% |
| sold_price | number | 4% |
| source_lot_id | string | 100% |
| title | string | 100% |
| width_cm | number | 95% |
| created_at | date | 100% |
| first_seen_at | date | 100% |
| last_seen_at | date | 100% |
| last_sold_at | date | 4% |
| sale_end_at | date | 6% |
| sale_start_at | date | 6% |
| sold_at | date | 4% |
| updated_at | date | 100% |
| _id | string | 100% |