# TractorHouse Scraper — Farm Equipment Prices & Dealer Monitor (`crawloop/tractorhouse-scraper`) Actor

Scrape TractorHouse US (.com) and Europe (.eu / country hosts) farm equipment listings: asking prices, make/model/year, hours, serials, dealer phones, and images. Monitor mode tracks new inventory and price changes.

- **URL**: https://apify.com/crawloop/tractorhouse-scraper.md
- **Developed by:** [Andrej Kiva](https://apify.com/crawloop) (community)
- **Categories:** E-commerce, Lead generation, AI
- **Features:** Limited permissions
- **Stats:** 5 total users, 4 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.50 / 1,000 scraped tractorhouse listings

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## TractorHouse Scraper — Farm Equipment Prices, Specs & Dealer Phones

> **Disclaimer:** Unofficial tool — not affiliated with, sponsored by, or endorsed by TractorHouse, Sandhills Global, Sandhills East, or their brands or its affiliates. Data is read from publicly accessible pages only. No login. You are responsible for complying with applicable law (including GDPR where personal data appears) and the site’s terms. No warranty on accuracy or availability. Provided for informational and research use.

> **Contact-data controls:** Phone/WhatsApp/fax fields are omitted from the dataset by default. Enable `includePhones` only for numbers already published on public pages and only when you have a lawful basis. Any contact-field examples below assume that explicit opt-in; otherwise those fields are absent.

> **Crawloop Used Machinery Marketplace Suite** — US and Europe TractorHouse asking prices, dealer phones, and inventory change alerts. Pair with Fastline / MachineryPete / EquipmentTrader for other US boards, or Machineryline / Traktorpool for European coverage beyond Sandhills.

| TractorHouse | Machineryline | Nettikone | AuctionTime | Purple Wave |
| :--- | :--- | :--- | :--- | :--- |
| TractorHouse Scraper ◄── you are here | [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) | [Nettikone Scraper](https://apify.com/crawloop/nettikone-scraper) | [AuctionTime Scraper](https://apify.com/crawloop/auctiontime-scraper) | [Purple Wave Auctions Scraper](https://apify.com/crawloop/purplewave-scraper) |

| US independent boards | Fastline | MachineryPete | EquipmentTrader |
| :--- | :--- | :--- | :--- |
| Sandhills TractorHouse | [Fastline Scraper](https://apify.com/crawloop/fastline-scraper) | [MachineryPete Scraper](https://apify.com/crawloop/machinerypete-scraper) | [EquipmentTrader Scraper](https://apify.com/crawloop/equipmenttrader-scraper) |

| Agrofy | Mascus | Traktorpool | Landwirt |
| :--- | :--- | :--- | :--- |
| [Agrofy Scraper](https://apify.com/crawloop/agrofy-scraper) | [Mascus Scraper](https://apify.com/crawloop/mascus-scraper) | [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) | [Landwirt Scraper](https://apify.com/crawloop/landwirt-scraper) |

| IronPlanet | GovPlanet | Ritchie Bros | MachineryTrader | TruckPaper |
| :--- | :--- | :--- | :--- | :--- |
| [IronPlanet Scraper](https://apify.com/crawloop/ironplanet-scraper) | [GovPlanet Scraper](https://apify.com/crawloop/govplanet-scraper) | [Ritchie Bros Auction Scraper](https://apify.com/crawloop/rbauction-scraper) | [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) | [TruckPaper Scraper](https://apify.com/crawloop/truckpaper-scraper) |

| One dataset | TractorHouse, MachineryTrader, AuctionTime |
| :--- | :--- |
| [Farm Equipment Listings Scraper](https://apify.com/crawloop/farm-equipment-listings-scraper) | Shared schema. Machinery Pete and Fastline are optional sources |

### What this TractorHouse scraper does

This **TractorHouse scraper** turns farm equipment for-sale listings into a structured Apify dataset: asking price, make, model, year, hours, serial number, dealer phone, WhatsApp (common on EU cards), location, and images. It covers **US** (`tractorhouse.com`) and **Europe** (`tractorhouse.eu` plus country fronts such as `tractor-house.de`, `tractorhouse.fr`, `tractorhouse.it`) — the same Sandhills SSR catalog stack. Use it as a TractorHouse API alternative for dealers, appraisers, lenders, and data teams who need tractor, combine, and implement comps in **Python**, **Node.js**, or **MCP** — export JSON / CSV / Excel without manual browsing.

Run `listings` for fast catalog pulls (retail cards already include dealer phone and specs) or `details` for PDP street-address enrichment. Enable **`monitorMode`** on an Apify Schedule to track **new inventory**, **price changes**, and **listings that leave** a dealer or category.

### When to use

- Dealer competitive intelligence — watch a rival `AccountCRMID` inventory daily (US or EU)
- Asking-price comps for tractors, combines, planters, tillage, hay/forage, and grain equipment
- Fleet sourcing by manufacturer, model, hours, US state, or European country/region
- Outreach lists with published dealer phones and WhatsApp (no details mode required for most retail cards)
- Sandhills Europe catalog pulls via `baseUrl: "https://www.tractorhouse.eu"` (or a country host)
- Join TractorHouse asking prices with other US boards from [Fastline Scraper](https://apify.com/crawloop/fastline-scraper) or [MachineryPete Scraper](https://apify.com/crawloop/machinerypete-scraper)
- Join TractorHouse asking prices with non-Sandhills EU boards from [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper)

#### When not to use

- You need authenticated Auction Results **sold** hammer prices (often login-gated) — this Actor returns auction metadata; use `pricedOnly` to skip zeros
- You only need non-Sandhills European farm boards (Traktorpool, Machineseeker, etc.) — start with those Actors
- You need construction-heavy boards beyond farm — use [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) or [EquipmentTrader Scraper](https://apify.com/crawloop/equipmenttrader-scraper)
- You need public auction hammer prices — use [Ritchie Bros Auction Scraper](https://apify.com/crawloop/rbauction-scraper) or [IronPlanet Scraper](https://apify.com/crawloop/ironplanet-scraper)

### Regions & hosts

| Region | Host | Notes |
| :--- | :--- | :--- |
| United States | `https://www.tractorhouse.com` | Default `baseUrl` |
| Europe (English paths) | `https://www.tractorhouse.eu` | Prefer **unprefixed** paths (`/listings/...`); locale prefixes can be fragile |
| Germany | `https://www.tractor-house.de` | Same EU inventory; DE slugs (`/auflistungen/...`, `/auflistung/zum-verkauf/...`) |
| France | `https://www.tractorhouse.fr` | Same EU inventory; FR detail slugs under `/referencement/...` |
| Italy | `https://www.tractorhouse.it` | Same EU inventory; IT detail slugs under `/annuncio/...` |

`.eu` and country fronts share **one Europe-wide catalog** (same listing ids). Mixing `.eu` + `.de` start URLs in one run is fine — the Actor dedupes by listing `id`.

### US ↔ EU farm equipment workflow

```
Sandhills farm asking prices         Other US / EU / auctions
────────────────────────────         ─────────────────────────

  TractorHouse Scraper ◄── you are here
       │ .com + .eu / DE / FR / IT
       │ dealer phones, hours, serials, monitor deltas
       ▼
  Fastline / MachineryPete / ET ──► other US farm & construction boards
  MachineryTrader Scraper ────────► Sandhills US construction
  Traktorpool Scraper ────────────► DACH farm classifieds
  Machineryline Scraper ──────────► EU heavy equipment
  Troostwijk / Surplex ───────────► auction lots & bids

  Join by make + model + year ──► comps, remarketing, residual checks
```

### Key features

- **US + Europe** — one Actor for `.com`, `.eu`, and Sandhills country hosts
- **Search URL or filters** — paste a search / dealer inventory / category URL, or build one from manufacturer, category id, keywords, state, and `AccountCRMID`
- **Two modes** — `listings` (fast SSR cards with phone + specs) and `details` (ld+json address enrichment)
- **Monitor mode** — seed fingerprints, then emit only `new`, `price_change`, and `removed` rows; optional Telegram alerts
- **Dealer phones on cards** — outreach fields without visiting every PDP; WhatsApp denser on EU
- **Cloudflare-ready** — `curl_cffi` Chrome TLS; Apify Residential recommended (US for `.com`, DE/NL/FR for Europe)
- **Priced-only filter** — skip Call-for-price and zero-price rows
- **Listing types** — `For Retail`, `For Rent`, and `Auction Results` metadata (sold prices may be login-gated)
- **Cross-host dedupe** — same listing id emitted once per run

### Input

| Field | Type | Default | Description |
| :--- | :--- | :--- | :--- |
| `includePhones` | Boolean | `false` | Keep published phone, WhatsApp, and fax fields. Off, those fields are omitted |
| `startUrls` | Array | John Deere tractors sample | Search, category, dealer inventory, or detail URLs (any supported host) |
| `searchQuery` | String | — | Keywords for a built search URL |
| `listingType` | String | `For Retail` | `For Retail`, `For Rent`, or `Auction Results` |
| `manufacturer` | String | — | e.g. `JOHN DEERE`, `CASE IH`, `CLAAS` |
| `category` | String | — | Category id (e.g. `1100` tractors, `1112` combines) |
| `accountCrmId` | String | — | Dealer `AccountCRMID` inventory watch |
| `state` | String | — | US state / region filter when building a search URL |
| `sort` | String | — | Sort for a built search URL (`9` recently added, `2` price low to high, `3` price high to low, `5` year high to low) |
| `baseUrl` | String | `https://www.tractorhouse.com` | Origin for built search URLs (set `.eu` or a country host for Europe) |
| `runMode` | String | `listings` | `listings` or `details` |
| `pricedOnly` | Boolean | `false` | Keep only rows with a published price |
| `maxItems` | Integer | `100` | Emit budget. In monitor mode, also the seed fingerprint budget. A run that hits this cap does not emit removals |
| `maxPagesPerUrl` | Integer | `10` | Pages per start URL (~28 listings/page). Hitting the cap skips the removal diff |
| `concurrencyLimit` | Integer | `5` | Parallel PDP fetches in `details` mode |
| `monitorMode` | Boolean | `false` | After a seed run, emit `new`, `price_change`, and `removed` |
| `monitorStoreName` | String | `tractorhouse-monitor-state` | Distinct name per watch target |
| `telegramToken` | String | — | Bot token for alerts on new, price-change, and removed rows |
| `telegramChatId` | String | — | Chat that receives those alerts |
| `resetMonitorState` | Boolean | `false` | Clear stored fingerprints before this run (forces a new seed) |
| `proxyConfiguration` | Object | US Residential prefill | Apify proxy settings |

```json
{
  "startUrls": [
    {
      "url": "https://www.tractorhouse.com/listings/search?ListingType=For%20Retail&AccountCRMID=27106803"
    }
  ],
  "runMode": "listings",
  "monitorMode": true,
  "monitorStoreName": "th-dealer-27106803",
  "maxItems": 500,
  "maxPagesPerUrl": 20,
  "pricedOnly": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "US"
  }
}
```

Europe example (Sandhills EU catalog):

```json
{
  "baseUrl": "https://www.tractorhouse.eu",
  "manufacturer": "JOHN DEERE",
  "category": "1100",
  "listingType": "For Retail",
  "runMode": "listings",
  "maxItems": 100,
  "pricedOnly": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  }
}
```

With `monitorMode: true`, the first run seeds fingerprints and writes **no** dataset rows. Later scheduled runs emit `changeType: "new"`, `"price_change"`, or `"removed"`.

A `removed` row is the last saved `id`, `title`, `url`, and price (`price`, `currency`, `priceFormatted`). Dealer, hours, specs, and photos are not kept in the fingerprint, so those fields are empty. The row is written only after every list page in the watch was read. A run that stops on `maxItems`, `maxPagesPerUrl`, a blocked page, or a page with no catalog model keeps the old fingerprints and does not emit removals. A seed run and a run that only opens detail URLs do not emit removals either. Set `maxItems` and `maxPagesPerUrl` high enough to cover the whole dealer or category, or a machine that left the yard stays silent.

### Output

| Field | Description |
| :--- | :--- |
| `id` | Listing id (shared across `.eu` and country hosts) |
| `title` / `make` / `model` / `year` | Equipment identity |
| `price` / `currency` / `priceFormatted` | Asking price when published (EUR / USD / GBP) |
| `hours` / `serialNumber` / `stockNumber` | Specs from the card |
| `dealerName` / `dealerPhone` / `dealerWhatsapp` / `dealerWebsite` | Dealer contact |
| `accountCrmId` | Dealer account key for inventory watch URLs |
| `location` / `city` / `state` / `country` / `postalCode` | Machine location |
| `images` / `imageCount` | Photo URLs |
| `specs` | Spec key/value map from the card |
| `changeType` / `previousPrice` / `monitoredAt` | `new`, `price_change`, or `removed`. `previousPrice` is set only on `price_change`. On `removed`, `price` is the last saved asking price |

```json
{
  "id": "257864499",
  "title": "2021 BOBCAT V923",
  "make": "BOBCAT",
  "model": "V923",
  "year": "2021",
  "price": 92500,
  "currency": "USD",
  "priceFormatted": "USD $92,500",
  "condition": "Used",
  "category": "Telehandlers",
  "hours": "570",
  "dealerName": "Canes Inc.",
  "dealerPhone": "+19134989624",
  "accountCrmId": "27106803",
  "location": "Spring Hill, Kansas 66083",
  "url": "https://www.tractorhouse.com/listing/for-sale/257864499/2021-bobcat-v923-telehandlers-lifts"
}
```

### Use cases

| Job | How |
| :--- | :--- |
| **Competitor dealer watch** | `accountCrmId` + `monitorMode` on an Apify Schedule. Each full pass reports new stock, price changes, and machines that left |
| **John Deere / Case IH / CLAAS price scan** | Manufacturer + category filters, `pricedOnly`, export JSON or CSV |
| **Europe Sandhills inventory** | `baseUrl` → `.eu` (or DE/FR/IT host) + residential proxy in-region |
| **Dealer outreach list** | `listings` mode — phones (and often WhatsApp on EU) already on retail cards |
| **Equipment valuation comps** | Filter by make/model/year/hours; join with Traktorpool for non-Sandhills stock |
| **MCP / AI research** | Ask an assistant via Apify MCP to run filters and summarize prices |

### Integration examples

#### Node.js

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

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('crawloop/tractorhouse-scraper').call({
  manufacturer: 'JOHN DEERE',
  category: '1100',
  runMode: 'listings',
  maxItems: 50,
  pricedOnly: true,
  proxyConfiguration: {
    useApifyProxy: true,
    apifyProxyGroups: ['RESIDENTIAL'],
    apifyProxyCountry: 'US',
  },
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.slice(0, 3));
```

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("crawloop/tractorhouse-scraper").call(
    run_input={
        "baseUrl": "https://www.tractorhouse.eu",
        "manufacturer": "CLAAS",
        "category": "1100",
        "runMode": "listings",
        "maxItems": 80,
        "pricedOnly": True,
        "proxyConfiguration": {
            "useApifyProxy": True,
            "apifyProxyGroups": ["RESIDENTIAL"],
            "apifyProxyCountry": "DE",
        },
    }
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item.get("title"), item.get("price"), item.get("currency"), item.get("country"))
```

#### cURL

```bash
curl "https://api.apify.com/v2/acts/crawloop~tractorhouse-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"manufacturer\":\"JOHN DEERE\",\"category\":\"1100\",\"maxItems\":25,\"pricedOnly\":true}"
```

### MCP and AI assistants

Use this Actor from AI tools via [Apify MCP](https://docs.apify.com/platform/integrations/mcp). Connect your Apify account, then call this Actor by its Store ID / name (`crawloop/tractorhouse-scraper`).

Example prompts:

- "Run TractorHouse Scraper for JOHN DEERE tractors, max 40, priced only, and return title, price, hours, dealerPhone as JSON"
- "Scrape TractorHouse Europe (.eu) for CLAAS tractors category 1100 with DE residential proxy and return title, price, country, dealerWhatsapp"
- "Monitor dealer AccountCRMID 27106803 on TractorHouse and list new, price-changed, and removed rows"
- "Scrape TractorHouse listings for combines in IA, then compare asking prices with Fastline Scraper or Traktorpool Scraper for the same make and model"

### Suite next step

For TractorHouse, MachineryTrader, and AuctionTime in one dataset, run [Farm Equipment Listings Scraper](https://apify.com/crawloop/farm-equipment-listings-scraper). After a single-site TractorHouse export, pull other US boards with [Fastline Scraper](https://apify.com/crawloop/fastline-scraper) or [MachineryPete Scraper](https://apify.com/crawloop/machinerypete-scraper), construction stock with [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) or [EquipmentTrader Scraper](https://apify.com/crawloop/equipmenttrader-scraper), auction comps with [IronPlanet Scraper](https://apify.com/crawloop/ironplanet-scraper) or [Ritchie Bros Auction Scraper](https://apify.com/crawloop/rbauction-scraper), DACH farm stock with [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) or [Landwirt Scraper](https://apify.com/crawloop/landwirt-scraper), or European heavy equipment contacts with [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper).

### FAQ

**Is this a TractorHouse API?**\
There is no official public bulk API for most users. This Actor is a structured scrape / API alternative that returns a dataset you can call from Python, Node.js, cURL, or MCP.

**How do I scrape TractorHouse farm equipment listings?**\
Paste a filtered search or category URL into `startUrls`, set `maxItems`, and run. Or set `manufacturer` + `category` (e.g. John Deere tractors `1100`) and let the Actor build the search URL. For Europe, set `baseUrl` to `https://www.tractorhouse.eu` or paste a `.eu` / country-host URL.

**Does this cover TractorHouse Europe / Germany?**\
Yes — same Actor. Use `tractorhouse.eu` (English paths) or country hosts such as `tractor-house.de`. They share one EU catalog; listing ids match across those hosts.

**Do I need details mode for dealer phones?**\
Usually no — retail cards already expose `dealerPhone`, website, and location (WhatsApp is common on EU cards). Use `details` when you need street address from PDP ld+json.

**How do I watch one dealer?**\
Set `accountCrmId` (from any listing card) or paste a dealer inventory search URL, enable `monitorMode`, pick a unique `monitorStoreName`, and schedule the Actor. The first run only stores fingerprints. Later runs emit new machines, price changes, and machines that left the inventory. Cover the whole list with `maxItems` and `maxPagesPerUrl`: a capped or blocked run keeps the old fingerprints and does not emit `removed`. Optional `telegramToken` and `telegramChatId` send the same three alerts.

**Why are Auction Results prices empty?**\
Sold amounts are often login-gated in anonymous HTML (`Price: 0`). The Actor still returns auction metadata; use `pricedOnly` to skip zero rows.

**Which proxy should I use?**\
Apify Residential — `apifyProxyCountry: "US"` for `.com`, and a European country (e.g. `DE`) for `.eu` / country hosts. All sit behind Cloudflare.

**Can I filter John Deere tractors only?**\
Yes — set `manufacturer` to `JOHN DEERE` and `category` to `1100`, or paste an equivalent search URL in `startUrls`.

**What about Case IH combines or Kubota UTVs?**\
Same pattern: set manufacturer (`CASE IH`, `KUBOTA`, …) and the matching category id from a filtered search URL, or paste that URL directly.

### Related Actors

| Actor | Role |
| :--- | :--- |
| [Farm Equipment Listings Scraper](https://apify.com/crawloop/farm-equipment-listings-scraper) | TractorHouse, MachineryTrader, and AuctionTime in one dataset |
| [Fastline Scraper](https://apify.com/crawloop/fastline-scraper) | US Fastline farm & construction classifieds |
| [MachineryPete Scraper](https://apify.com/crawloop/machinerypete-scraper) | US MachineryPete ZIP/FSBO farm classifieds |
| [EquipmentTrader Scraper](https://apify.com/crawloop/equipmenttrader-scraper) | US EquipmentTrader construction & farm |
| [MachineryTrader Scraper](https://apify.com/crawloop/machinerytrader-scraper) | Sandhills US heavy equipment |
| [Traktorpool Scraper](https://apify.com/crawloop/traktorpool-scraper) | European farm machinery (non-Sandhills) |
| [Machineryline Scraper](https://apify.com/crawloop/machineryline-scraper) | EU heavy equipment + dealer contacts + monitor |
| [Nettikone Scraper](https://apify.com/crawloop/nettikone-scraper) | Finland used machinery |
| [Agrofy Scraper](https://apify.com/crawloop/agrofy-scraper) | Brazil + Argentina farm marketplace |
| [Mascus Scraper](https://apify.com/crawloop/mascus-scraper) | Global used machinery classifieds |
| [Landwirt Scraper](https://apify.com/crawloop/landwirt-scraper) | AT/DE agrar classifieds + dealer machinery |
| [Exapro Scraper](https://apify.com/crawloop/exapro-scraper) | European used industrial machinery |
| [Machineseeker Scraper](https://apify.com/crawloop/machineseeker-scraper) | Machineseeker / Maschinensucher regional boards |
| [Truck1 Scraper](https://apify.com/crawloop/truck1-scraper) | European trucks & construction equipment |
| [Troostwijk Scraper](https://apify.com/crawloop/troostwijk-scraper) | European industrial auction lots |
| [Surplex Scraper](https://apify.com/crawloop/surplex-scraper) | European plant-closure auctions |
| [IronPlanet Scraper](https://apify.com/crawloop/ironplanet-scraper) | US weekly online equipment auctions |
| [GovPlanet Scraper](https://apify.com/crawloop/govplanet-scraper) | US government and military surplus |
| [Ritchie Bros Auction Scraper](https://apify.com/crawloop/rbauction-scraper) | Sold hammer prices and regional auctions |
| [Machinio Scraper](https://apify.com/crawloop/machinio-scraper) | Global used-equipment aggregator |
| [TruckPaper Scraper](https://apify.com/crawloop/truckpaper-scraper) | US Sandhills commercial trucks |

# Actor input Schema

## `includePhones` (type: `boolean`):

Off by default. Include phone, mobile, WhatsApp, or fax fields already published on public pages only when you have a lawful basis.

## `startUrls` (type: `array`):

Search results, category SEO pages, dealer inventory URLs (AccountCRMID / LocationID), or direct listing detail pages. US: tractorhouse.com. Europe: tractorhouse.eu (English paths) or country hosts (tractor-house.de, tractorhouse.fr, tractorhouse.it — localized path slugs).

## `searchQuery` (type: `string`):

Optional keyword search appended as a built search URL (e.g. round baler, 8R, combine).

## `listingType` (type: `string`):

Used when building a search URL from filters (or when startUrls is empty). Auction Results metadata is public; sold prices are often login-gated.

## `manufacturer` (type: `string`):

Filter by brand when building a search URL (e.g. JOHN DEERE, CASE IH, KUBOTA, NEW HOLLAND, BOBCAT, CLAAS).

## `category` (type: `string`):

TractorHouse category id (e.g. 1100 tractors, 1112 combines/harvesters). Same ids on US and Europe.

## `accountCrmId` (type: `string`):

Watch a single dealer inventory by AccountCRMID (from listing cards). Builds /listings/search?...\&AccountCRMID=...

## `state` (type: `string`):

Optional State query filter when building a search URL (US: TX, IA, KS; Europe hosts may accept region names where Sandhills supports them).

## `sort` (type: `string`):

Optional sort key for built search URLs (9 = Recently Added, 2 = Price Low→High, 3 = Price High→Low, 5 = Year High→Low).

## `baseUrl` (type: `string`):

Site origin for built search URLs. US default: https://www.tractorhouse.com. Europe catalog: https://www.tractorhouse.eu (prefer unprefixed English paths). Country fronts (same EU inventory): https://www.tractor-house.de, https://www.tractorhouse.fr, https://www.tractorhouse.it.

## `runMode` (type: `string`):

listings = fast card fields (price, make/model, hours, dealer phone, images). details = also visit each PDP for ld+json address enrichment.

## `pricedOnly` (type: `boolean`):

Skip Call-for-price / zero-price rows (and gated Auction Results sold prices that show as 0).

## `maxItems` (type: `integer`):

Maximum dataset rows to emit (in monitor seed runs: max listings to fingerprint).

## `maxPagesPerUrl` (type: `integer`):

Maximum pagination pages per search / dealer inventory URL (28 listings per page).

## `proxyConfiguration` (type: `object`):

Apify Residential Proxies recommended — TractorHouse uses Cloudflare. Prefer US for .com, DE/NL/FR for .eu / country hosts.

## `concurrencyLimit` (type: `integer`):

Parallel PDP fetches in details mode.

## `monitorMode` (type: `boolean`):

Delta tracking for category, search, or dealer inventory URLs. First run seeds a named Key-Value store (no dataset rows / alerts). Later runs output new listings, price changes, and listings that left the watch. A removed row is emitted only after every list page was read. A run that stops on maxItems, maxPagesPerUrl, or a blocked page keeps the old fingerprints and does not emit removals. Pair with an Apify Schedule.

## `monitorStoreName` (type: `string`):

Named Key-Value store for fingerprints across scheduled runs. Use a distinct name per watch target (dealer or category).

## `telegramToken` (type: `string`):

Bot token for real-time alerts on new listings, price changes, and removed listings (monitorMode only).

## `telegramChatId` (type: `string`):

Telegram user or group chat ID that receives monitor alerts.

## `resetMonitorState` (type: `boolean`):

Clear stored listing fingerprints before this run (forces a fresh seed run).

## Actor input object example

```json
{
  "includePhones": false,
  "startUrls": [
    {
      "url": "https://www.tractorhouse.com/listings/for-sale/john-deere/tractors/1100"
    }
  ],
  "searchQuery": "JOHN DEERE 8R",
  "listingType": "For Retail",
  "manufacturer": "JOHN DEERE",
  "category": "1100",
  "accountCrmId": "27106803",
  "state": "IA",
  "sort": "9",
  "baseUrl": "https://www.tractorhouse.com",
  "runMode": "listings",
  "pricedOnly": false,
  "maxItems": 100,
  "maxPagesPerUrl": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  },
  "concurrencyLimit": 5,
  "monitorMode": false,
  "monitorStoreName": "tractorhouse-monitor-state",
  "resetMonitorState": false
}
```

# Actor output Schema

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

Default dataset items: farm equipment listings with prices, hours, serials, and dealer phones.

# 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 = {
    "startUrls": [
        {
            "url": "https://www.tractorhouse.com/listings/for-sale/john-deere/tractors/1100"
        }
    ],
    "baseUrl": "https://www.tractorhouse.com",
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    },
    "monitorStoreName": "tractorhouse-monitor-state"
};

// Run the Actor and wait for it to finish
const run = await client.actor("crawloop/tractorhouse-scraper").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 = {
    "startUrls": [{ "url": "https://www.tractorhouse.com/listings/for-sale/john-deere/tractors/1100" }],
    "baseUrl": "https://www.tractorhouse.com",
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
    "monitorStoreName": "tractorhouse-monitor-state",
}

# Run the Actor and wait for it to finish
run = client.actor("crawloop/tractorhouse-scraper").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 '{
  "startUrls": [
    {
      "url": "https://www.tractorhouse.com/listings/for-sale/john-deere/tractors/1100"
    }
  ],
  "baseUrl": "https://www.tractorhouse.com",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  },
  "monitorStoreName": "tractorhouse-monitor-state"
}' |
apify call crawloop/tractorhouse-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,crawloop/tractorhouse-scraper"
        }
    }
}
```

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/b4QEuKFjR5TVpgXEv/builds/qvQjYfnU6KoqhBUFF/openapi.json