# Auction Research

> Researches Bonhams auctions and lots via the Crawlora API — upcoming and past sales, lot search, estimates, realized prices, departments, and auction detail — returning clean JSON. Use when the user wants auction-house research, comparable lots, sale calendars, or public estimate/realized-price data.

- Skill: `crawlora-org/auction-research` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add crawlora-org/auction-research`
- Raw SKILL.md: https://api.skillmd.com/api/skills/crawlora-org/auction-research/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Research & Search
- Author: Crawlora-org (https://skillmd.com/u/crawlora-org)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/crawlora-org/auction-research

---


# Auction research

Search Bonhams' public auction and lot catalog as normalized JSON for sale
calendar research, lot comparisons, estimates, and realized prices.

## When to use this skill

- Find upcoming or past Bonhams auctions.
- Search lots across auctions by object, artist, or category.
- Inspect one auction's metadata and lot list.
- Pull one lot's estimate, realized price, department, and sale facts.

## Setup

- Get a Crawlora API key at [crawlora.net](https://crawlora.net?utm_source=github&utm_medium=referral&utm_campaign=crawlora-skills).
- Set `CRAWLORA_API_KEY` in the environment before running the helper.
- The helper reads `CRAWLORA_API_KEY` from the environment and sends requests to `https://api.crawlora.net/api/v1`.

## How it works

Use `/bonhams/auctions/search` for sale discovery and
`/bonhams/lots/search` for cross-sale lot research. Follow an auction id into
`/bonhams/auctions/{id}` and `/bonhams/auctions/{id}/lots`; use
`/bonhams/lots/{auctionId}/{lotNumber}` for full lot detail.

Full endpoint list: [`reference/endpoints.md`](reference/endpoints.md).