# DoneDeal Scraper - Cars & Classified Ads (`trev0n/donedeal-scraper`) Actor

Extract car and classified ads from DoneDeal.ie - prices, specs, mileage, seller details, photos and more. Fast, browser-free scraping with flexible filters.

- **URL**: https://apify.com/trev0n/donedeal-scraper.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

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

## 🚗 DoneDeal Scraper — Ireland's #1 Marketplace, Fully Extracted

🎯 **Pull every ad from DoneDeal.ie into a clean spreadsheet — cars, vans, tractors, property, livestock and everything else Ireland buys and sells.**

This scraper collects the full picture of each ad: asking price and finance estimate, year, mileage, make, model and trim, full spec sheet, county and town, GPS coordinates, dealer name and rating, trust badges, view count, the complete photo gallery and the seller's own description. Cover all 53 sections of the marketplace or zoom in on a single county.

***

### 🚀 What Does It Do?

This scraper automatically walks through DoneDeal's search results and collects **structured, ready-to-use data** on every ad it finds. No manual browsing, no copy-paste — set your filters and hit Start.

💡 **Two modes of operation:**

1. **🔍 Discovery Mode** — Choose a section (Cars, Tractors, Property, Livestock…), add filters like county, price, year, mileage or fuel type, and it pages through every matching ad.
2. **📋 Direct URL Mode** — Already have a DoneDeal search you like, or a handful of specific ads? Paste the links and it picks up exactly what you pointed it at, filters included.

🔁 **Plus a third way to use it:** switch on **Incremental Monitoring** and scheduled runs return *only* what changed — brand-new ads, price drops, and relisted items — cutting the cost of daily tracking by 80-95%.

***

### 👥 Who Is This For?

| 🏢 Use Case | 💬 How It Helps |
| --- | --- |
| 🚗 **Car dealers** | Watch what every rival forecourt is asking for the same make, model and year — and get alerted the moment they cut a price |
| 📊 **Market analysts** | Build real pricing curves for the Irish market by age, mileage, fuel type and county instead of guessing |
| 🔎 **Car flippers & traders** | Catch underpriced private ads within minutes of them going live, filtered to your budget and area |
| 🚜 **Farm machinery buyers** | Track tractors, balers and plant across all 32 counties in one sheet instead of ten browser tabs |
| 🏠 **Property researchers** | Monitor asking prices and time-on-market for Irish property and land listings |
| 🤝 **Lead generation teams** | Build targeted lists of dealers or private sellers by county, complete with trading names and ratings |
| 📱 **App & price-comparison builders** | Feed a live Irish classifieds dataset straight into your own product |

***

### ✨ Features

- 🗂️ **All 53 sections** — Cars, Commercials, Vintage, Motorbikes, Campers, Tractors, Livestock, Property, Electronics, Fashion and everything between
- 🇮🇪 **Every county** — Filter to any of the 32 Irish counties, Northern Ireland included, or search a town plus a radius
- 💰 **Real pricing intelligence** — Asking price, monthly finance estimate, and DoneDeal's own price rating for the ad
- 📉 **Mileage benchmarking** — See whether an ad sits above or below the median mileage for that exact make, model and year
- 🔧 **Full spec sheets** — Make, model, trim, engine, transmission, body type, colour, doors, owners, NCT status and the grouped feature list
- 📸 **Complete photo galleries** — Every image on the ad, not just the thumbnail
- 🏅 **Trust signals** — Dealer ratings, Trusted Dealer and Greenlight verification badges, warranty offers and view counts
- 📍 **Exact locations** — County, town and GPS coordinates for mapping
- 🔁 **Incremental Monitoring** — Scheduled runs return only new, changed and relisted ads
- 🔔 **Instant alerts** — Push new finds straight to Telegram, Slack, Discord or your own webhook
- 🎛️ **Smart Filters** — Keywords, make/model, price, year, mileage, fuel, transmission, body type, colour, dealer vs private, Trusted Dealers only, wanted ads, plus keyword include/exclude and a freshness cutoff
- ⚡ **Fast & Scalable** — Around 30 ads per request with no browser overhead; comfortably handles tens of thousands of ads per run
- 🧹 **Automatic deduplication** — Every ad appears once, even when it repeats across pages
- 📤 **Export Anywhere** — Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

***

### 🎛️ Filters & Options

