# 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:** [Hanna Nosova](https://apify.com/fetch_cat) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# 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.

### Ready-to-run examples

- 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

Example actor page links will be available at `https://apify.com/fetch_cat/gumtree-listings-scraper` after publication.

### 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

The actor uses pay-per-event pricing:

- Start: charged once per run.
- Listing saved: charged per listing with volume discounts across Apify user tiers.

Check the live Apify pricing panel for the exact tier that applies to your account.

### 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 "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

- Initial Gumtree listings scraper build.

# 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("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=fetch_cat/gumtree-listings-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Gumtree Listings Scraper",
        "description": "Scrape public Gumtree UK listings by keyword, location, category, or URL. Export prices, locations, images, descriptions, and listing links.",
        "version": "0.1",
        "x-build-id": "78NYk5qJZZ4RVh8xg"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/fetch_cat~gumtree-listings-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-fetch_cat-gumtree-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/fetch_cat~gumtree-listings-scraper/runs": {
            "post": {
                "operationId": "runs-sync-fetch_cat-gumtree-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/fetch_cat~gumtree-listings-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-fetch_cat-gumtree-listings-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "query": {
                        "title": "Search keyword",
                        "type": "string",
                        "description": "Keyword to search on Gumtree when Start URLs are not provided. Examples: sofa, iphone, van, cleaner."
                    },
                    "location": {
                        "title": "Location",
                        "type": "string",
                        "description": "Gumtree location for keyword searches. Use a city, borough, or UK area visible on Gumtree.",
                        "default": "London"
                    },
                    "category": {
                        "title": "Search category",
                        "type": "string",
                        "description": "Gumtree category slug for keyword searches. Keep `all` for a broad search, or use a Gumtree category slug such as `cars-vans-motorbikes`.",
                        "default": "all"
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "Optional Gumtree search, category, or listing URLs. If provided, these are crawled instead of building a keyword search URL.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxItems": {
                        "title": "Maximum listings",
                        "minimum": 1,
                        "maximum": 10000,
                        "type": "integer",
                        "description": "Maximum number of listing records to save across all inputs.",
                        "default": 50
                    },
                    "includeDetails": {
                        "title": "Include listing details",
                        "type": "boolean",
                        "description": "Open each listing page to add full description and more structured metadata. This uses more requests and is slower.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Proxy settings. Apify Proxy is enabled by default because Gumtree can rate-limit direct datacenter traffic.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```