# Interencheres Scraper - Auction Lots, Hammer Prices & Houses (`scrapersdelight/interencheres-auction-scraper`) Actor

Scrape interencheres.com, France's largest auction network: 167,000+ upcoming lots with estimates, photos and the day's hammer prices, plus sales and 541 auction houses with email, phone, address and SIREN. Filter by category, region, date, estimate or auction type; monitor new lots.

- **URL**: https://apify.com/scrapersdelight/interencheres-auction-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** E-commerce, Lead generation, Business
- **Features:** Limited permissions
- **Stats:** 3 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.90 / 1,000 per row returneds

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

### What does Interencheres Scraper do?

**Interencheres Scraper** exports [interencheres.com](https://www.interencheres.com), France's largest network of auction houses (commissaires-priseurs), as structured rows: upcoming **lots** with estimates and photos, the day's **hammer prices**, the **sales** calendar (and 24,000+ past sales with their results PDF), and the **auction houses** with email, phone, address, agrément and SIREN. Built for art and antiques dealers, vehicle and equipment traders, price researchers and anyone selling to auction houses.

Interencheres scraper · Interenchères API · French auction lots scraper · commissaires-priseurs directory

- **Every lot row is complete:** lot number, title and full description (French + the site's English translation), category path, low/high estimate, starting price, photos with the site's own AI captions, and the whole sale and auction house on the same row.
- **Hammer prices:** the Results mode returns lots already under the hammer that day with `sold`, `hammerPrice` and how the winning bid came in (room, live, absentee).
- **Contacts on every row:** auction-house email (99.8% of houses), phone (99.8%), street address, GPS, agrément and VAT number; the SIREN read from the VAT number, checksum-verified.
- **Past the site's 10,000-result window:** a bigger search is split into sale-date windows and read to the end (10,523 of 10,523 lots in a 2-category test).
- **Links that work:** lot, sale and house links are the site's own canonical URLs (47/47 lots and 541/541 houses identical to the site's hrefs), and photo links are the signed image URLs (the bare image path answers HTTP 400).
- **Monitor mode:** deliver only lots, sales or houses not delivered by an earlier run - schedule it daily for new-lot alerts or to collect every hammer price once.
- **No login, cookies or API key.** Export to JSON, CSV, Excel; schedules, webhooks, Make, Zapier, n8n, Google Sheets; callable through the Apify API and MCP.

### What data can you get from Interencheres?

<table>
<tr><td>🔢 Lot id, number, link (<code>lotUrl</code>)</td><td>📝 Title + full description, FR and EN</td><td>🗂️ Category path (site's tree)</td></tr>
<tr><td>💶 Low / high estimate, starting price</td><td>🔨 Sold, hammer price, bid type</td><td>⏱️ Online closing time</td></tr>
<tr><td>📸 Photos + AI captions FR/EN</td><td>🚗 Vehicle: brand, model, VIN, mileage, fuel, 1st registration</td><td>📄 Inspection / history reports</td></tr>
<tr><td>📅 Sale title, date, time zone, type</td><td>⚖️ Voluntary / judicial sale</td><td>💰 Buyer's premium %</td></tr>
<tr><td>📍 Sale venue, GPS, viewing slots</td><td>🚚 Shipping partners and contacts</td><td>📑 Conditions / catalogue / results PDFs</td></tr>
<tr><td>🏛️ Auction house name, legal names</td><td>✉️ House email and phone</td><td>🏢 Agrément, VAT, SIREN, NAF code</td></tr>
</table>

### How to scrape Interencheres with Interencheres Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - the free plan includes monthly credit.
2. Open **Interencheres Scraper** and pick what to scrape: Lots, Results, Sales or Auction houses.
3. Type search terms (`montre`, `Rolex`, `tableau`), paste links from interencheres.com, or set filters (category, region, dates, estimate, auction type).
4. Set **Max rows** and click **Start**.
5. Download the rows as JSON, CSV or Excel, or send them to your tools.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| `mode` | select | `lots` (default), `results` (hammered lots), `sales`, `houses` |
| `searchQueries` | list | The site's full-text search, one search per term |
| `startUrls` | list | Links from interencheres.com: a search, a category, a sale, a lot, an auction house, `/resultats-ventes` |
| `saleIds` / `houseIds` | list | Numeric ids: every lot (or the row) of a sale; a house's lots, sales or record |
| `pastSales` | boolean | Sales mode: the archive of ended sales with their results PDF |
| `categories` | multi-select | The site's 153 categories (a parent includes its children) |
| `regions`, `country` | multi-select / select | The site's 19 regions and 96 departments; 17 countries |
| `latitude`, `longitude`, `radiusKm` | number | Radius search around a point |
| `saleDateFrom`, `saleDateTo`, `saleWithinDays` | date / integer | Sale date window (absolute, or the next N days) |
| `minEstimate`, `maxEstimate` | integer | Estimate range in EUR |
| `auctionTypes` | multi-select | `live`, `online`, `classic` |
| `saleNature`, `premiumOnly`, `deliveryAvailable`, `refundableVatOnly` | select / boolean | The site's own toggles |
| `keywordInDescription` | string | The site's "keyword or lot no." box |
| `sort` | select | Relevance, sale date (both ways), estimate (both ways), most followed, newest published |
| `filters` | JSON | Any other site filter by name, e.g. `{"fuel_type": "diesel", "mileage_range": "0,80000"}` |
| `excludeKeywords`, `onlyWithImages`, `onlySold` | list / boolean | Checks made on every record after it is read |
| `includeCompanyRegistry` | boolean | Add the French company register record for the house's SIREN |
| `monitorMode`, `monitorKey`, `publishedSince` | boolean / string | Only new records; only lots published since a date or "24 hours" |
| `maxItems` | integer | Rows per run, default 100, `0` = no cap |
| `maxItemsPerSearch`, `compact`, `includeRawData`, `descriptionMaxLength` | | Output shaping |
| `maxConcurrency`, `proxyConfiguration` | | Advanced |

#### Input JSON

```json
{
    "mode": "lots",
    "searchQueries": ["montre", "Rolex"],
    "regions": ["Île-de-France"],
    "minEstimate": 500,
    "auctionTypes": ["live", "online"],
    "saleWithinDays": 14,
    "maxItems": 500
}
```

#### Paste a search link to keep its filters

Search on interencheres.com, then paste the address bar link into `startUrls`: the search term, categories, auction types, estimate range, region, sort and page are read from it. A link brings its own filters; the form filters apply to search terms only.

#### Collect the day's hammer prices with Results

The site keeps a sale's lots in its index until the end of its sale day. Results mode reads the lots that have gone under the hammer (2,761 at midday on 2026-10-14); `sold` is false for lots that passed. Schedule a Results run with **monitor mode** in the evening (for example 23:00 Paris time) to collect every hammer price of the day once. Older sales are available as sale rows with their results PDF (`mode: sales`, `pastSales: true`).

#### Getting more than 10,000 lots

The site answers 10,000 results per search. With `maxItems` 0 (or above 10,000) the actor splits a bigger search into sale-date windows and reads each to its end; the rows then come in sale-date order. Tested on a 10,523-lot search: 5 windows, 10,523 unique lots, 49 seconds.

### ⬆️ Output

One row per lot (Lots, Results), per sale (Sales) or per auction house (Auction houses). A real lot row from a test run (shortened):

```json
{
  "recordType": "lot",
  "lotId": 88331982,
  "lotUrl": "https://www.interencheres.com/art-decoration/interieurs-dautrefois-mobiliers-et-objets-dart-684712/lot-88331982.html",
  "lotNumber": "179",
  "title": "Christian SEYBOLD (1695-1768) (d'après)",
  "titleEn": "Christian SEYBOLD (1695–1768) (after)",
  "categoryPath": "Art, Décoration et Collections > Art > Peintures et Dessins > Tableaux modernes et contemporains",
  "lowEstimate": 150,
  "highEstimate": 200,
  "currency": "EUR",
  "saleId": 684712,
  "saleDate": "2026-10-24T12:00:00+00:00",
  "saleType": "live",
  "buyerPremiumPercent": 25,
  "city": "Venette",
  "houseName": "ACCORD ENCHERES COMPIEGNE VENETTE",
  "houseEmail": "art@accord-encheres.com",
  "housePhone": "03 65 98 17 17",
  "houseSiren": "931998371"
}
```

A hammered lot (Results mode): `"sold": true, "hammerPrice": 150, "hammerType": "physical", "lowEstimate": 150, "highEstimate": 200` - a gilt bronze portico clock sold in the room in Brive-la-Gaillarde on 2026-10-14.

An auction-house row (with the company register add-on):

```json
{
  "recordType": "house",
  "houseId": 34,
  "houseUrl": "https://www.interencheres.com/commissaire-priseur/2c-partenaires-lyon-34",
  "houseName": "2C PARTENAIRES LYON",
  "houseEmail": "contact@2c-partenaires.com",
  "housePhone": "0472832020",
  "houseStreet": "15 Place Jules Ferry",
  "housePostalCode": "69006",
  "houseCity": "Lyon",
  "houseAgreementNumber": "2010-753",
  "houseVatNumber": "FR04523822492",
  "houseSiren": null,
  "houseJudicialSiren": "394706642",
  "houseRegistryName": "2C PARTENAIRES",
  "houseNafCode": "82.99Z",
  "houseRegistryStatus": "active"
}
```

(`houseSiren` is null here because the VAT number as published fails its own checksum - the key belongs to the judicial office's number - so the register record is for the judicial office's SIREN.)

#### Fields and how often they are filled

Measured on 1,200 lots read on 2026-10-14 in six frames (a keyword search, the whole index, online sales, hammered lots, classic sales, vehicles), and on all 541 auction houses:

| Field | Filled | Field | Filled |
|---|---|---|---|
| `lotUrl`, `title`, `titleEn`, `description`, `categoryPath` | 100% | `houseEmail`, `housePhone`, `houseCity`, GPS | 100% of lot rows |
| `lowEstimate` / `highEstimate` | 91% | `houseVatNumber` | 83% of lot rows, 94% of houses |
| `imageUrl` (photos) | 91% | `houseSiren` (checksum-verified) | 66% of lot rows, 80% of houses |
| photo AI captions | 59% | company register record (add-on) | 82% of houses |
| `lotNumber` | 83% | `houseAgreementNumber` | 83% / 85% |
| `startingPrice`, `biddingEndsAt` | 27% (online sales) | sale venue street / city / GPS | 99% |
| `vehicle` block | 29% of all lots, 74% of the vehicle universe | `saleEmail`, `salePhone` | 99% |
| `documents` (reports) | 21% | `buyerPremiumPercent` | 97% |
| `hammerPrice` | every sold lot (108 of 200 hammered lots sold) | `saleContactEmail` | 32% |
| `shippingMethods` | 60% | `exhibitions` (viewing slots) | 21% |

Not filled by the site, so not delivered: a reserve price, a current online bid, an auction-house website.

### How can I use Interencheres data?

- 🖼️ **Dealers and collectors:** a daily feed of new lots by keyword, category and estimate, before the sale.
- 🔨 **Price research:** hammer prices against estimates, by category, house and region.
- 🚗 **Vehicle and equipment traders:** judicial and voluntary sales of cars, vans and machinery with VIN, mileage and inspection reports.
- 🏛️ **Selling to auction houses:** 541 houses with email, phone, address, SIREN, NAF code and how many sales they run.
- 🚚 **Shipping and services:** which houses ship, through whom, and when collections happen.
- 🤖 **AI agents:** compact rows with photos and bilingual descriptions.

### How much does it cost to scrape Interencheres?

Interencheres Scraper is priced per row: **$0.0009 per row** ($0.90 per 1,000 lots, sales or houses), with no start fee. The company register add-on and the window split are included.

| Rows | Price |
|---|---|
| 25 | $0.0225 |
| 100 | $0.09 |
| 1,000 | $0.90 |
| 10,000 | $9.00 |

Apify's free plan includes monthly credit. A search that matches nothing costs nothing.

### Integrations, API, scheduling and MCP

Run it on a [schedule](https://docs.apify.com/platform/schedules) (a daily monitor run is the usual setup), send results to Google Sheets, Slack, Make, Zapier or n8n with [integrations](https://docs.apify.com/platform/integrations), or trigger a webhook when a run finishes. Call it from code with the [Apify API](https://apify.com/scrapersdelight/interencheres-auction-scraper/api) - [Python](https://apify.com/scrapersdelight/interencheres-auction-scraper/api/python) or [JavaScript](https://apify.com/scrapersdelight/interencheres-auction-scraper/api/javascript) - or let an AI agent call it through the [Apify MCP server](https://apify.com/scrapersdelight/interencheres-auction-scraper/api/mcp). For one search per HTTP call, use the API's run-sync endpoint, which returns the rows in the response.

### More auction scrapers

- [Drouot Scraper](https://apify.com/scrapersdelight/drouot-lot-scraper) - lots, sales and house contacts from drouot.com.
- [Auctionet Scraper](https://apify.com/scrapersdelight/auctionet-lot-scraper) - European lots with hammer prices and house contacts.
- [Bidsquare Scraper](https://apify.com/scrapersdelight/bidsquare-lot-scraper) - US auction-house contacts and lots.
- [LiveAuctioneers Scraper](https://apify.com/scrapersdelight/liveauctioneers-scraper) - lots and prices realized.
- [Troostwijk Auction Scraper](https://apify.com/scrapersdelight/troostwijk-lot-scraper) - industrial lots, bids and closing times.
- [BidSpotter Auction Scraper](https://apify.com/scrapersdelight/bidspotter-auction-scraper) - industrial and machinery lots.

See [all our scrapers](https://apify.com/scrapersdelight).

### Limits and empty runs

- Lot-level hammer prices are the day's: once the sale day is over the site drops the sale's lots from its index and its pages answer 404. Ended sales stay available as sale rows with their results PDF.
- A sale venue the house keeps secret until a date has no street, city or GPS until then (`venueHiddenUntil`).
- A search bigger than 10,000 results is read in sale-date order. A single second holding more than 20,000 results could not be read in full (`RUN_SUMMARY` says so; not seen in practice).
- `RUN_SUMMARY` gives, per search: the site's own total, records read and delivered, date windows used, filtered and already-seen records, links not found, and why the search stopped. A search that reads fewer records than the site counts is marked `short read`.
- An empty run (no match, a link not found, a filter the site refuses) ends with nothing charged and says why in the status message.

### ❓ FAQ

#### How much does Interencheres Scraper cost?

$0.0009 per row with no start fee: 1,000 lots cost $0.90.

#### How many lots can Interencheres Scraper get?

Every lot that matches. There were 167,786 upcoming lots on 2026-10-14. The site answers 10,000 per search, so bigger searches are split by sale date: 10,523 of 10,523 lots in a 2-category test, read in 49 seconds.

#### Does Interencheres Scraper return hammer prices?

Yes, for lots hammered on the day you run it (Results mode): `sold`, `hammerPrice`, `hammerType`. Schedule it in the evening with monitor mode to keep every day's results. For older sales you get the results PDF on the sale row.

#### Does Interencheres Scraper give auction-house contacts?

Yes: name, email, phone, street address, GPS, agrément, VAT number and SIREN on every lot and sale row, and as a directory in Auction houses mode (541 houses: 466 in France, 23 in Belgium, 11 in Switzerland, 11 in Italy, 7 in Monaco, and more).

#### Can I paste an Interencheres search link into Interencheres Scraper?

Yes. Paste it into `startUrls`; the search term, categories, auction types, estimates, region, sort and page are applied. Sale, lot, category and auction-house links work too.

#### Can Interencheres Scraper alert me to new lots?

Yes. Turn on `monitorMode` and schedule the run. Each run delivers only lots it has not delivered before; a run with nothing new reads one small page and charges nothing.

#### Does Interencheres Scraper need a login, cookies or an API key?

No. It reads the same public search data a visitor sees on interencheres.com.

#### Can I use Interencheres Scraper with the Apify API or MCP?

Yes: start runs and fetch results with the [Apify API](https://apify.com/scrapersdelight/interencheres-auction-scraper/api) from any language, or connect it to Claude, ChatGPT or other agents through the [Apify MCP server](https://apify.com/scrapersdelight/interencheres-auction-scraper/api/mcp). `compact` keeps rows small for agents.

#### Why did Interencheres Scraper return no results?

The search matched nothing (check the same filters on interencheres.com), a link was not found (an ended sale leaves the index), the site refused a filter (the status message names it), or in monitor mode nothing was new. Nothing is charged in any of these cases.

#### Your feedback

Found a bug or need a field or filter? Open an issue on the [Issues tab](https://apify.com/scrapersdelight/interencheres-auction-scraper/issues/open) and we will look at it.

# Actor input Schema

## `mode` (type: `string`):

Lots = upcoming lots of the site's lot search. Results = lots already under the hammer, with the hammer price (the site keeps a sale's lots until the end of its sale day). Sales = the sales calendar. Auction houses = the directory of houses.

## `searchQueries` (type: `array`):

The site's own full-text search, one search per term, e.g. "montre", "Rolex", "Peugeot 205", "tableau". Empty = no text filter.

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

Links copied from interencheres.com: a search (/recherche/lots?..., /recherche/ventes?..., filters and page kept), a category (/vehicules/...), a sale, a lot, an auction house (/commissaire-priseur/...) or /resultats-ventes. A link brings its own filters: the form filters below do not apply to it.

## `saleIds` (type: `array`):

Numeric sale ids (the number at the end of a sale link, e.g. 690874). Lots / Results modes: every lot of the sale. Sales mode: the sale row.

## `houseIds` (type: `array`):

Numeric auction-house ids (the number at the end of a /commissaire-priseur/ link, e.g. 34). Lots, Results and Sales modes: only that house's lots or sales. Auction houses mode: those houses.

## `pastSales` (type: `boolean`):

Sales mode only: read the site's archive of ended sales (24,000+ since 2007) with each sale's results PDF, instead of the upcoming calendar.

## `categories` (type: `array`):

The site's own category tree (3 universes, 153 categories). A parent category includes everything under it.

## `regions` (type: `array`):

Where the sale takes place: the site's 19 regions and 96 departments. Not available for past sales.

## `country` (type: `string`):

Country of the sale (houses: of the house). Not available for past sales.

## `latitude` (type: `number`):

Radius search: latitude of the centre, e.g. 45.76 (Lyon). Use with longitude and radius.

## `longitude` (type: `number`):

Radius search: longitude of the centre, e.g. 4.84 (Lyon).

## `radiusKm` (type: `integer`):

Radius search: distance from the centre in km. Default 50.

## `saleDateFrom` (type: `string`):

Only sales on or after this day (YYYY-MM-DD). Not available for auction houses.

## `saleDateTo` (type: `string`):

Only sales on or before this day (YYYY-MM-DD).

## `saleWithinDays` (type: `integer`):

Only sales from now to N days ahead, e.g. 7. Moves with every run, so it suits a schedule. Ignored when both dates are set.

## `minEstimate` (type: `integer`):

Lots and Results: lots whose estimate reaches at least this, e.g. 500 (the site matches on the estimate range).

## `maxEstimate` (type: `integer`):

Lots and Results: lots whose estimate starts at or below this, e.g. 5000.

## `auctionTypes` (type: `array`):

Live = sale room with live online bidding; Online = timed online sale; Classic = sale room only (absentee bids). Empty = all.

## `saleNature` (type: `string`):

Voluntary sales (goods entrusted by their owners) or judicial sales (court-ordered, e.g. liquidations).

## `premiumOnly` (type: `boolean`):

Only lots or sales in the site's Premium selection.

## `deliveryAvailable` (type: `boolean`):

Only lots or sales the house can ship.

## `refundableVatOnly` (type: `boolean`):

Lots and Results: only lots with recoverable VAT (typical of business equipment and vehicles).

## `keywordInDescription` (type: `string`):

Lots and Results: the site's "keyword or lot no." box, matched in the description or the lot number, e.g. "rolex" or "125".

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

Order of the rows. Relevance needs a search term. A search bigger than the site's 10,000-result window is read in sale-date order.

## `filters` (type: `object`):

Any other filter of the site's search service, by its own name, e.g. {"fuel_type": "diesel", "mileage_range": "0,80000", "first_registration_date_range": "2018,2024", "transmission": "automatic", "organization": "34"}. Overrides the form.

## `excludeKeywords` (type: `array`):

Drop rows whose title or description contains any of these words, e.g. "lot de", "copie". Not case-sensitive.

## `onlyWithImages` (type: `boolean`):

Drop lots without a photo (9% of lots have none).

## `onlySold` (type: `boolean`):

Results mode: drop hammered lots that did not sell (about half of them on a measured day).

## `includeCompanyRegistry` (type: `boolean`):

Adds the French company register's record for the SIREN in the house's own VAT number: registered name, NAF code, company size, active/closed. No extra charge.

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

Deliver only lots, sales or houses not delivered by an earlier run of the same search. Pairs with a daily schedule: Results + monitor collects every hammer price once.

## `monitorKey` (type: `string`):

Optional name for the monitor memory, e.g. "rolex-alert". Empty = derived from the search, so changing the search starts a fresh memory.

## `publishedSince` (type: `string`):

Lots: only lots published after this point - a date (2026-10-01) or a duration ("24 hours", "7 days"). Reads newest first and stops at the cutoff.

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

Most rows delivered (and charged) in this run. 0 = no cap: every lot of a search, also past the site's 10,000-result window (171,000+ upcoming lots in total).

## `maxItemsPerSearch` (type: `integer`):

Most rows from each search term, link or id. 0 = no per-search cap.

## `compact` (type: `boolean`):

Core fields only (id, link, title, estimates, hammer price, sale, city, house and its contacts) - smaller rows for AI agents and spreadsheets.

## `includeRawData` (type: `boolean`):

Adds the site's own record, untouched, as "raw" (every field the site sends).

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters (0 = full text; the longest measured was 3,820).

## `maxConcurrency` (type: `integer`):

Search pages read at the same time (1-5). Each page is up to 200 records.

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

Leave as is: the actor goes direct and switches to a French residential proxy on its own when the site refuses a request (paid proxy use is capped per run). Your own proxy URLs or Apify group replace that fallback.

## Actor input object example

```json
{
  "mode": "lots",
  "searchQueries": [
    "montre"
  ],
  "pastSales": false,
  "country": "any",
  "saleNature": "any",
  "premiumOnly": false,
  "deliveryAvailable": false,
  "refundableVatOnly": false,
  "sort": "default",
  "onlyWithImages": false,
  "onlySold": false,
  "includeCompanyRegistry": false,
  "monitorMode": false,
  "maxItems": 25,
  "maxItemsPerSearch": 0,
  "compact": false,
  "includeRawData": false,
  "descriptionMaxLength": 0,
  "maxConcurrency": 3,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

One item per lot, sale or auction house, depending on the mode.

## `summary` (type: `string`):

Per-search site totals, records read and delivered, date windows, filtered and already-seen records, links not found and transport stats.

# 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 = {
    "mode": "lots",
    "searchQueries": [
        "montre"
    ],
    "maxItems": 25
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/interencheres-auction-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 = {
    "mode": "lots",
    "searchQueries": ["montre"],
    "maxItems": 25,
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/interencheres-auction-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 '{
  "mode": "lots",
  "searchQueries": [
    "montre"
  ],
  "maxItems": 25
}' |
apify call scrapersdelight/interencheres-auction-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/interencheres-auction-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/XpKKxCjJZcKIeS8g3/builds/vw6aKGWi0FMWlBc4U/openapi.json