| Option | What It Does |
| --- | --- |
| 🗂️ **Section** | Pick any of the 53 marketplace sections, or search everything at once |
| 🔤 **Keywords** | Free-text search, e.g. "golf gti" or "john deere" |
| 🚗 **Make & Model** | Narrow to a specific make, and optionally a model |
| 🇮🇪 **County** | Restrict to one Irish county, or leave open for all of Ireland |
| 📍 **Town & Radius** | Search around a town, from 5 km up to 500 km |
| 💰 **Min / Max Price** | Only ads inside your budget |
| 📅 **Min / Max Year** | Filter by model year |
| 🛣️ **Max Mileage** | Skip anything over your mileage ceiling |
| ⛽ **Fuel Type** | Petrol, diesel, electric, and every hybrid variant — pick several at once |
| ⚙️ **Transmission** | Manual, automatic, or both |
| 🚙 **Body Type** | SUV, hatchback, saloon, estate, van and more |
| 🎨 **Colour** | Filter by one or several colours |
| 🏢 **Seller Type** | Dealers only, private sellers only, or both |
| 🏅 **Trusted Dealers Only** | Restrict to dealers carrying DoneDeal's Trusted Dealer badge |
| 🙋 **Ad Type** | Items for sale, or "wanted" ads from buyers |
| ↕️ **Sort By** | Newest, oldest, cheapest, dearest, lowest/highest mileage, or best seller rating |
| 📝 **Fetch Full Ad Details** | Add the full description, all photos, complete specs, GPS and view count |
| ✅ **Must / Must Not Contain** | Keep or drop ads by keyword |
| ⏱️ **Only Ads Newer Than** | Ignore anything older than X minutes |
| 🔁 **Incremental Monitoring** | Return only what changed since the last run |
| 🔔 **Alerts** | Telegram, Slack, Discord or webhook notifications |
| 🔢 **Max Ads / Max Pages** | Control how many ads to extract per run |
| 🔗 **Direct URLs** | Optionally provide specific DoneDeal search or ad links to scrape |

***

### 📦 What You Get (Output Fields)

Every ad includes:

#### 🏷️ Ad Identity

| Field | Example |
| --- | --- |
| adId | `41923834` |
| title | `Citroen C3 FLAIR PURETECH 82 SS EU6.3 4DR` |
| url | `https://www.donedeal.ie/cars-for-sale/citroen-c3-flair-puretech-82-ss-eu6-3-4dr/41923834` |
| section | `cars` |
| sectionName | `Cars` |
| postedAt | `2026-08-02T09:24:00.190Z` |
| firstPublishedAt | `2026-04-13T09:00:29.266Z` |
| updatedAt | `2026-07-11T08:27:04.120Z` |
| age | `0 min` |
| views | `1` |

#### 💰 Pricing

| Field | Example |
| --- | --- |
| price | `17995` |
| priceDisplay | `€17,995` |
| priceCurrency | `EUR` |
| priceOnRequest | `false` |
| financePerMonth | `From €291/mo` |
| priceIndicator | `Great price` |

#### 🔧 Vehicle Details

| Field | Example |
| --- | --- |
| year | `2022` |
| mileageKm | `48352` |
| mileageIndicator | `Below` |
| medianMileage | `68,100 km` |
| metaInfo | `["2022", "1.2 Petrol", "48,352 km"]` |
| attributes | `{ "make": "Citroen", "model": "C3", "trim": "Flair", "fuelType": "Petrol", "transmission": "Manual" }` |
| features | `{ "Media & connectivity": ["Android Auto", "Apple CarPlay"] }` |

#### 📍 Location

| Field | Example |
| --- | --- |
| county | `Offaly` |
| countyTown | `Cloghan` |
| latitude | `53.22456107` |
| longitude | `-7.883257583` |

#### 🏢 Seller

| Field | Example |
| --- | --- |
| sellerType | `PRO` |
| sellerName | `hugo` |
| dealerName | `Hugo Loonam Motors` |
| dealerId | `849` |
| dealerRating | `4.8` |
| dealerTrusted | `true` |
| traderAddress | `Ferbane street, Cloghan, Offaly, Ireland` |
| greenlightVerified | `true` |
| tags | `["FREE History Report", "Greenlight", "2 year warranty"]` |

#### 📸 Content & Media

