# Fast Autotrader Uk Scraper - Compact Outputs (`blueorion/fast-autotrader-uk-scraper`) Actor

Optimized for speed and low cost, capturing only essential, high-value fields such as title, price, mileage, year, location, seller info, and images. Extract from Autotrader UK search result pages and individual vehicle pages.

- **URL**: https://apify.com/blueorion/fast-autotrader-uk-scraper.md
- **Developed by:** [Blue Orion](https://apify.com/blueorion) (community)
- **Categories:** Automation, Agents, E-commerce
- **Stats:** 35 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: 4.85 out of 5 stars

## Pricing

$0.69 / 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

## Fast Autotrader UK Scraper - Low cost per result

Autotrader UK Scraper — Fast, lightweight Apify actor for extracting vehicle listings and details from https://www.autotrader.co.uk

Supports both search result URLs and individual vehicle pages. Optimized for speed and low cost, capturing only essential, high-value fields such as title, price, mileage, year, location, seller info, and images.

Features configurable maxItems limit per URL and mode (aggressive or slow) for performance tuning. Outputs clean, structured JSON for easy integration into analytics, inventory systems, market research or price monitoring workflows.

#### 🔗 Try the Actor on Apify

**Deploy it instantly on Apify →**\
👉 [Fast Autotrader UK Scraper](https://apify.com/blueorion/fast-autotrader-uk-scraper)

### 🚀 What This Actor Can Do

✅ Scrapes Autotrader UK search result pages and individual vehicle pages.

✅ Outputs two main record types:

- **FEATURED_LISTING** — compact listing data (for search URL inputs).

- **VEHICLE_DETAIL** — full detail extraction (for individual vehicle URL inputs).

✅ Minimises browser usage where possible (uses lightweight page interactions or HTML parsing), supports two modes: aggressive and slow.

### 🧾 Input Options

| Field            | Description                                                                                                                                                              |
| ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **`startUrls`**  | Any Autotrader URLs to scrape from                                                                                                                                       |
| **`maxItems`**   | Maximum number of items to scrape per input *(10–10,000, default: 100)*                                                                                                  |
| **`mode`**       | Select crawl behavior: <br>• `aggressive` – faster, but proxy recommended <br>• `slow` – human-like browsing                                                             |
| **`searchType`** | *(Optional)* Vehicle category to search for. Options: `Cars`, `Vans`, `Bikes`, `Motorhomes`, `Caravans`, `Trucks`, `Farm Machinery`, `Plant Machinery`, `Electric Bikes` |
| **`postCode`**   | *(Optional)* UK postcode to filter results by location (e.g., `NG1 1GF`)                                                                                                 |
| **`make`**       | *(Optional)* Vehicle manufacturer (e.g., `Aston Martin`)                                                                                                                 |
| **`model`**      | *(Optional)* Vehicle model (e.g., `DB12`)                                                                                                                                |
| **`yearFrom`**   | *(Optional)* Minimum vehicle registration year (e.g., `2020`)                                                                                                            |
| **`yearTo`**     | *(Optional)* Maximum vehicle registration year (e.g., `2025`)                                                                                                            |

#### How to Create a Custom Search URL on Autotrader.co.uk

The search URL on Autotrader consists of several components. By combining them, you can create a custom URL to perform specific searches on the Autotrader website. This custom URL can then be used as input for this Apify actor.

- **Base URL:**

```
https://www.autotrader.co.uk/
```

- **Search Type:**

Choose the appropriate search type depending on the vehicle category you’re interested in:

| Field         | Description |
|---------------|-------------|
| `car-search?`  | Search for Cars |
| `van-search?`  | Search for Vans |
| `bike-search?`  | Search for Bikes |
| `motorhome-search?`  | Search for Motorhomes |
| `caravan-search?`  | Search for Caravans |
| `truck-search?`  | Search for Trucks |
| `farm-search?`  | Search for Farm Machinery |
| `plant-search?`  | Search for Plant Machinery |
| `electric-bike-search?`  | Search for Electric Bikes |

- **Search Parameters (Keywords):**

You can refine your search using query parameters (keywords). Below are some common examples:

| Parameter   | Example              | Description                                        |
| ----------- | -------------------- | -------------------------------------------------- |
| `postcode`  | `&postcode=NG1+1NG`  | *(Optional)* Filter results by a specific postcode |
| `make`      | `&make=Aston+Martin` | *(Optional)* Filter by vehicle manufacturer        |
| `model`     | `&model=DB12`        | *(Optional)* Filter by vehicle model               |
| `year-from` | `&year-from=2024`    | *(Optional)* Set the minimum registration year     |
| `year-to`   | `&year-to=2025`      | *(Optional)* Set the maximum registration year     |

These are the most common parameters, but Autotrader supports many additional options.
For more advanced filters, you can explore the full search query options directly on autotrader.co.uk

#### 🔍 Examples of search URL:

```
https://www.autotrader.co.uk/van-search?postcode=NG1+1NG
```

```
https://www.autotrader.co.uk/car-search?postcode=M60+1NW&advertising-location=at_cars&year-to=2025
```

```
https://www.autotrader.co.uk/bike-search?channel=bikes&make=BMW&min-engine-power=100&postcode=N5%201BU&sort=relevance
```

![Autotrader UK Scraper - compact listing data](https://i.ibb.co/mVhsvdqH/feature-listing.png)

#### 🚗 Examples of vehicle detail:

```
https://www.autotrader.co.uk/car-details/202509046056352
```

```
https://www.autotrader.co.uk/bike-details/202509156350043
```

```
https://www.autotrader.co.uk/truck-details/202407111673555
```

![Autotrader UK Scraper - vehicle details](https://i.ibb.co/27g1GjSN/vehicle-details.png)

#### ⚙️ Scraping Mode:

- **Aggressive Mode (default)**: faster, higher concurrency; may increase block risk.

- **Slow Mode**: emulate human scrolling/clicks, longer delays, lower concurrency; more resilient.

### 🧾 Output Examples

#### FEATURED LISTING DATA

```json
{
    "type": "FEATURED_LISTING",
    "id": "202502068817072",
    "title": "Vauxhall Grandland X",
    "subTitle": "1.2 Turbo Elite Nav Euro 6 (s/s) 5dr",
    "attentionGrabber": "PAN ROOF - CARPLAY - LED",
    "price": "£11,558",
    "location": null,
    "discount": null,
    "description": null,
    "images": [
        "https://m.atcdn.co.uk/a/media/{resize}/bc1c23bcd58447b685723c0595fff6b5.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/da1199a1f32341fa904643a900a78ab3.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/979b0af3e2b144a28fbc6ae24eff1292.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/cd25c5b1367348ccb25ed60e8d419dfe.jpg"
    ],
    "priceIndicatorRating": "LOW",
    "rrp": null,
    "manufacturerApproved": false,
    "sellerName": "Carsa",
    "sellerType": "TRADE",
    "dealerLink": "https://www.autotrader.co.uk/dealers/carsa-10043752?channel=cars",
    "dealerReview": {
        "overallReviewRating": 1,
        "numberOfReviews": 7
    },
    "itemLink": "https://www.autotrader.co.uk/car-details/202502068817072?journey=FEATURED_LISTING_JOURNEY&sort=relevance&searchId=85f727b5-3c1d-42bf-88ba-1278c65ab37c",
    "hasDigitalRetailing": false,
    "preReg": false,
    "finance": null,
    "badges": [
        {
            "type": "PI_LOW",
            "displayText": "Lower price"
        },
        {
            "type": "MILEAGE",
            "displayText": "24,372 miles"
        },
        {
            "type": "REGISTERED_YEAR",
            "displayText": "2019 (19 reg)"
        }
    ],
    "advertiserId": "10043752",
    "advertiserType": "TRADE",
    "isFranchiseApproved": false,
    "scrapedAt": "2025-10-10T09:10:16.020Z"
}
```

#### VEHICLE DETAIL DATA

```json
{
    "id": "202509246579398",
    "title": "Scania S580 V8",
    "subTitle": "6X2 TAG AXLE 16.4",
    "price": "£49,750 +VAT",
    "description": "2020 (69) Scania S580 V8 Highline. 6X2 Tag Axle, 2-Pedal Opticruise Gearbox, Fixed Fifth Wheel, 5-Stage Retarder, Alcoa Alloy Wheels, Rear-Mounted Batteries, Full Chassis In-Fills, Dutch Headboard, Marker Lights, Air Horns, Grill Spots, Deep Visor, Beacons, BackBar with LEDs & Work Lights, Corner Deflectors, Colour-Coded, Twin Bunk, Fridge, Infotainment Premium with SatNav, Leather Steering Wheel, 610K Miles. In Excellent Condition. Finance Available subject to status.",
    "attentionGrabber": "610K MILES | MANY EXTRAS",
    "sellerName": "A & M Commercials Ltd",
    "keySpecification": [
        {
            "label": "Mileage",
            "value": "983,168 kilometres",
            "specKey": "MILEAGE"
        },
        {
            "label": "Registration",
            "value": "2020 (69 reg)",
            "specKey": "REGISTRATION"
        },
        {
            "label": "Category",
            "value": "Tractor Units",
            "specKey": "CATEGORY"
        },
        {
            "label": "Axle config",
            "value": "6x2",
            "specKey": "AXLECONFIG"
        },
        {
            "label": "Gearbox",
            "value": "Automatic",
            "specKey": "GEARBOX"
        },
        {
            "label": "Cab type",
            "value": "High sleeper cab",
            "specKey": "CABTYPE"
        },
        {
            "label": "Engine power",
            "value": "580BHP",
            "specKey": "ENGINESIZEPOWER"
        },
        {
            "label": "Engine",
            "value": "16.4L",
            "specKey": "ENGINESIZELITRES"
        },
        {
            "label": "Emission class",
            "value": "Euro 6",
            "specKey": "EMISSIONCLASS"
        },
        {
            "label": "GVW",
            "value": "MTPLM: 44,000kg",
            "specKey": "GVW"
        }
    ],
    "images": [
        "https://m.atcdn.co.uk/a/media/{resize}/3f529c5adc574124ae6f696a0761374f.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/5dc54f095bf74d4daae95945915fb7da.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/692a163765b4440c9738b96694680261.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/66d3df193f544c979316f4e01ca4db5f.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/fcda22e0f4a749239f9cf7dd928e71fd.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/fb0e3474a6754bc5ac71b0f271902cda.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/e9aa096105204aee93b023a0258673a3.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/f1437feb8290453d904ff7a43cc00fa7.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/ab5f5185dace4d6b97ca252c7fc12254.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/59ab9a940fb24e46a30b2157d8d657bd.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/8ed63911e0f044c389040905ca792de8.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/b74a70bf72dc4a3f901e00be1fa74778.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/0d220e2834a54a4584efeb77e281c887.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/2167c31baf41437491ea39db2eba130a.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/9017c2700d644336a1fb5e3f98469b22.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/56875c74bc984b6db48568e4a8fa772f.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/6c4d5312c89e4ea499e918a8e57d6b8b.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/c1935381f94a4975853a1f3e9ee1dbfb.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/bd79c70ecb094c4c8b153611f5659368.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/847d1b61e59340059559d0eed7275ba1.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/96635b551feb4efdbf132f4e1d100852.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/b9506775b3d1477ab0ed306f2d8ea8bd.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/55cf1de5268941e8875d58812a7e69f7.jpg",
        "https://m.atcdn.co.uk/a/media/{resize}/fa252d8413454039a800464caf7f7033.jpg"
    ],
    "videos": [],
    "detailChecks": [
        {
            "id": "STOLEN",
            "label": "Not recorded as stolen",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "SCRAPPED",
            "label": "Not recorded as scrapped",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "IMPORTED",
            "label": "Not imported from another country",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "EXPORTED",
            "label": "Not exported out of the UK",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "WRITE_OFF",
            "label": "Never been written off",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "HIGH_RISK",
            "label": "No third party interest",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "MILEAGE_DISCREPANCY",
            "label": "No mileage issues",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "COLOUR_CHANGED",
            "label": "No colour changes",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "PRIVATE_FINANCE",
            "label": "No outstanding finance",
            "status": "PASSED",
            "failureNotificationStatus": null
        },
        {
            "id": "REGISTRATION_CHANGED",
            "label": "Recorded plate change",
            "status": "FAILED",
            "failureNotificationStatus": "INFORMATION"
        }
    ],
    "contactDetails": {
        "email": "michael@amcommercials.com",
        "phoneNumberOne": "+44 28 3711 0932",
        "phoneNumberTwo": "+44 1925 697677",
        "website": "http://www.amcommercials.com",
        "advertiserId": "284099",
        "advertiserName": "A & M Commercials Ltd",
        "advertiserAddressOne": "UNIT 2 CLAYTON ROAD",
        "advertiserTown": "WARRINGTON",
        "advertiserPostcode": "WA3 6PH",
        "advertiserLogo": "https://m.atcdn.co.uk/dealer-logo/at2/adbranding/284099/images/fpa_logo.gif",
        "numberOfReviews": "8",
        "coordinates": {
            "latitude": 53.4317772,
            "longitude": -2.5177162
        }
    },
    "scrapedAt": "2025-10-10T09:10:20.342Z"
}
```

#### 💬 Feedback & More Tools

If you find this actor helpful, please consider leaving feedback or if you have any request, please contact us.
You can try our other scraper:

👉 [**Comprehensive Google Maps Reviews Scraper**](https://apify.com/blueorion/fast-google-maps-reviews-scraper)

# Actor input Schema

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

List of Autotrader URLs to extract listing items from

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

Define maximum number of items to extract per input (between 10 and 10,000).

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

Choose how aggressively to scrape Autotrader UK Listing. Aggressive mode is faster but may trigger blocks; slow mimics human behavior.

## `searchType` (type: `string`):

Choose the appropriate search type depending on the vehicle category you’re searching for

## `postCode` (type: `string`):

Enter a specific postcode to filter results near by

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

Filter by vehicle manufacturer

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

Filter by vehicle model

## `yearFrom` (type: `string`):

Filter by the minimum registration year

## `yearTo` (type: `string`):

Filter by the maximum registration year

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://www.autotrader.co.uk/cars/retailer/stock?advertising-location=at_cars&advertising-location=at_profile_cars&onesearchad=Used&onesearchad=Nearly+New&onesearchad=New&postcode=M60+1NW&retailerId=10038961&sort=price-asc"
    },
    {
      "url": "https://www.autotrader.co.uk/car-search?channel=cars&postcode=M60+1NW&distance=&make=&homeDeliveryAdverts=include&advertising-location=at_cars&year-to=2025"
    },
    {
      "url": "https://www.autotrader.co.uk/van-search?channel=vans&postcode=NG1+1NG"
    }
  ],
  "maxItems": 10,
  "mode": "aggressive",
  "searchType": "Cars",
  "postCode": "NG1 1GF",
  "make": "BMW",
  "model": "X7",
  "yearFrom": "2023",
  "yearTo": "2025"
}
```

# 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.autotrader.co.uk/cars/retailer/stock?advertising-location=at_cars&advertising-location=at_profile_cars&onesearchad=Used&onesearchad=Nearly+New&onesearchad=New&postcode=M60+1NW&retailerId=10038961&sort=price-asc"
        },
        {
            "url": "https://www.autotrader.co.uk/car-search?channel=cars&postcode=M60+1NW&distance=&make=&homeDeliveryAdverts=include&advertising-location=at_cars&year-to=2025"
        },
        {
            "url": "https://www.autotrader.co.uk/van-search?channel=vans&postcode=NG1+1NG"
        }
    ],
    "searchType": "Cars",
    "postCode": "NG1 1GF",
    "make": "BMW",
    "model": "X7",
    "yearFrom": "2023",
    "yearTo": "2025"
};

// Run the Actor and wait for it to finish
const run = await client.actor("blueorion/fast-autotrader-uk-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.autotrader.co.uk/cars/retailer/stock?advertising-location=at_cars&advertising-location=at_profile_cars&onesearchad=Used&onesearchad=Nearly+New&onesearchad=New&postcode=M60+1NW&retailerId=10038961&sort=price-asc" },
        { "url": "https://www.autotrader.co.uk/car-search?channel=cars&postcode=M60+1NW&distance=&make=&homeDeliveryAdverts=include&advertising-location=at_cars&year-to=2025" },
        { "url": "https://www.autotrader.co.uk/van-search?channel=vans&postcode=NG1+1NG" },
    ],
    "searchType": "Cars",
    "postCode": "NG1 1GF",
    "make": "BMW",
    "model": "X7",
    "yearFrom": "2023",
    "yearTo": "2025",
}

# Run the Actor and wait for it to finish
run = client.actor("blueorion/fast-autotrader-uk-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.autotrader.co.uk/cars/retailer/stock?advertising-location=at_cars&advertising-location=at_profile_cars&onesearchad=Used&onesearchad=Nearly+New&onesearchad=New&postcode=M60+1NW&retailerId=10038961&sort=price-asc"
    },
    {
      "url": "https://www.autotrader.co.uk/car-search?channel=cars&postcode=M60+1NW&distance=&make=&homeDeliveryAdverts=include&advertising-location=at_cars&year-to=2025"
    },
    {
      "url": "https://www.autotrader.co.uk/van-search?channel=vans&postcode=NG1+1NG"
    }
  ],
  "searchType": "Cars",
  "postCode": "NG1 1GF",
  "make": "BMW",
  "model": "X7",
  "yearFrom": "2023",
  "yearTo": "2025"
}' |
apify call blueorion/fast-autotrader-uk-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,blueorion/fast-autotrader-uk-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/DmkXwrJcBCdLJYKXh/builds/ZXhLaUfuwY6pjSTWl/openapi.json
