# Gumtree Car Scraper UK (`mrdoe/gumtree-car-scraper-uk`) Actor

Extracts used car listings from Gumtree.com's car classifieds, including price, year, mileage, fuel type, seller type, and location, with pagination.

- **URL**: https://apify.com/mrdoe/gumtree-car-scraper-uk.md
- **Developed by:** [MrDoe](https://apify.com/mrdoe) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 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.
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

![Gumtree Car Scraper UK hero](https://api.apify.com/v2/key-value-stores/kE36venAoVchGsE6b/records/gumtree-car-scraper-uk--hero.png)

**Turn Gumtree's car classifieds into structured data in minutes** - no coding, no manual copy-pasting. Get price, year, mileage, fuel type, seller type, and location for used cars listed on Gumtree, paged through automatically.

### What does Gumtree Car Scraper UK do?

Gumtree Car Scraper UK collects used car listings from [Gumtree.com](https://www.gumtree.com), one of the UK's largest classifieds sites, covering both private sellers and dealers. Point it at a search URL (all cars, or a filtered search you've built on Gumtree itself) and it pages through the results automatically, extracting every listing it finds.

### Why use Gumtree Car Scraper UK?

- **Sourcing** - build a shortlist of cars matching your criteria from both private sellers and dealers.
- **Market research** - track pricing by make, model, or location, including private-sale prices you won't find on dealer-only sites.
- **Lead generation** - find private sellers in a specific area for trade buying.
- **Data enrichment** - pull structured listing data into your own spreadsheet, CRM, or valuation tool.

### How to use Gumtree Car Scraper UK

![How Gumtree Car Scraper UK works](https://api.apify.com/v2/key-value-stores/kE36venAoVchGsE6b/records/gumtree-car-scraper-uk--how-it-works.png)

1. Go to the **Input** tab.
2. Leave **Start URL** as the default (all cars), or filter by make/model/price/location on gumtree.com and paste the resulting URL.
3. Set **Max items** and **Max pages** to control how much to collect.
4. Click **Start** and wait for the run to finish.
5. Open the **Dataset** tab to preview, filter, and export your results.

### Input

![Gumtree Car Scraper UK input options](https://api.apify.com/v2/key-value-stores/kE36venAoVchGsE6b/records/gumtree-car-scraper-uk--input.png)

| Field | Type | Description |
| --- | --- | --- |
| `startUrl` | String | A Gumtree.com cars search URL (default: all cars). |
| `maxItems` | Integer | Maximum number of listings to scrape, paging through 12-per-page results (default: 100). |
| `maxPages` | Integer | Safety cap on how many pages to page through (default: 20). |

Example input:

```json
{
    "startUrl": "https://www.gumtree.com/cars",
    "maxItems": 100,
    "maxPages": 10
}
```

### Output

![Gumtree Car Scraper UK dataset output](https://api.apify.com/v2/key-value-stores/kE36venAoVchGsE6b/records/gumtree-car-scraper-uk--output.png)

![Gumtree Car Scraper UK data fields](https://api.apify.com/v2/key-value-stores/kE36venAoVchGsE6b/records/gumtree-car-scraper-uk--fields.png)

Each listing is saved as one item in the dataset, for example:

```json
{
    "id": "1801512429",
    "url": "https://www.gumtree.com/p/honda/honda-cr-v-estate-2016-manual-1597-cc-5-doors/1801512429",
    "title": "Honda, CR-V, Estate, 2016, Manual, 1597 (cc), 5 doors",
    "price": 10750,
    "location": "Kingsbridge, Devon",
    "year": 2016,
    "mileage": 94334,
    "sellerType": "Private",
    "fuelType": "Diesel",
    "engineSizeCc": 1597,
    "makeSlug": "honda",
    "image": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/b40dc4fa3b4247509c_fb728c2384fd/86",
    "scrapedAt": "2026-08-14T00:00:00.000Z"
}
```

#### Data table

| Field | Description |
| --- | --- |
| `id` / `url` | Gumtree's listing ID and its own page |
| `title` | The listing title as Gumtree formats it |
| `price` | Asking price in GBP |
| `location` | Seller's location as shown on the listing |
| `year`, `mileage`, `fuelType`, `engineSizeCc` | Core vehicle spec |
| `sellerType` | "Private" or a trade/dealer designation |
| `makeSlug` | The make, as used in the listing's URL |
| `image` | Listing photo URL |
| `scrapedAt` | ISO timestamp when the item was scraped |

### Pricing / Cost estimation

How much does it cost to scrape Gumtree listings? Pricing depends on your Apify plan's compute unit rate and how many listings you request. Each page of 12 listings is a single fast request.

### Tips for better runs

- Filter on gumtree.com first (by make, model, price, or location) and paste that URL in, rather than scraping every category.
- Keep **Max items**/**Max pages** modest for daily monitoring runs to control cost and run time.
- Use the Apify **Schedule** feature to re-run this Actor periodically and track new listings over time.

### FAQ

**Is this legal?** This Actor only collects publicly visible listing data. You are responsible for using the data in accordance with Gumtree.com's Terms of Service and any applicable laws in your jurisdiction.

**Why did some fields come back empty?** Not every listing includes every field (e.g. some private sellers omit engine size). The Actor returns `null` for anything that isn't available for a given car.

**Found a bug or have a feature request?** Please use the Issues tab on this Actor's page - feedback directly shapes future updates.

# Actor input Schema

## `startUrl` (type: `string`):

A Gumtree.com cars search URL. Use the site's own filters (make, model, price, location) and paste the resulting URL here.

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

Maximum number of listings to scrape, paging through the search results (12 per page) until this limit or Max pages is reached.

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

Safety cap on how many pages of results to page through.

## Actor input object example

```json
{
  "startUrl": "https://www.gumtree.com/cars",
  "maxItems": 10,
  "maxPages": 20
}
```

# Actor output Schema

## `listings` (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 = {
    "startUrl": "https://www.gumtree.com/cars"
};

// Run the Actor and wait for it to finish
const run = await client.actor("mrdoe/gumtree-car-scraper-uk").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 = { "startUrl": "https://www.gumtree.com/cars" }

# Run the Actor and wait for it to finish
run = client.actor("mrdoe/gumtree-car-scraper-uk").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 '{
  "startUrl": "https://www.gumtree.com/cars"
}' |
apify call mrdoe/gumtree-car-scraper-uk --silent --output-dataset

```

## MCP server setup

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

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/Q76BceljfdS2orndC/builds/3X43a4bbe0LqDgpki/openapi.json