| Field | Example |
| --- | --- |
| description | `Contact Kevin or Sean at Hugo Loonam Motors for more information. Central Locking, Electric Windows…` |
| descriptionLength | `470` |
| imageUrl | `https://media.donedeal.ie/eyJidWNrZXQiOiJkb25lZGVhbC5pZS1waG90b3Mi…` |
| imageUrls | `["https://media.donedeal.ie/…", "https://media.donedeal.ie/…"]` |
| imageCount | `22` |
| youTubeVideoId | `58ewyyfteS8` |

#### 🔁 Monitoring (when Incremental Monitoring is on)

| Field | Example |
| --- | --- |
| changeType | `NEW` |
| firstSeenAt | `2026-08-01T06:00:00.000Z` |
| lastSeenAt | `2026-08-02T06:00:00.000Z` |
| isRepost | `false` |
| repostOfId | `null` |

***

### 📊 Example Output

```json
{
    "adId": "41923834",
    "title": "Citroen C3 FLAIR PURETECH 82 SS EU6.3 4DR",
    "url": "https://www.donedeal.ie/cars-for-sale/citroen-c3-flair-puretech-82-ss-eu6-3-4dr/41923834",
    "section": "cars",
    "sectionName": "Cars",
    "price": 17995,
    "priceDisplay": "€17,995",
    "priceCurrency": "EUR",
    "priceOnRequest": false,
    "financePerMonth": "From €291/mo",
    "priceIndicator": "Great price",
    "county": "Offaly",
    "countyTown": "Cloghan",
    "latitude": 53.22456107,
    "longitude": -7.883257583,
    "year": 2022,
    "mileageKm": 48352,
    "mileageIndicator": "Below",
    "medianMileage": "68,100 km",
    "metaInfo": ["2022", "1.2 Petrol", "48,352 km"],
    "attributes": {
        "make": "Citroen",
        "model": "C3",
        "trim": "Flair",
        "year": "2022",
        "mileage": "48,352 km",
        "fuelType": "Petrol",
        "transmission": "Manual",
        "bodyType": "Hatchback"
    },
    "features": {
        "Comfort & convenience": ["Climate control", "Rain sensor"],
        "Media & connectivity": ["Android Auto", "Apple CarPlay", "Touch screen display"]
    },
    "sellerType": "PRO",
    "sellerName": "hugo",
    "dealerId": 849,
    "dealerName": "Hugo Loonam Motors",
    "dealerTrusted": true,
    "traderAddress": "Ferbane street, Cloghan, Offaly, Ireland",
    "greenlightVerified": true,
    "tags": ["FREE History Report", "Greenlight", "2 year warranty"],
    "views": 1,
    "description": "Contact Kevin or Sean at Hugo Loonam Motors for more information. Central Locking, Electric Windows, Airbag, Fog Lamps, Multi-function steering wheel, Traction Control, Parking Sensors, Bluetooth.",
    "descriptionLength": 470,
    "imageUrl": "https://media.donedeal.ie/eyJidWNrZXQiOiJkb25lZGVhbC5pZS1waG90b3MiLCJlZGl0cyI6e30sImtleSI6InBob3RvXzM4NzQ4MTgwMyJ9",
    "imageCount": 22,
    "youTubeVideoId": "58ewyyfteS8",
    "postedAt": "2026-08-02T09:24:00.190Z",
    "firstPublishedAt": "2026-04-13T09:00:29.266Z",
    "updatedAt": "2026-07-11T08:27:04.120Z",
    "deliveryAvailable": true,
    "scrapedAt": "2026-08-02T10:15:32.000Z"
}
```

***

### 📋 Dataset Views

The Apify Console gives you **3 ready-made table views** to quickly browse your results:

| View | What It Shows |
| --- | --- |
| 📊 **Overview** | Title, price, year, mileage, county, seller and the ad link — the quick scan |
| 🔁 **Changes** | What changed since your last run: new, updated, relisted, with first/last seen dates |
| 📋 **Detailed** | Every single field — full specs, features, seller details, photos and coordinates |

***

### ❓ FAQ

**🤔 Which parts of DoneDeal can it scrape?**
All 53 sections — the full motor range (cars, commercials, campers, motorbikes, trailers, plant), all of farming (tractors, livestock, machinery, feed), property, and the general marketplace (electronics, fashion, baby & kids, sport, business and more).

