# Gumtree Listings Scraper (`fetch_cat/gumtree-listings-scraper`) Actor

Scrape public Gumtree UK listings by keyword, location, category, or URL. Export prices, locations, images, descriptions, and listing links.

- **URL**: https://apify.com/fetch_cat/gumtree-listings-scraper.md
- **Developed by:** [Fetch Cat](https://apify.com/fetch_cat) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 5 total users, 1 monthly users, 86.7% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.03 / 1,000 listing extracteds

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 Listings Scraper

Extract public Gumtree UK marketplace listings into clean JSON, CSV, Excel, or API-ready datasets. Use it to monitor local prices, source resale inventory, research categories, or build lead lists from Gumtree search and category pages.

### What you can do

- Search Gumtree by keyword, location, and category.
- Crawl existing Gumtree search or category URLs.
- Limit runs by maximum listing count for quick checks or larger exports.
- Optionally open each listing page for the full description and richer metadata.
- Export structured listing data through the Apify dataset API.

### Who is it for

Marketplace sellers, resellers, local commerce analysts, pricing researchers, agencies, and lead-generation teams use this actor to turn public Gumtree listings into a spreadsheet or automated data feed.

Common users include:

- Resellers tracking local inventory and price drops.
- Agencies collecting public seller leads from niche searches.
- Analysts comparing prices across UK cities and categories.
- Operators feeding Gumtree listing data into dashboards, alerts, or CRMs.

### Example inputs

- Search for sofas in London: `query = "sofa"`, `location = "London"`, `maxItems = 50`
- Monitor used phones: `query = "iphone"`, `location = "Manchester"`, `category = "all"`
- Crawl a saved Gumtree URL: add it to `startUrls` and leave `query` empty

### Input

```json
{
  "query": "sofa",
  "location": "London",
  "category": "all",
  "maxItems": 20,
  "includeDetails": false,
  "startUrls": []
}
```

| Field | Type | Description |
| --- | --- | --- |
| `query` | string | Search keyword used when `startUrls` is empty. |
| `location` | string | Gumtree UK location such as `London`, `Manchester`, or `Bristol`. |
| `category` | string | Gumtree category slug. Use `all` for broad searches. |
| `startUrls` | array | Optional Gumtree search, category, or listing URLs. These override keyword search building. |
| `maxItems` | integer | Maximum number of listings to save. |
| `includeDetails` | boolean | Opens each listing page to add full description and extra structured metadata. |
| `proxyConfiguration` | object | Apify Proxy settings. Enabled by default to keep public Gumtree search pages reachable. |

### Output

```json
{
  "title": "Grey velvet sofa bed",
  "price": "£150",
  "currency": "GBP",
  "location": "Chislehurst, London",
  "category": "sofa beds futons",
  "listingUrl": "https://www.gumtree.com/p/sofa-beds-futons/example/1512345678",
  "imageUrls": ["https://img.gumtree.com/example/86"],
  "descriptionSnippet": "Compact sofa bed, ideal for a guest room.",
  "sellerName": null,
  "postedAt": null,
  "listingId": "1512345678",
  "scrapedAt": "2026-07-07T08:30:00.000Z",
  "sourceUrl": "https://www.gumtree.com/search?search_category=all&q=sofa&search_location=London"
}
```

#### Output fields

- `title` — listing title
- `price` and `currency` — displayed price and detected currency
- `location` — Gumtree listing location
- `category` — category inferred from listing URL or detail breadcrumbs
- `listingUrl` — canonical public listing URL
- `imageUrls` — listing image URLs
- `descriptionSnippet` — short listing-card description
- `sellerName` — seller name when available in detail data
- `postedAt` — visible posted time when available
- `listingId` — Gumtree listing ID
- `fullDescription` — full listing text when `includeDetails` is enabled
- `attributes` — extra structured attributes when available
- `scrapedAt` — scrape timestamp
- `sourceUrl` — search/category/input URL where the listing was found

### Pricing

Each run has a $0.005 start fee. A listing is charged only when it is saved to the default dataset.

| Apify plan tier | Price per saved listing | Approximate price per 1,000 saved listings |
| --- | ---: | ---: |
| Free | $0.000050745 | $0.050745 |
| Starter / Bronze | $0.000044126 | $0.044126 |
| Scale / Silver | $0.000034418 | $0.034418 |
| Business / Gold | $0.000026475 | $0.026475 |
| Platinum | $0.000017650 | $0.017650 |
| Diamond | $0.000012355 | $0.012355 |

### API usage

Start a run with cURL:

```bash
curl "https://api.apify.com/v2/acts/fetch_cat~gumtree-listings-scraper/runs?token=$APIFY_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{"query":"sofa","location":"London","maxItems":20}'
```

Start a run with Node.js:

```js
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/gumtree-listings-scraper').call({
  query: 'sofa',
  location: 'London',
  maxItems: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
```

Start a run with Python:

```python
from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/gumtree-listings-scraper').call(run_input={
    'query': 'sofa',
    'location': 'London',
    'maxItems': 20,
})
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)
```

After the run finishes, download results from the default dataset as JSON, CSV, Excel, XML, or RSS.

### MCP

Use this actor from agents through Apify MCP:

`https://mcp.apify.com?tools=fetch_cat/gumtree-listings-scraper`

Claude CLI example:

```bash
claude mcp add apify-gumtree --url "https://mcp.apify.com?tools=fetch_cat/gumtree-listings-scraper"
```

MCP JSON configuration example:

```json
{
  "mcpServers": {
    "apify-gumtree": {
      "url": "https://mcp.apify.com?tools=fetch_cat/gumtree-listings-scraper"
    }
  }
}
```

Example prompts:

- "Search Gumtree for sofas in London and return the cheapest listings."
- "Monitor Gumtree bikes in Birmingham and summarize listings with images."
- "Export Gumtree iPhone listings in Manchester for my pricing spreadsheet."

### Legality and responsible use

This actor extracts public Gumtree listing pages that are visible without logging in. You are responsible for using the data in line with Gumtree's terms, privacy rules, and laws that apply to your use case. Avoid collecting unnecessary personal data, do not attempt to bypass access controls, and respect deletion or opt-out requests where applicable.

### Tips and limits

- Use `startUrls` when you already have a Gumtree category or filtered search URL.
- Keep `includeDetails` off for faster, cheaper search monitoring.
- Enable `includeDetails` when full descriptions matter more than speed.
- The actor uses Apify Proxy by default because Gumtree can rate-limit direct datacenter traffic.
- Public Gumtree pages can change layout; contact support with a run ID if fields are missing.
- Only scrape public listings and use the output in line with Gumtree's terms and applicable laws.

### FAQ

**Does this require a Gumtree account?**\
No. It extracts public Gumtree UK listing pages that are visible without logging in.

**Can it scrape individual listing URLs?**\
Yes. Add public listing URLs to `startUrls`; detail mode is useful for those runs.

**What should I send to support?**\
Please include the run ID or run URL, your input JSON, expected output, and actual output so the issue can be reproduced.

### Related actors

- [Vinted Search Scraper](https://apify.com/fetch_cat/vinted-search-scraper)
- [Poshmark Sold Listings Scraper](https://apify.com/fetch_cat/poshmark-sold-listings-scraper)
- [AliExpress Products Scraper](https://apify.com/fetch_cat/aliexpress-products-scraper)

### Support

If a run does not return the listings you expected, open an Apify issue and include the run ID, run URL, input JSON, expected output, and actual output.

# Changelog

This Actor's version history is a separate document: https://apify.com/fetch_cat/gumtree-listings-scraper/changelog.md

# Actor input Schema

## `query` (type: `string`):

Keyword to search on Gumtree when Start URLs are not provided. Examples: sofa, iphone, van, cleaner.

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

Gumtree location for keyword searches. Use a city, borough, or UK area visible on Gumtree.

## `category` (type: `string`):

Gumtree category slug for keyword searches. Keep `all` for a broad search, or use a Gumtree category slug such as `cars-vans-motorbikes`.

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

Optional Gumtree search, category, or listing URLs. If provided, these are crawled instead of building a keyword search URL.

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

Maximum number of listing records to save across all inputs.

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

Open each listing page to add full description and more structured metadata. This uses more requests and is slower.

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

Proxy settings. Apify Proxy is enabled by default because Gumtree can rate-limit direct datacenter traffic.

## Actor input object example

```json
{
  "query": "sofa",
  "location": "London",
  "category": "all",
  "startUrls": [
    {
      "url": "https://www.gumtree.com/search?search_category=all&q=sofa&search_location=London"
    }
  ],
  "maxItems": 20,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `overview` (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 = {
    "query": "sofa",
    "location": "London",
    "category": "all",
    "startUrls": [
        {
            "url": "https://www.gumtree.com/search?search_category=all&q=sofa&search_location=London"
        }
    ],
    "maxItems": 20,
    "includeDetails": false,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("fetch_cat/gumtree-listings-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 = {
    "query": "sofa",
    "location": "London",
    "category": "all",
    "startUrls": [{ "url": "https://www.gumtree.com/search?search_category=all&q=sofa&search_location=London" }],
    "maxItems": 20,
    "includeDetails": False,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("fetch_cat/gumtree-listings-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 '{
  "query": "sofa",
  "location": "London",
  "category": "all",
  "startUrls": [
    {
      "url": "https://www.gumtree.com/search?search_category=all&q=sofa&search_location=London"
    }
  ],
  "maxItems": 20,
  "includeDetails": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call fetch_cat/gumtree-listings-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,fetch_cat/gumtree-listings-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/U1R8gxP46cOyUPqJH/builds/iZrwBp2HNTVeFUCdA/openapi.json