# Autotrader Scraper: UK and Canada Car Listings and Prices (`themineworks/autotrader-scraper`) Actor

Scrape Autotrader UK and AutoTrader Canada car listings by make, model, postcode or search link: price, year, mileage, fuel, gearbox, body, colour, engine, dealer name, address and phone, location, photos and link. No login.

- **URL**: https://apify.com/themineworks/autotrader-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.78 / 1,000 car listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## Autotrader Scraper: UK and Canada Car Listings and Prices

[![30 Autotrader UK cars with fuel, gearbox, body and dealer in 27 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/autotrader-scraper-hero.png)](https://console.apify.com/actors/Ni9H1CBxNvSbUKLRd/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns car listings from Autotrader UK (autotrader.co.uk) and AutoTrader Canada (autotrader.ca) by make, model, postcode or city and filters, or from search and listing links you paste: one row per car with make, model, variant, year, price, mileage, fuel, gearbox, body, colour, engine, owners, history check, dealer name, address and phone, location, photos and the listing link. No login, no cookies, no API key. You pay $0.81 per 1,000 cars on the Free plan and $0.78 per 1,000 on the Gold plan, plus a $0.003 start fee per run.

From **The Mine Works**, with over 360,000 runs across 350+ public actors.

Updated 17 Nov 2026: first release. UK and Canada in one actor, simple search fields or pasted links with every filter kept, and the full listing page for each car. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Two countries, one row shape.** The same fields for Autotrader UK and AutoTrader.ca, with `country`, `currency` (GBP or CAD) and `mileage_unit` (miles or km) on every row, so one sheet or database holds both markets.
- **More than the result card.** With `includeDetails` on (the default) each car's own page is read too: fuel, gearbox, body, colour, engine size and power, doors, seats, drivetrain, owners, history check, service history, price compared with the market, the full description and every photo.
- **Dealer data for lead lists.** Dealer name, street address, postcode, town, phone, rating, review count and dealer page for every trade listing. Private sellers keep only their town: no names and no phone numbers.
- **Paste the search you built on the site.** Copy a results link from autotrader.co.uk or autotrader.ca with all your filters and paste it; every filter in it is kept.
- **Pay per car, nothing for errors.** Links that are not Autotrader links, the summary row and a car found twice in one run are never charged. The listing page costs nothing extra.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/Ni9H1CBxNvSbUKLRd/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works E-commerce and marketplaces family:** [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 30 BMW 3 Series within 50 miles of central London with the full listing page of each. It took 27 seconds in our test run on Apify:

```json
{
  "country": "UK",
  "make": "BMW",
  "model": "3 Series",
  "postcode": "SW1A 1AA",
  "radius": 50,
  "maxResults": 30
}
```

For Canada, set `"country": "CA"` and give a city instead of a postcode, for example `"location": "Toronto, ON"`.

Apify's free plan includes $5 of credit every month, which covers about 6,000 cars at this actor's price.

#### Copy to your AI assistant

```text
themineworks/autotrader-scraper on Apify. Scrapes Autotrader UK (autotrader.co.uk) and AutoTrader Canada (autotrader.ca) car listings and returns one flat row per car, no login. Call ApifyClient("TOKEN").actor("themineworks/autotrader-scraper").call(run_input={"country": "UK", "make": "BMW", "model": "3 Series", "postcode": "SW1A 1AA", "radius": 50, "maxResults": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Input: country (UK default, or CA), make, model (as written on the site), postcode (UK), location (Canada, "City, PR"), radius (miles UK, km Canada), priceMin, priceMax, yearMin, yearMax, maxMileage, fuelType (any, petrol, diesel, electric, hybrid, plug-in hybrid), transmission (any, automatic, manual), bodyType (any, hatchback, saloon, estate, suv, coupe, convertible, mpv, pickup), sellerType (any, dealer, private), keywords (UK), sort (relevance, price_asc, price_desc, mileage, year_dsc, year_asc, distance, most_recent), startUrls (autotrader.co.uk car-search or car-details links, autotrader.ca /cars/ or /offers/ links), maxResults (default 50, max 5000 per search), includeDetails (default true). Car rows have no _type field and carry country, listing_id, url, title, make, model, variant, trim, year, registration, first_registered, condition, price, price_text, currency, price_indicator, price_vs_market, mileage, mileage_unit, fuel_type, transmission, body_type, colour, engine_size_litres, engine_size_cc, engine_power, drivetrain, doors, seats, owners, history_check, write_off_category, seller_type, dealer_id, dealer_name, dealer_address, dealer_town, dealer_county, dealer_postcode, dealer_phone, dealer_email, dealer_rating, dealer_review_count, dealer_url, location, province, distance, distance_unit, description, image_url, images, image_count, details_scraped, search_label, search_url, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when cars were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~autotrader-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **Simple search fields.** Make, model, UK postcode or Canadian city, radius, price range, year range, maximum mileage, fuel, gearbox, body type, dealer or private seller, keywords (UK) and sort order.
- **Pasted links.** Autotrader UK results links (`/car-search?...`, also van, bike and motorhome searches) and AutoTrader.ca results links (`/cars/...`), with every filter you set on the site, plus single listing links (`/car-details/...` and `/offers/...`).
- **Deep searches.** Up to 5,000 cars per search. Autotrader UK itself shows at most 2,000 cars (100 pages) for one search; split a bigger search by price or year.
- **Details on or off.** On (the default): each car's page is read for the full specification, history, description, every photo and the dealer's contact details. Off: rows come from the result cards only, about 20 times fewer requests. Canada cards already carry fuel, gearbox and dealer name; UK cards do not, unless your search filters on them. Same price either way.
- **Stops cleanly.** A search with no results ends after one request. Five failed pages in a row end the run; listing pages that keep failing are switched off and the rows still come from the cards. The run stops before its time limit and keeps every row, and the summary row says what happened.

### How to use it

#### UK: automatic Golfs under £15,000 near Manchester, cheapest first

```json
{
  "country": "UK",
  "make": "Volkswagen",
  "model": "Golf",
  "postcode": "M1 1AE",
  "radius": 40,
  "yearMin": 2018,
  "priceMax": 15000,
  "transmission": "automatic",
  "sort": "price_asc",
  "maxResults": 200
}
```

#### Canada: Honda CR-V within 100 km of Toronto

```json
{
  "country": "CA",
  "make": "Honda",
  "model": "CR-V",
  "location": "Toronto, ON",
  "radius": 100,
  "maxResults": 200
}
```

#### Dealer stock for a lead list, result cards only

```json
{
  "country": "UK",
  "postcode": "B1 1AA",
  "radius": 30,
  "sellerType": "dealer",
  "includeDetails": false,
  "maxResults": 2000
}
```

#### Paste your own links

```json
{
  "startUrls": [
    "https://www.autotrader.co.uk/car-search?postcode=EH1%201YZ&radius=60&make=Tesla&model=Model%203&sort=price-asc",
    "https://www.autotrader.ca/cars/toyota/rav4/reg_bc/cit_vancouver?zipr=100",
    "https://www.autotrader.co.uk/car-details/202609216219216"
  ],
  "maxResults": 100
}
```

Links are read on top of the search fields. To run only your links, leave make, model, postcode and the filters empty.

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `country` | UK or CA | UK | Site the search fields go to. Links pick their own site. |
| `make` / `model` | text | | As written on the site, e.g. BMW / 3 Series. Empty = all. |
| `postcode` | text | | UK only. Empty = the whole UK, with distances from central London. |
| `location` | text | | Canada only: "City, PR", e.g. Calgary, AB. Empty = all of Canada. |
| `radius` | number | | Miles (UK) or km (Canada) around the postcode or city. |
| `priceMin` / `priceMax` | number | | Price range in GBP or CAD. |
| `yearMin` / `yearMax` | number | | Year range. |
| `maxMileage` | number | | Miles (UK) or km (Canada). |
| `fuelType` | choice | any | petrol, diesel, electric, hybrid, plug-in hybrid. |
| `transmission` | choice | any | automatic or manual. |
| `bodyType` | choice | any | hatchback, saloon, estate, suv, coupe, convertible, mpv, pickup. |
| `sellerType` | choice | any | dealer or private. |
| `keywords` | text | | UK only: words the advert must contain. |
| `sort` | choice | relevance | price_asc, price_desc, mileage, year_dsc, year_asc, distance, most_recent. |
| `startUrls` | list of text | | Autotrader UK or AutoTrader.ca search or listing links. |
| `maxResults` | number | 50 | Most cars per search, 1 to 5,000. |
| `includeDetails` | true/false | true | Reads each car's own page for the full record. |
| `proxyConfiguration` | proxy | Apify proxy | Leave as is. UK pages go through the Apify datacenter proxy; Canada goes direct and uses the proxy only if refused. |

### What data do you get?

| Field | Example | Notes |
|---|---|---|
| `country` / `listing_id` / `url` | UK / 202609216219216 / https://www.autotrader.co.uk/car-details/202609216219216 | |
| `title` / `make` / `model` / `variant` | 2012 BMW 3 Series / BMW / 3 Series / 2.0 320i M Sport Euro 5 (s/s) 2dr | |
| `year` / `registration` / `first_registered` | 2012 / 2012 (61 reg) / 30/09/2011 | UK plate and date |
| `price` / `price_text` / `currency` | 2495 / £2,495 / GBP | |
| `price_indicator` / `price_vs_market` | Lower price / £2,710 below market average | |
| `mileage` / `mileage_unit` | 71000 / miles | km for Canada |
| `fuel_type` / `transmission` / `body_type` / `colour` | Petrol / Manual / Convertible / White | |
| `engine_size_litres` / `engine_power` / `doors` / `seats` | 2 / 168BHP / 2 / 4 | |
| `owners` / `history_check` / `write_off_category` | 5 / PASSED / Cat N | UK |
| `seller_type` / `dealer_name` / `dealer_phone` | dealer / Borz Motors / (07537) 165481 | dealers only |
| `dealer_address` / `dealer_postcode` / `dealer_rating` | Tilling Way / HA9 7NQ / 4.9 | dealers only |
| `location` / `province` / `distance` | Wembley / ON / 9 | province for Canada |
| `image_url` / `images` / `image_count` | https://m.atcdn.co.uk/a/media/13e69f7c20684d63b5c8dd5eaa3cb6ea.jpg / \[...] / 30 | full size |
| `description` | BMW 320i M Sport Convertible, petrol, manual... | with details |
| `search_label` / `page` / `position` | BMW 3 Series near SW1A 1AA / 1 / 2 | where the row came from |

#### Output example

```json
{
  "country": "UK",
  "listing_id": "202609216219216",
  "url": "https://www.autotrader.co.uk/car-details/202609216219216",
  "title": "2012 BMW 3 Series",
  "make": "BMW",
  "model": "3 Series",
  "variant": "2.0 320i M Sport Euro 5 (s/s) 2dr",
  "year": 2012,
  "registration": "2012 (61 reg)",
  "condition": "used",
  "price": 2495,
  "price_text": "£2,495",
  "currency": "GBP",
  "price_indicator": "Lower price",
  "price_vs_market": "£2,710 below market average",
  "mileage": 71000,
  "mileage_unit": "miles",
  "fuel_type": "Petrol",
  "transmission": "Manual",
  "body_type": "Convertible",
  "colour": "White",
  "engine_size_litres": 2,
  "engine_power": "168BHP",
  "doors": 2,
  "seats": 4,
  "owners": 5,
  "history_check": "PASSED",
  "seller_type": "dealer",
  "dealer_id": "10049986",
  "dealer_name": "Borz Motors",
  "dealer_address": "Tilling Way",
  "dealer_town": "Wembley",
  "dealer_county": "Middlesex",
  "dealer_postcode": "HA9 7NQ",
  "dealer_phone": "(07537) 165481",
  "dealer_rating": 4.9,
  "dealer_review_count": 30,
  "dealer_url": "https://www.autotrader.co.uk/dealers/middlesex/wembley/borz-motors-10049986",
  "location": "Wembley",
  "distance": 9,
  "distance_unit": "miles",
  "image_url": "https://m.atcdn.co.uk/a/media/13e69f7c20684d63b5c8dd5eaa3cb6ea.jpg",
  "image_count": 30,
  "details_scraped": true,
  "search_label": "BMW 3 Series near SW1A 1AA",
  "page": 1,
  "position": 2,
  "scraped_at": "2026-11-17T14:20:52.120Z"
}
```

### Pricing

Pay per event: you pay for the cars you receive, plus a flat $0.003 per run, whatever memory you choose. The listing page costs nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `car-listing` | Once per car row stored in your dataset | $0.81 per 1,000 | $0.80 per 1,000 | $0.79 per 1,000 | $0.78 per 1,000 |
| `run-start` | Once per run, after a search returned cars | $0.003 | $0.003 | $0.003 | $0.003 |

Never charged:

- links that are not Autotrader UK or AutoTrader.ca links (each gets an error row);
- a car that a second search or link of the same run finds again;
- cars past your `maxResults`;
- the summary, info and error rows;
- a run with no valid input, or one whose searches return no cars: the start fee is charged only once cars came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Countries | Search fields (no link needed) | Dealer phone and address |
|---|---|---|---|---|---|
| **This actor** | $0.81 | $0.003 per run | UK and Canada | Yes | Yes, included |
| [Autotrader UK Scraper by epctex](https://apify.com/epctex/autotradercouk-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $0.90 | $0.00005 per run | UK | Links only | Not listed |
| [AutoTrader.ca Scraper by fayoussef](https://apify.com/fayoussef/autotrader-canada?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $0.90 | $0.00005 per run | Canada | Yes | Dealer details listed |
| [Autotrader.co.uk Scraper by memo23](https://apify.com/memo23/autotrader-cheerio?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $0.85, details $1.00 extra | $0.005 per run | UK | Links only | Dealer profile $2.00 extra, email $50.00 extra |

Checked 17 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Use `sort: "most_recent"` for a daily feed of new listings, and compare runs on `listing_id` to keep only new cars or to track price drops.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

Autotrader UK's and AutoTrader.ca's public search results and listing pages, the same data the websites show any visitor without logging in. It does not log in, contact sellers or read buyer data.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. The Apify datacenter proxy that the actor uses for Autotrader UK is included in every Apify plan, with no extra fee.

#### Does it cover Autotrader.com (US)?

No. Autotrader.com refuses plain automated requests, so this actor covers the UK and Canada only.

#### How many cars can I get?

Up to 5,000 per search and up to 50 searches per run. Autotrader UK shows at most 2,000 cars for one search; split it by price band or year to get more. The site's total for each search is in the summary row (`per_search`).

#### How fast is it?

A result page brings 20 cars. With details on, each car is one more page, read 10 at a time. In our test runs on Apify: 30 UK cars with details in 27 to 37 seconds, 144 UK cars with details in 69 seconds, 100 Canadian cars with details in 13 seconds, and 1,000 UK cars from the result cards alone in about a minute. Turn `includeDetails` off when you need volume more than the full record.

#### Why do some UK rows have no fuel, gearbox or body?

Those come from the listing page. With `includeDetails` off they are filled only when your search filters on them (for example `fuelType: "diesel"`). A listing that was sold between the search and the page read keeps the card fields and gets `details_error: "not_found"`.

#### Why is there no phone number for some cars?

Phone numbers, addresses and emails are returned for dealers only. For private sellers the actor keeps the town and nothing that identifies the person.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, the `images` list is flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/autotrader-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http autotrader-scraper "https://mcp.apify.com/?tools=themineworks/autotrader-scraper"`

#### Is it legal to scrape Autotrader?

The actor reads only public listings that sellers publish to be found, without logging in, and keeps contact details for businesses (dealers) only. You are responsible for how you use the data, including the sites' terms and laws that apply to you, such as GDPR and UK GDPR. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's cars to a sheet with Apify's Google Sheets integration; one row per car fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new diesel estates under £10,000 every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [AliExpress Scraper](https://apify.com/themineworks/aliexpress-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Kleinanzeigen.de Scraper](https://apify.com/themineworks/kleinanzeigen-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Carsales.com.au Scraper](https://apify.com/themineworks/carsales-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [eBay Product Listings Scraper](https://apify.com/themineworks/ebay-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shopify Store Scraper](https://apify.com/themineworks/shopify-store-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [🛒 TikTok Shop Scraper](https://apify.com/themineworks/tiktok-shop-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Walmart Product & Price Scraper](https://apify.com/themineworks/walmart-product-price-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Vinted Scraper](https://apify.com/themineworks/vinted-listings-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that returns fewer cars than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or another car site, email dmineworks@gmail.com.

*Search Autotrader UK and AutoTrader Canada by make, model and place and get every car back as one row, with price, mileage, fuel, gearbox, body, dealer and photos, no login.*

# Actor input Schema

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

Which Autotrader site the search fields below go to. Links in Search or listing links pick their own site.

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

Make as written on the site, e.g. BMW, Ford, Toyota. Leave empty for all makes.

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

Model as written on the site, e.g. 3 Series, Fiesta, RAV4. Needs a make.

## `postcode` (type: `string`):

UK only: search around this postcode, e.g. M1 1AE. Leave empty for the whole UK (distances then count from central London).

## `location` (type: `string`):

Canada only: city and province, e.g. Toronto, ON or Vancouver, BC. Leave empty for all of Canada.

## `radius` (type: `integer`):

Distance around the postcode (miles, UK) or city (km, Canada). Empty = national (UK) or 100 km (Canada).

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

Lowest price in GBP (UK) or CAD (Canada).

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

Highest price in GBP (UK) or CAD (Canada).

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

Oldest year, e.g. 2018.

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

Newest year.

## `maxMileage` (type: `integer`):

Highest mileage: miles (UK) or km (Canada).

## `fuelType` (type: `string`):

Fuel type.

## `transmission` (type: `string`):

Gearbox.

## `bodyType` (type: `string`):

Body type.

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

Dealers, private sellers or both.

## `keywords` (type: `string`):

UK only: words the advert must contain, e.g. panoramic roof.

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

Order of the results.

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

Optional. Paste search links from autotrader.co.uk (car-search?...) or autotrader.ca (/cars/...), or single listing links (car-details/... or /offers/...). Every filter in the link is kept. Each link is read on top of the fields above.

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

Stop each search after this many cars. Autotrader UK shows at most 2,000 cars per search; split big searches by price or year.

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

On: fuel, gearbox, body, colour, engine, doors, seats, owners, history check, full description, all photos and the dealer name, address and phone. Off: faster, from the result cards only (UK cards have no fuel, gearbox, body or dealer name).

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

Leave as is. Autotrader UK is read through the Apify datacenter proxy (no extra fee); AutoTrader.ca goes direct and moves to the proxy only if it refuses a request.

## Actor input object example

```json
{
  "country": "UK",
  "make": "BMW",
  "model": "3 Series",
  "postcode": "SW1A 1AA",
  "radius": 50,
  "fuelType": "any",
  "transmission": "any",
  "bodyType": "any",
  "sellerType": "any",
  "sort": "relevance",
  "maxResults": 30,
  "includeDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

## `summary` (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 = {
    "make": "BMW",
    "model": "3 Series",
    "postcode": "SW1A 1AA",
    "radius": 50,
    "maxResults": 30,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/autotrader-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 = {
    "make": "BMW",
    "model": "3 Series",
    "postcode": "SW1A 1AA",
    "radius": 50,
    "maxResults": 30,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/autotrader-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 '{
  "make": "BMW",
  "model": "3 Series",
  "postcode": "SW1A 1AA",
  "radius": 50,
  "maxResults": 30,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/autotrader-scraper --silent --output-dataset

```

## MCP server setup

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