**🤔 Can I track price drops on specific cars?**
Yes — that's what Incremental Monitoring is for. Schedule a daily run and you'll get only the ads that are new, that changed price, or that came back on the market, tagged so you can tell which is which.

**🤔 How many ads can I get in one run?**
As many as the search holds — Cars alone carries over 100,000 live ads. Set Max Ads to cap it, or leave it at 0 for everything.

**🤔 Do I get the full description and all the photos?**
Turn on **Fetch Full Ad Details** and yes — the seller's complete description, the entire photo gallery, the full spec sheet, GPS coordinates and the view count.

**🤔 Does it cover Northern Ireland?**
Yes — all 32 counties, including Antrim, Armagh, Derry, Down, Fermanagh and Tyrone.

**🤔 Can I export the data?**
Yes — JSON, CSV, Excel, XML, HTML, RSS. You can also push data directly to Google Sheets, Zapier, Make, or any webhook/API endpoint.

**🤔 How often should I run this?**
For fresh data, run daily or weekly. You can schedule automatic runs on Apify with just a few clicks.

**🤔 Does it work with proxies?**
Yes — Irish residential proxies are required for this site and are already selected by default. Just leave the proxy setting as it is.

***

### 🛠️ Need Custom Filters or Features?

**I'm happy to customize this scraper for your specific needs!** 🤝

Whether you need:

- 🎯 Additional filters (specific trim levels, NCT expiry windows, number of owners, import status, engine size or battery range)
- 📊 Extra data fields or custom output formats
- 🔄 Integration with your CRM, Google Sheets, or database
- ⏰ Scheduled scraping with automatic deduplication
- 🌐 Scraping from other Irish or European classifieds platforms alongside DoneDeal

👉 **Don't hesitate to reach out via private message** — I respond quickly and I'm always open to building exactly what you need. No request is too small or too specific!

***

### ⚖️ Legal & Ethical Use

This scraper collects **only publicly available information** from DoneDeal.ie. It does not access private data, log into accounts, bypass authentication, or reveal seller phone numbers hidden behind DoneDeal's contact forms. Please use the data responsibly and in compliance with applicable laws and platform terms of service.

# Actor input Schema

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

Paste any DoneDeal search, section or single-ad page. Filters already in the URL are kept, and paging continues from where the link points. Leave empty to build a search with the fields below instead.

## `section` (type: `string`):

Which part of the marketplace to search. "All Sections" covers everything at once.

## `words` (type: `string`):

Free-text search, e.g. "golf gti" or "john deere". Leave empty to get everything in the section.

## `make` (type: `string`):

Vehicle make, exactly as DoneDeal spells it — e.g. Volkswagen, Land Rover, John Deere.

## `model` (type: `string`):

Vehicle model, e.g. Golf, Passat. Needs a Make to be set as well.

## `area` (type: `string`):

Restrict to one Irish county (Northern Irish counties included). Leave empty for all of Ireland.

## `town` (type: `string`):

Narrow to a town. Combine with Radius to search the surrounding area.

## `radius` (type: `string`):

How far around the town to search. Only applies when a Town is set.

## `priceMin` (type: `integer`):

Cheapest price to include. 0 = no minimum.

## `priceMax` (type: `integer`):

Dearest price to include. 0 = no maximum.

## `yearMin` (type: `integer`):

Oldest model year to include. 0 = any.

## `yearMax` (type: `integer`):

Newest model year to include. 0 = any.

## `mileageMax` (type: `integer`):

Highest mileage to include. 0 = any.

## `fuelType` (type: `array`):

Pick one or more. Leave empty for all fuel types.

## `transmission` (type: `array`):

Manual, automatic, or both.

## `bodyType` (type: `array`):

Pick one or more body styles.

## `colour` (type: `array`):

Pick one or more colours.

## `sellerType` (type: `string`):

Dealer ads, private ads, or both.

## `trustedDealerOnly` (type: `boolean`):

Only ads from dealers carrying DoneDeal’s Trusted Dealer badge.

## `adType` (type: `string`):

Items for sale, or "wanted" ads from buyers looking for something.

## `sortBy` (type: `string`):

Result order. "Newest" is best for monitoring so fresh ads come first.

## `maxResults` (type: `integer`):

Stop after this many ads. 0 = no limit (careful: some sections hold 100,000+ ads).

## `maxPages` (type: `integer`):

Stop after this many result pages (30 ads each). 0 = no limit.

## `includeDetails` (type: `boolean`):

