# HiBid Lot Tracker (`gertz_harman/hibid-lot-tracker`) Actor

HiBid.com 경매 lot의 입찰 상태(현재가, 입찰수, 마감까지 남은 시간 등)를 주기적으로 폴링해서 변화가 생길 때마다 기록합니다.

- **URL**: https://apify.com/gertz\_harman/hibid-lot-tracker.md
- **Developed by:** [GERTZ HARMAN](https://apify.com/gertz_harman) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 lot updates

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

Track **live bid status** on [HiBid.com](https://hibid.com/) auction lots — thousands of small and mid-size US auction houses (estates, collectibles, coins, real estate, farm and industrial equipment) list and run their sales through HiBid's shared platform. This Actor polls each lot's live GraphQL data feed at a short interval and records every time the current bid, bid count, or status changes, so you get a structured history of how a lot's price moved instead of a single static snapshot. Just give it one or more HiBid lot URLs and a polling interval — no login required.

### Why use HiBid Lot Tracker?

HiBid hosts a huge long tail of local and regional auctioneers, and watching several lots close together across different auctions means constant manual tab-refreshing. This Actor is built for:

- **Collectors and resellers** (coins, collectibles, estate items) tracking multiple lots at once without babysitting browser tabs.
- **Price research** on categories sold repeatedly across many small auction houses — building a dataset of realized prices over time.
- **Notification pipelines** — combine with Apify's Scheduler and Integrations (Telegram, Slack, email) to get pinged when a tracked lot's price or status changes.
- **Developers** who want structured bid history via API instead of scraping HTML by hand.

### How to use HiBid Lot Tracker

1. Find a lot you want to watch on HiBid.com — the URL contains `/lot/<number>/...`.
2. Paste one or more of these URLs into the **Lot URLs** input field.
3. Set **Poll interval** (how often to recheck, in seconds) and **Max monitoring duration** (how long the run lasts).
4. Run the Actor. Every time a lot's price, bid count, or status changes, a new record is written to the dataset — watch it fill in from the **Output** tab.
5. Export as JSON, CSV, or Excel, or pull results via the Apify API.

### Input

| Field | Type | Description |
|---|---|---|
| `lot_urls` | array of URLs | One or more HiBid lot detail page URLs to monitor |
| `poll_interval_secs` | integer | How often (in seconds) to recheck each lot (default: 8) |
| `max_duration_secs` | integer | How long (in seconds) to keep polling before the run ends (default: 120) |

```json
{
  "lot_urls": [
    { "url": "https://hibid.com/lot/322085290/" }
  ],
  "poll_interval_secs": 8,
  "max_duration_secs": 120
}
```

### Output

Each dataset item represents one observed change in a lot's bidding state:

```json
{
  "source_url": "https://hibid.com/lot/322085290/",
  "auction_id": 777719,
  "auction_name": "Sunday Weekly Auction Collectibles, Comics, Toys, Coins Etc",
  "lot_id": 322085290,
  "lot_number": "356",
  "high_bid": 7,
  "bid_count": 5,
  "min_bid": 8,
  "status": "OPEN",
  "is_closed": false,
  "reserve_satisfied": true,
  "price_realized": 0,
  "time_left_seconds": 456884.5,
  "observed_at": "2026-09-22T18:30:54.382532+00:00"
}
```

You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Data table

| Field | Description |
|---|---|
| `lot_id`, `lot_number` | Identifiers for the auction lot |
| `auction_name` | The auction event this lot belongs to |
| `high_bid` | Current highest bid on the lot |
| `bid_count` | Total number of bids placed so far |
| `min_bid` | Minimum bid needed to lead |
| `status`, `is_closed` | Current lot status (e.g. OPEN, SOLD) |
| `reserve_satisfied` | Whether the reserve price has been met, where applicable |
| `price_realized` | Final sold price once the lot closes |
| `time_left_seconds` | Seconds remaining before the lot closes |
| `observed_at` | Timestamp when this Actor captured the change |

### Pricing / Cost estimation

This Actor uses the pay-per-event pricing model — you pay only for each detected change in a lot's bid/status (event: `lot-update`), not for idle polling with no change. A quiet lot with no new bids costs nothing beyond the initial page load.

### Tips

- HiBid lots don't push live updates on their own — this Actor re-checks each lot on a timer, so shorter `poll_interval_secs` gives finer-grained history at the cost of more compute time.
- Point this at lots nearing their close for the highest density of updates.
- Combine with Apify's [Scheduler](https://docs.apify.com/platform/schedules) to start a run a few minutes before a lot's scheduled close.
- Pipe the dataset into an Apify [webhook](https://docs.apify.com/platform/integrations/webhooks) or [Telegram integration](https://docs.apify.com/platform/integrations/telegram) to get alerted on price changes.

### FAQ & disclaimers

This Actor only reads data that a normal visitor's browser already retrieves when viewing a public lot page — it does not place bids, log in, or bypass any access control beyond loading the public page. It is intended for personal research, price monitoring, and building notification tools. Always respect HiBid's Terms of Service for your specific use case. Site structures can change; if this Actor stops returning data, please open an issue.

# Actor input Schema

## `lot_urls` (type: `array`):

HiBid.com 개별 lot(경매 물품) 상세 페이지 URL 목록 (URL에 /lot/<숫자>/ 형태의 ID가 포함되어야 함)

## `poll_interval_secs` (type: `integer`):

이 간격(초)마다 각 lot의 최신 상태를 다시 확인합니다.

## `max_duration_secs` (type: `integer`):

이 시간(초) 동안 폴링한 뒤 종료합니다.

## Actor input object example

```json
{
  "lot_urls": [
    {
      "url": "https://hibid.com/lot/322085290/"
    }
  ],
  "poll_interval_secs": 8,
  "max_duration_secs": 120
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "lot_urls": [
        {
            "url": "https://hibid.com/lot/322085290/"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("gertz_harman/hibid-lot-tracker").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "lot_urls": [{ "url": "https://hibid.com/lot/322085290/" }] }

# Run the Actor and wait for it to finish
run = client.actor("gertz_harman/hibid-lot-tracker").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "lot_urls": [
    {
      "url": "https://hibid.com/lot/322085290/"
    }
  ]
}' |
apify call gertz_harman/hibid-lot-tracker --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gertz_harman/hibid-lot-tracker"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/8gL7AyI9d9DFFuKrk/builds/VeV7punBBW857cJri/openapi.json