HiBid lot
One HiBid lot: title, description, estimate, quantity, status, high bid, minimum next bid and the next bid steps, bid count, buy-now price, price realized for closed lots, time left, soft close, every photo, categories, and the auction (dates, terms, buyer's premium, bid increments, shipping and pickup, payment, location, auction house). Pass id, url, or q with latest=true (first current search result).
Every response includes credits_used: the credits this call cost.
Parameters
| name | type | description |
|---|---|---|
id | string | Lot id (id of a search result, or the number in a hibid.com/lot/... link). |
url | string | Instead of id: a hibid.com/lot/... link. |
q | string | With latest=true: search words; the first current search result is used (the search filters also apply). Example: coins |
latest | string | true: run the search and use its first result. Example: true |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/hibid/v1/lot" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/hibid/v1/lot",
params={},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/hibid/v1/lot");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).