Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaE-commerceAvailable now

HiBid · Search auctions

hibid-com/online-auctions/search_auctions

Get product, price and seller data with HiBid · Search auctions from Alexandria through one Spiral API key. To find auction ids for auction and search_lots (catalog listing), to list one auctioneer's auctions (auctioneer_id, e.g. 87212 for citadelgalleryauctions.hibid.com), or to find past auctions (archived=true with date_start/date_end). It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.00873 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
ziptext—

Pattern: ^[A-Za-z0-9 -]{3,10}$.

pagenumber
1 to 1000
1

page

milesnumber
1 to 5000
—

Radius around zip in miles (default 50 when zip is given). Requires zip.

querytext—

Keyword over auction titles and lots; with archived=true a date range is required.

statetext—

Two-letter US state or Canadian province code. Pattern: ^[A-Za-z]{2}$.

statusone of
OPEN, ALL
OPEN

OPEN: auctions accepting bids now (default). ALL: open and upcoming current auctions. Ignored when archived=true.

countryone of
United States, Canada
—

country

archivedtrue or false—

Completed auctions from HiBid's archive instead of current ones.

date_endtext—

Archive only: latest closing date (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

page_sizenumber
1 to 100
20

page_size

date_starttext—

Archive only: earliest closing date (YYYY-MM-DD). Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$.

category_idtext—

Pattern: ^[0-9]{1,12}$.

auctioneer_idtext—

Only this auction company's auctions (HiBid company id, from auctioneers). Pattern: ^[0-9]{1,12}$.

shipping_offeredtrue or false—

shipping_offered

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "hibid-com/online-auctions/search_auctions",
    "input": {
      "zip": "<zip>"
    }
  }'

Frequently asked questions

How much does HiBid · Search auctions cost?

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use HiBid · Search auctions through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "hibid-com/online-auctions/search_auctions"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use HiBid · Search auctions?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use HiBid · Search auctions?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.