Open every ad to add the full description, all photos, the complete spec list, GPS coordinates and view count. Slower and costs one extra request per ad.

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

Cut long descriptions to this many characters. 0 = keep the full text.

## `includeKeywords` (type: `array`):

Keep only ads mentioning at least one of these words.

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

Drop ads mentioning any of these words.

## `maxAgeMinutes` (type: `integer`):

Drop anything published longer ago than this. 0 = no age limit.

## `incrementalMode` (type: `boolean`):

Remember what was seen on previous runs and return only new, changed and relisted ads. Cuts the cost of a scheduled run by 80-95%.

## `stateKey` (type: `string`):

Name for this monitor’s memory. Use different names for different searches. Auto-generated from your filters if left empty.

## `emitUnchanged` (type: `boolean`):

Return every ad every run, not just the changes. Turns off most of the savings.

## `emitExpired` (type: `boolean`):

Add a row for ads that disappeared since the last run (usually sold).

## `skipReposts` (type: `boolean`):

Hide ads that are a re-listing of something already seen under a different ad number.

## `webhookUrl` (type: `string`):

Send the results to this URL as JSON when changes are found.

## `telegramBotToken` (type: `string`):

Token from @BotFather to get alerts in Telegram.

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

Which Telegram chat to send alerts to.

## `discordWebhookUrl` (type: `string`):

Post alerts into a Discord channel.

## `slackWebhookUrl` (type: `string`):

Post alerts into a Slack channel.

## `notifyOnlyChanges` (type: `boolean`):

Stay quiet on runs that found nothing new.

## `notificationLimit` (type: `integer`):

How many ads to list in a single alert message.

## `includeRunSummary` (type: `boolean`):

Add the run's totals (new / updated / removed counts) to each alert message.

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

Return only the key fields per ad instead of the full record.

## `excludeEmptyFields` (type: `boolean`):

Leave out fields that have no value.

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

How many result pages to load at once. Keep this low — DoneDeal throttles bursts.

## `detailConcurrency` (type: `integer`):

How many ad pages to open at once when full details are on.

## `useDataRoute` (type: `boolean`):

Fetch result pages and ad details through DoneDeal's compact data feed: result pages are about 40% smaller and ad details about 60% smaller. When the feed misses, that page loads normally with no loss of data. Turn off only to force normal pages.

## `useProxyForDetails` (type: `boolean`):

Route ad-detail requests through the proxy too.

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

Leave this as it is. DoneDeal blocks datacenter traffic outright, so Irish residential proxies are required — with anything else the run returns nothing.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.donedeal.ie/cars?area=Dublin&price_from=5000&price_to=15000"
    }
  ],
  "section": "cars",
  "area": "",
  "radius": "",
  "priceMin": 0,
  "priceMax": 0,
  "yearMin": 0,
  "yearMax": 0,
  "mileageMax": 0,
  "fuelType": [],
  "transmission": [],
  "bodyType": [],
  "colour": [],
  "sellerType": "",
  "trustedDealerOnly": false,
  "adType": "",
  "sortBy": "newest",
  "maxResults": 100,
  "maxPages": 0,
  "includeDetails": false,
  "descriptionMaxLength": 0,
  "includeKeywords": [],
  "excludeKeywords": [],
  "maxAgeMinutes": 0,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "skipReposts": false,
  "notifyOnlyChanges": true,
  "notificationLimit": 10,
  "includeRunSummary": true,
  "compact": false,
  "excludeEmptyFields": false,
  "maxConcurrency": 3,
  "detailConcurrency": 5,
  "useDataRoute": true,
  "useProxyForDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "IE"
  }
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detailed` (type: `string`):

No description

## `monitoring` (type: `string`):

No description

## `runSummary` (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 = {
    "startUrls": [
        {
            "url": "https://www.donedeal.ie/cars?area=Dublin&price_from=5000&price_to=15000"
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/donedeal-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.donedeal.ie/cars?area=Dublin&price_from=5000&price_to=15000" }] }

# Run the Actor and wait for it to finish
run = client.actor("trev0n/donedeal-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.donedeal.ie/cars?area=Dublin&price_from=5000&price_to=15000"
    }
  ]
}' |
apify call trev0n/donedeal-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/donedeal-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/Nm7Gw0hN0dJaICrOc/builds/M4dftWeaFFgOtCofa/openapi.json
