# Gumtree UK Listings, Sellers & Reviews Scraper (`abotapi/gumtree-uk-scraper`) Actor Scrape gumtree.com classifieds across motors, property, jobs, services, pets and goods for sale. Extract titles, descriptions, prices, photos, locations, listing attributes, seller ratings, star distributions and reviews. Search by keyword, category and location, or paste any Gumtree URL. - **URL**: https://apify.com/abotapi/gumtree-uk-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (community) - **Categories:** E-commerce, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.50 / 1,000 listing 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/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 UK Scraper — Listings, Prices, Seller Ratings & Reviews Extract classified listings from **gumtree.com** across every vertical — motors, property, jobs, services, pets, community and the for-sale goods categories — with the full listing detail and the seller's aggregate rating, star distribution and reviews. Search by category + location + keyword, or paste any Gumtree results or listing URL. The scraper walks result pages forward automatically and returns one clean record per listing. ### What you get Every listing record includes: - **Identity** — `id`, `url`, `title`, `categoryId`, `categoryName`, `vertical` - **Price** — `price` (number), `priceText`, `currency` - **Location** — `location`, `distance`, plus `latitude` / `longitude` / `postcode` / `area` when detail enrichment is on - **Listing** — `shortDescription`, full `description`, all `images`, `imageCount`, `hasVideo`, `postedDate`, `status`, `featured` / `urgent` / `premium` flags - **Attributes** — the full structured attribute list (for cars: make, model, year, mileage, fuel type, transmission, and dozens more) - **Seller** — `seller.type` (private / trade), `seller.rating` (0–5 average), `seller.reviewCount`, `seller.ratingDistribution` (count per star), individual `seller.reviews`, plus activity stats (`postingSince`, `totalAdvertCount`, `lastActiveStatus`) Seller ratings and reviews are published only on the listing page, so they are captured when **Fetch full listing detail** is enabled (default on). Turn it off for faster, cheaper results-only runs. ### Input | Field | Description | |-------|-------------| | **Search mode** | `search` — build the query from filters below · `url` — paste your own Gumtree URLs | | **Category** | Motors, Cars only, Property, Jobs, Services, Pets, Community, or All / For-sale goods | | **Location** | Town, city or region (e.g. `London`, `Manchester`). Empty = all of the UK | | **Keyword** | Free-text search (e.g. `ford focus`, `iphone 15`) | | **Sort** | Most relevant · Most recent · Price low→high · Price high→low · Nearest | | **Min / Max price (GBP)** | Narrow to a price band | | **Fetch full listing detail** | Add description, map location and seller rating & reviews (default on) | | **Max listings / Max pages** | Bound the run size | | **URLs** | (URL mode) any gumtree.com results or listing URLs | #### Example input ```json { "mode": "search", "category": "cars", "location": "London", "minPrice": 5000, "maxPrice": 15000, "sortBy": "most_recent", "fetchDetails": true, "maxItems": 100 } ```` ### Output Each listing is one dataset record. Example (illustrative values): ```json { "id": "1500000001", "url": "https://www.gumtree.com/p/ford/ford-focus-1-0-ecoboost/1500000001", "title": "Ford Focus 1.0 EcoBoost Zetec, 2018, Manual", "price": 7495.0, "priceText": "£7,495.00", "currency": "GBP", "categoryId": "10319", "vertical": "motors", "location": "Camden, London", "distance": "3 miles", "postedDate": "2 days ago", "shortDescription": "One owner, full service history, MOT until 2026 …", "description": "One owner from new, full Ford service history, two keys, recent …", "images": [ "https://img.gumtree.com/aaaaaaaa/1111111111_2222222222/max800", "https://img.gumtree.com/aaaaaaaa/3333333333_4444444444/max800" ], "imageCount": 12, "latitude": 51.5390, "longitude": -0.1426, "postcode": "NW1 8QP", "attributes": [ { "name": "Make", "value": "Ford", "key": "vehicle_make" }, { "name": "Year", "value": "2018", "key": "vehicle_registration_year" }, { "name": "Mileage", "value": "42,300", "key": "vehicle_mileage", "unit": "miles" }, { "name": "Fuel type", "value": "Petrol", "key": "vehicle_fuel_type" } ], "detailFetched": true, "seller": { "name": "Jane D", "type": "private", "rating": 4.8, "reviewCount": 25, "ratingDistribution": { "1": 0, "2": 1, "3": 0, "4": 2, "5": 22 }, "reviews": [ { "rating": 5, "text": "Smooth sale, great communication.", "date": "2026-05-14" } ], "postingSince": "3 years", "totalAdvertCount": 8 }, "scrapedAt": "2026-07-06T10:00:00Z" } ``` ### Tips - **Sub-categories & complex filters:** refine your search on gumtree.com in a browser, then paste the resulting URL in **URL mode** — every filter in the URL is honoured, and pagination continues from that page. - **Faster runs:** turn **Fetch full listing detail** off to get the results-page fields only (seller rating fields are then left empty). - **Export anywhere:** pipe results straight into Notion, Airtable or Linear via the optional MCP connectors, or download as JSON / CSV / Excel from the dataset. ### FAQ **Does it cover the whole of the UK?** Yes — leave Location empty for a national search, or set any town, city or region. **Are seller reviews included?** Yes, where the seller has them. Each record carries the seller's average rating, the count per star, and individual review entries, alongside the seller's activity stats. **Which categories are supported?** All of Gumtree's verticals — motors, property, jobs, services, pets, community and the for-sale goods categories — plus any sub-category via URL mode. # Actor input Schema ## `mode` (type: `string`): Search mode = build the query from the category / location / keyword filters below. URL mode = paste any gumtree.com results or listing URL you already refined in a browser (best for complex filters and sub-categories). ## `urls` (type: `array`): gumtree.com results-page URLs or listing URLs. Tip: open gumtree.com, choose a category + location + filters, then paste the resulting URL here. In URL mode all the filter fields below are ignored. ## `category` (type: `string`): Top-level category to search. 'All categories' searches the for-sale goods; the other options cover Gumtree's main verticals. For a specific sub-category, use URL mode with a browsed URL. ## `location` (type: `string`): Town, city or region to search in (e.g. 'London', 'Manchester', 'Birmingham', 'West Midlands'). Leave empty to search all of the UK. ## `keywords` (type: `string`): Free-text keyword to search for (e.g. 'ford focus', 'iphone 15'). When set, the scraper runs a keyword search (optionally narrowed to the location above). Optional — leave empty to browse the whole category. ## `sortBy` (type: `string`): How to order results. ## `minPrice` (type: `integer`): Only return listings priced at or above this amount. ## `maxPrice` (type: `integer`): Only return listings priced at or below this amount. ## `fetchDetails` (type: `boolean`): Adds a detail-enrichment charge per enriched listing. ## `maxItems` (type: `integer`): Maximum number of listings to return across the whole run. 0 = no limit (bounded by Max pages). ## `maxPages` (type: `integer`): How many result pages to walk forward per search (30 listings per page). ## `proxy` (type: `object`): Apify Proxy is used to reach the site reliably. The default automatic proxy works well; IP rotation is handled for you. ## `mcpConnectors` (type: `array`): Optionally send scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item; the full record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "urls": [ "https://www.gumtree.com/cars-vans-motorbikes/cars/uk/london" ], "category": "all", "location": "London", "fetchDetails": true, "maxItems": 100, "maxPages": 5, "proxy": { "useApifyProxy": true }, "maxNotifyListings": 50 } ``` # Actor output Schema ## `listings` (type: `string`): Individual listing records with price, location, image URLs, category attributes, and seller info. ## `output` (type: `string`): Run summary with total listings and request count. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.gumtree.com/cars-vans-motorbikes/cars/uk/london" ], "location": "London", "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/gumtree-uk-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.gumtree.com/cars-vans-motorbikes/cars/uk/london"], "location": "London", "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/gumtree-uk-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 '{ "urls": [ "https://www.gumtree.com/cars-vans-motorbikes/cars/uk/london" ], "location": "London", "proxy": { "useApifyProxy": true } }' | apify call abotapi/gumtree-uk-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/gumtree-uk-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gumtree UK Listings, Sellers & Reviews Scraper", "description": "Scrape gumtree.com classifieds across motors, property, jobs, services, pets and goods for sale. Extract titles, descriptions, prices, photos, locations, listing attributes, seller ratings, star distributions and reviews. Search by keyword, category and location, or paste any Gumtree URL.", "version": "0.1", "x-build-id": "ShtNzcb9Hjzl4qxnQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~gumtree-uk-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-gumtree-uk-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/abotapi~gumtree-uk-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-gumtree-uk-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/abotapi~gumtree-uk-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-gumtree-uk-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": { "mode": { "title": "1. Search mode", "enum": [ "search", "url" ], "type": "string", "description": "Search mode = build the query from the category / location / keyword filters below. URL mode = paste any gumtree.com results or listing URL you already refined in a browser (best for complex filters and sub-categories).", "default": "search" }, "urls": { "title": "Search or listing URLs (URL mode)", "type": "array", "description": "gumtree.com results-page URLs or listing URLs. Tip: open gumtree.com, choose a category + location + filters, then paste the resulting URL here. In URL mode all the filter fields below are ignored.", "items": { "type": "string" } }, "category": { "title": "Category / vertical", "enum": [ "all", "motors", "cars", "property", "jobs", "services", "pets", "community" ], "type": "string", "description": "Top-level category to search. 'All categories' searches the for-sale goods; the other options cover Gumtree's main verticals. For a specific sub-category, use URL mode with a browsed URL.", "default": "all" }, "location": { "title": "Location", "type": "string", "description": "Town, city or region to search in (e.g. 'London', 'Manchester', 'Birmingham', 'West Midlands'). Leave empty to search all of the UK." }, "keywords": { "title": "Keyword", "type": "string", "description": "Free-text keyword to search for (e.g. 'ford focus', 'iphone 15'). When set, the scraper runs a keyword search (optionally narrowed to the location above). Optional — leave empty to browse the whole category." }, "sortBy": { "title": "Sort order", "enum": [ "best_match", "most_recent", "price_asc", "price_desc", "nearest" ], "type": "string", "description": "How to order results." }, "minPrice": { "title": "Minimum price (GBP)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or above this amount." }, "maxPrice": { "title": "Maximum price (GBP)", "minimum": 0, "type": "integer", "description": "Only return listings priced at or below this amount." }, "fetchDetails": { "title": "Fetch full listing detail (description, map location, seller rating & reviews)", "type": "boolean", "description": "Adds a detail-enrichment charge per enriched listing.", "default": true }, "maxItems": { "title": "Max listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to return across the whole run. 0 = no limit (bounded by Max pages).", "default": 100 }, "maxPages": { "title": "Max result pages per search", "minimum": 1, "type": "integer", "description": "How many result pages to walk forward per search (30 listings per page).", "default": 5 }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy is used to reach the site reliably. The default automatic proxy works well; IP rotation is handled for you.", "default": { "useApifyProxy": true } }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send scraped results into apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item; the full record stays in the dataset. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```