# Gumtree Scraper — UK Classifieds & Marketplace Data (`studio-amba/gumtree-scraper`) Actor Scrape classified listings from Gumtree.com — the UK's #1 marketplace for cars, furniture, jobs and pets. Search by keyword, category, location and price. No login or cookies required. - **URL**: https://apify.com/studio-amba/gumtree-scraper.md - **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community) - **Categories:** Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $8.00 / 1,000 result scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Scraper Extract classified listings from [Gumtree.com](https://www.gumtree.com), the UK's largest marketplace — cars, furniture, jobs, pets, property and services — by keyword, category, location and price. No login, no cookies. ### Why use this actor? Gumtree has millions of live UK classifieds but no public API. This actor turns any search into clean, structured JSON: title, price, location, condition, seller, posted date and every image. Use it for price research, market and demand analysis, lead generation, resale sourcing, or feeding a downstream dataset. You point it at a search; it returns rows you can drop straight into a spreadsheet, database or BI tool. ### What it does - Searches Gumtree by keyword and (optionally) category, location and price range - Paginates automatically until it hits your `maxResults` limit (30 per page) - Optionally opens each listing to collect posted date, seller name & rating, condition, full description and all photos - Returns absolute URLs, numeric prices and ISO timestamps - Works without any account, cookie or login ### How to scrape Gumtree data 1. Add the actor to your Apify account and open its input form. 2. Type a **Search Query** (for example `sofa`, `ford focus`, `labrador puppy`). 3. Optionally pick a **Category** (Cars, Property, Jobs, Pets, ...), set a **Location** slug (`london`, `manchester`), a price range, or a sort order. 4. Set **Max Results** to how many listings you want. 5. Leave **Fetch Full Listing Details** on for the richest data (posted date, seller, condition, all images) or turn it off for a faster list-only scrape. 6. Keep the **UK residential proxy** prefill — Gumtree is behind Cloudflare and a GB residential proxy gives the most reliable, geo-consistent results. 7. Click **Start**. When the run finishes, export the dataset as JSON, CSV, Excel or feed it through the Apify API. You can also run it on a schedule to track new listings, price changes or inventory in a category over time. ### Input | Field | Type | Required | Description | |-------|------|----------|-------------| | `searchQuery` | String | No | Keyword to search (e.g. `sofa`, `iphone 15`). Leave empty to browse a category. Defaults to `sofa` if nothing is provided. | | `category` | String | No | Top-level category: `all`, `for-sale`, `cars-vans-motorbikes`, `flats-houses`, `jobs`, `pets`, `community`, `services`, `business-services` | | `location` | String | No | Location slug to search around (e.g. `london`, `manchester`). Empty = UK-wide | | `sortBy` | String | No | `relevance` (default), `newest`, `cheapest`, `most-expensive` | | `minPrice` | Number | No | Minimum price filter (GBP) | | `maxPrice` | Number | No | Maximum price filter (GBP) | | `fetchDetails` | Boolean | No | Open each listing for full data (default `true`) | | `maxResults` | Integer | No | Maximum listings to scrape (default 100) | | `proxyConfiguration` | Object | No | Proxy settings — UK residential recommended | ### Output Each result contains: | Field | Type | Example | |-------|------|---------| | `itemId` | String | `"1508249780"` | | `name` | String | `"Dover Corner Sofa Bed (grey) with storage"` | | `description` | String | Full or preview listing text | | `price` | Number | `230` (null when the ad has no price) | | `currency` | String | `"GBP"` | | `location` | String | `"Leigh-on-Sea, Essex"` | | `postcode` | String | `"SS92QS"` | | `category` | String | `"Sofa Beds & Futons"` | | `condition` | String | `"As good as new"` | | `sellerType` | String | `"Private"` or `"Business"` | | `sellerName` | String | `"Graeme"` | | `sellerRating` | Number | `5` | | `sellerReviewCount` | Number | `12` | | `featured` | Boolean | `false` | | `imageUrl` | String | Primary image URL | | `imageUrls` | Array | All image URLs | | `postedAt` | String | `"2026-07-06T16:34:50.853Z"` | | `url` | String | Full listing URL | | `scrapedAt` | String | ISO 8601 timestamp | Fields marked as detail-only (`postcode`, `category`, `condition`, `sellerType`, `sellerName`, `sellerRating`, `sellerReviewCount`, `postedAt`, full `imageUrls` and description) are populated when **Fetch Full Listing Details** is on. ### Example output ```json { "itemId": "1508249780", "name": "Dover Corner Sofa Bed (grey) with storage", "description": "Dover Corner Sofa Bed (grey) with storage. Excellent condition, like new. Was £799 new. Overall: W260cm x D150cm x H91cm.", "price": 230, "currency": "GBP", "location": "Leigh-on-Sea, Essex", "postcode": "SS92QS", "category": "Sofa Beds & Futons", "condition": "As good as new", "sellerType": "Private", "sellerName": "Graeme", "sellerRating": 5, "sellerReviewCount": 12, "featured": false, "imageUrl": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/caf84dd68e7b47f19d_787a10856a4a/86", "imageUrls": [ "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/caf84dd68e7b47f19d_787a10856a4a/86", "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/a823f5d42d6d471895_0bdefb193239/86" ], "postedAt": "2026-07-06T16:34:50.853Z", "url": "https://www.gumtree.com/p/sofa-beds-futons/dover-corner-sofa-bed-grey-with-storage-/1508249780", "scrapedAt": "2026-07-06T18:23:25.396Z" } ```` ### Tips - **Free items** show `price: 0` — Gumtree has a lot of "*FREE*" listings, this is real data, not a parsing error. Ads with no fixed price return `null`. - **Category vs keyword**: you can browse a whole category by picking a `category` and leaving `searchQuery` empty. - **Faster runs**: turn off `fetchDetails` when you only need the list view (title, price, location, thumbnail, URL). That's one request per 30 listings. - **Deeper runs**: with `fetchDetails` on, each listing is one extra request, so scraping 1,000 listings is ~1,030 requests. Use a residential proxy pool. ### Cost estimate With **Fetch Full Listing Details** off, the actor makes roughly one request per 30 listings — very cheap. With details on (the default), it makes about one request per listing, so budget accordingly for large runs. Actual cost depends on your Apify plan and proxy choice. ### Limitations - Some ads list "Please contact" instead of a price — `price` is `null` there. - Seller rating/review counts are only present for sellers who have reviews. - Data is scraped from the public website and may change without notice. - Respect Gumtree's terms of service and use the data responsibly. ### Related scrapers Building a cross-market classifieds or marketplace dataset? Pair this with our other actors: - **2dehands Scraper** — Belgium's #1 classifieds (2dehands.be / 2ememain.be) - **Kleinanzeigen Scraper** — Germany's #1 classifieds - **Bazos Scraper** — Czech & Slovak classifieds - **AutoScout24 Scraper** — pan-European used cars - **Funda Scraper** — Dutch property listings ### Need this data on a schedule, or a custom version? We run this scraper as a managed service for businesses: scheduled runs, deduplication, delta detection, and delivery to your inbox, Google Sheets, or API — maintenance included. We can also build a custom version with your exact fields and filters, or combine multiple sources into one feed. See [studioamba.dev/services](https://studioamba.dev/services/) or email for a free data sample. We maintain 300+ European web scrapers and answer within one business day. # Actor input Schema ## `searchQuery` (type: `string`): Keyword to search (e.g. 'sofa', 'iphone 15', 'ford focus', 'labrador puppy'). Leave empty to browse a category. ## `category` (type: `string`): Optional top-level Gumtree category to restrict the search. ## `location` (type: `string`): Optional location slug to search around (e.g. 'london', 'manchester', 'birmingham'). Leave empty for UK-wide results. ## `sortBy` (type: `string`): How to sort the results. ## `minPrice` (type: `number`): Minimum price filter in pounds. ## `maxPrice` (type: `number`): Maximum price filter in pounds. ## `fetchDetails` (type: `boolean`): Open each listing to collect posted date, seller name & rating, condition, full description and all images. Slower but far richer. Turn off for a fast list-only scrape (title, price, location, image). ## `maxResults` (type: `integer`): Maximum number of listings to scrape across all pages (30 per search page). ## `proxyConfiguration` (type: `object`): Proxy settings. Gumtree is behind Cloudflare, so a UK residential proxy is strongly recommended for reliable, geo-consistent results. ## Actor input object example ```json { "searchQuery": "sofa", "category": "all", "sortBy": "relevance", "fetchDetails": true, "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } } ``` # 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 = { "searchQuery": "sofa", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }; // Run the Actor and wait for it to finish const run = await client.actor("studio-amba/gumtree-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 = { "searchQuery": "sofa", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "GB", }, } # Run the Actor and wait for it to finish run = client.actor("studio-amba/gumtree-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 '{ "searchQuery": "sofa", "maxResults": 20, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "GB" } }' | apify call studio-amba/gumtree-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=studio-amba/gumtree-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Gumtree Scraper — UK Classifieds & Marketplace Data", "description": "Scrape classified listings from Gumtree.com — the UK's #1 marketplace for cars, furniture, jobs and pets. Search by keyword, category, location and price. No login or cookies required.", "version": "0.1", "x-build-id": "umrj4SoTpNrrdJzmf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~gumtree-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-gumtree-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/studio-amba~gumtree-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-gumtree-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/studio-amba~gumtree-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-gumtree-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": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Keyword to search (e.g. 'sofa', 'iphone 15', 'ford focus', 'labrador puppy'). Leave empty to browse a category." }, "category": { "title": "Category", "enum": [ "all", "for-sale", "cars-vans-motorbikes", "flats-houses", "jobs", "pets", "community", "services", "business-services" ], "type": "string", "description": "Optional top-level Gumtree category to restrict the search.", "default": "all" }, "location": { "title": "Location", "type": "string", "description": "Optional location slug to search around (e.g. 'london', 'manchester', 'birmingham'). Leave empty for UK-wide results." }, "sortBy": { "title": "Sort By", "enum": [ "relevance", "newest", "cheapest", "most-expensive" ], "type": "string", "description": "How to sort the results.", "default": "relevance" }, "minPrice": { "title": "Minimum Price (GBP)", "minimum": 0, "type": "number", "description": "Minimum price filter in pounds." }, "maxPrice": { "title": "Maximum Price (GBP)", "minimum": 0, "type": "number", "description": "Maximum price filter in pounds." }, "fetchDetails": { "title": "Fetch Full Listing Details", "type": "boolean", "description": "Open each listing to collect posted date, seller name & rating, condition, full description and all images. Slower but far richer. Turn off for a fast list-only scrape (title, price, location, image).", "default": true }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to scrape across all pages (30 per search page).", "default": 100 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings. Gumtree is behind Cloudflare, so a UK residential proxy is strongly recommended for reliable, geo-consistent results." } } }, "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 } } } } } } } } } } ```