Gumtree UK Classified Listings Scraper

Here is one real result, with every field the actor returns:

{
  "imageUrl": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/e50d3abf48c341bb85_e02ee6e4df21/86",
  "title": "Ford, FOCUS, Hatchback, 2016, Manual, 1999 (cc), 5 doors",
  "url": "https://www.gumtree.com/p/ford/ford-focus-hatchback-2016-manual-1999-cc-5-doors/1801195698",
  "listingId": "1801195698",
  "price": "£9,349",
  "priceAmount": 9349,
  "priceCurrency": "GBP",
  "pricePeriod": null,
  "location": "Stoke-on-Trent, Staffordshire",
  "category": null,
  "description": null,
  "sellerType": "Private",
  "year": "2016",
  "mileage": "88,142 miles",
  "fuelType": "Petrol",
  "engineSize": "1,999 cc",
  "attributes": "201688,142 milesPrivatePetrol1,999 cc",
  "searchQuery": "ford focus",
  "searchLocation": null,
  "source": "Gumtree UK",
  "observedAt": "2026-08-14T08:20:10.161Z",
  "error": null,
  "aiListingSummary": "This 2016 Ford Focus hatchback is being sold by a private seller for £9,349. It has a petrol engine with a capacity of 1,999 cc and has covered 88,142 miles.",
  "aiFeatures": ["Hatchback", "Manual transmission", "5 doors", "2016 model year", "88,142 miles", "Petrol engine", "1,999 cc"],
  "aiCondition": "used",
  "aiItemType": "car"
}

The most complete Gumtree UK classifieds scraper available. It returns every field a listing exposes (title, price parsed into amount and currency, location, seller type, image and listing ID), captures vehicle attributes like year, mileage, fuel type and engine size, and adds optional AI add-ons for a buyer-facing summary and structured features and condition, so you get clean, comparable listings.

📥 Input · 📤 Output · 💰 Pricing · ▶️ Examples

Table of contents

• What it does
• Quickstart
• Input reference
• Output reference
• Example output record
• Run via API and CLI
• Fetch results
• Billing and limits
• FAQ and troubleshooting

What it does

The actor searches Gumtree UK for each keyword you provide, optionally restricted to categories and UK locations, paginates through the matching classifieds, and writes one normalized record per listing to the run's dataset. Each record carries the title, the price parsed into a numeric amount and currency, the location, seller type, image and listing ID, plus vehicle attributes (year, mileage, fuel type, engine size) when the listing is a car. Missing source values are returned as null, never invented.

Two optional AI add-ons run only on paid Apify plans and only charge when they produce output: aiListingSummary writes a short buyer-facing summary, and aiFeatures extracts structured features, a condition and an item type.

Quickstart

Open the actor, paste this into the input, and press Run. It searches Ford Focus listings with both AI add-ons.

{
  "searchQueries": ["ford focus"],
  "maxListings": 10,
  "withAiListingSummary": true,
  "withAiFeatures": true
}

Add categories (for example ["cars"]) and locations (for example ["london"]) to narrow the search, or leave searchQueries empty to browse a whole category.

Input reference

Field	Type	Required	Default	Description
searchQueries	string[]	no	["iphone"]	One or more keywords to search, for example sofa, ford focus. Each keyword runs its own search. Leave empty to browse a category.
categories	string[]	no	["for-sale"]	Restrict to sections. Valid values: for-sale, cars, property-for-sale, property-to-rent, jobs, business-services, pets, community.
locations	string[]	no	["london"]	UK town or city names to filter by, for example manchester, leeds. Leave empty for nationwide results.
maxListings	integer	no	10	Maximum listings to collect across the whole run.
withAiListingSummary	boolean	no	false	Paid add-on. Short buyer-facing AI summary of each listing. Requires a paid plan.
withAiFeatures	boolean	no	false	Paid add-on. AI-extracted features, condition and item type. Requires a paid plan.

Output reference

One dataset item per listing. Types: string, number, string[], or null when the source value is absent.

Field	Type	Description
imageUrl	string	Primary listing image URL, or null.
title	string	Listing title.
url	string	Direct Gumtree listing URL.
listingId	string	Gumtree listing ID (unique per listing).
price	string	Price as displayed, including currency symbol.
priceAmount	number	Numeric price parsed from price, or null.
priceCurrency	string	Currency code, for example GBP.
pricePeriod	string	Billing period for rentals or jobs (for example per month), or null.
location	string	Listing location.
category	string	Category, or null when not exposed on the card.
description	string	Listing description text, or null.
sellerType	string	Private or Trade, or null.
year	string	Vehicle year, or null.
mileage	string	Vehicle mileage, or null.
fuelType	string	Vehicle fuel type, or null.
engineSize	string	Vehicle engine size, or null.
attributes	string	Raw concatenated attribute string from the card, or null.
searchQuery	string	The keyword that produced this listing.
searchLocation	string	The location filter that produced this listing, or null.
source	string	Always Gumtree UK.
aiListingSummary	string	AI buyer-facing summary (add-on), else absent.
aiFeatures	string[]	AI-extracted features (add-on), else absent.
aiCondition	string	AI condition, for example used (add-on), else absent.
aiItemType	string	AI item type, for example car (add-on), else absent.
observedAt	string	ISO 8601 timestamp of when the record was collected.
error	string	null on success. On a failed run, a single item with a populated error field is written instead.

Example output record

Real record from a live run (input {"searchQueries":["ford focus"],"withAiListingSummary":true,"withAiFeatures":true,"maxListings":3}):

{
  "imageUrl": "https://img.gumtree.com/ePR8PyKf84wPHx7_RYmEag/e50d3abf48c341bb85_e02ee6e4df21/86",
  "title": "Ford, FOCUS, Hatchback, 2016, Manual, 1999 (cc), 5 doors",
  "url": "https://www.gumtree.com/p/ford/ford-focus-hatchback-2016-manual-1999-cc-5-doors/1801195698",
  "listingId": "1801195698",
  "price": "£9,349",
  "priceAmount": 9349,
  "priceCurrency": "GBP",
  "location": "Stoke-on-Trent, Staffordshire",
  "sellerType": "Private",
  "year": "2016",
  "mileage": "88,142 miles",
  "fuelType": "Petrol",
  "engineSize": "1,999 cc",
  "searchQuery": "ford focus",
  "source": "Gumtree UK",
  "aiListingSummary": "This 2016 Ford Focus hatchback is being sold by a private seller for £9,349. It has a petrol engine with a capacity of 1,999 cc and has covered 88,142 miles.",
  "aiFeatures": ["Hatchback", "Manual transmission", "5 doors", "Petrol engine"],
  "aiCondition": "used",
  "aiItemType": "car",
  "observedAt": "2026-08-14T08:20:10.161Z",
  "error": null
}

Run via API and CLI

Start a run and wait for it to finish, then read the dataset. Replace <TOKEN> with your Apify API token.

Run synchronously and get dataset items in one call:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~gumtree-uk-scraper/run-sync-get-dataset-items?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["ford focus"],"categories":["cars"],"locations":["manchester"],"maxListings":25}'

Start a run asynchronously:

curl -X POST "https://api.apify.com/v2/acts/scrapers_lat~gumtree-uk-scraper/runs?token=<TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"searchQueries":["sofa","iphone"],"maxListings":100}'

Apify CLI:

apify call scrapers_lat/gumtree-uk-scraper \
  --input '{"searchQueries":["ford focus"],"maxListings":50}'

Fetch results

Every run writes to a dataset. Fetch items as JSON, CSV, or Excel by changing format:

# JSON
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=json"

# CSV
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&clean=true&format=csv"

# Paginate large datasets
curl "https://api.apify.com/v2/datasets/<DATASET_ID>/items?token=<TOKEN>&offset=1000&limit=1000"

<DATASET_ID> is returned as defaultDatasetId in the run object. Use offset and limit to page through large result sets. clean=true drops empty and internal fields.

Billing and limits

• Pay per result. You are charged per listing returned (result event). See the pricing tab for the current per-result price.
• Add-ons. The AI listing summary and AI features add-ons are priced separately and charge only when they produce output.
• No charge on failure. If a run errors, the actor writes a single item with a populated error field and does not charge for it. Empty runs cost nothing.
• Spend cap respected. Set maxTotalChargeUsd on the run; once reached, the actor stops emitting and charging further billable results.
• Free Apify plans are capped at 10 listings per run. Upgrade for higher maxListings.

FAQ and troubleshooting

A run returned 0 listings. Why? The keyword, category or location matched nothing on Gumtree. Broaden the keyword, remove a categories or locations filter, or check spelling. Zero-result runs are not charged.

Why is priceAmount null but price present? The listing showed non-numeric pricing (for example "POA" or "Free"). The raw price is kept as displayed and priceAmount is null when no number can be parsed.

Why are vehicle fields like mileage null? The listing is not a vehicle, or those attributes were not shown on the card. Missing source values are returned as null, never invented.

Why is description null? Gumtree search cards often omit the full description. The listing url links to the full page.

Why did the AI fields not appear? The AI add-ons require a paid Apify plan and are off by default. Enable withAiListingSummary or withAiFeatures on a paid plan. They charge only when output is produced.

Is this an official Gumtree tool? No. This actor is independent and not affiliated with Gumtree. It reads only publicly available classified listings.

Related scrapers

• Kijiji Canada Scraper: Canadian classified listings.
• Craigslist Listings Scraper: US classified listings.
• OLX Scraper: OLX marketplace listings.
• Checkatrade UK Scraper: UK trades and services directory.
• Rightmove UK Real Estate Scraper: UK property listings.

More scrapers at scrapers.lat

Built and maintained by scrapers.lat, where we publish scrapers for US and Latin American public platforms: company registries, government data, finance, e-commerce and more. Browse the catalog or request a custom scraper at scrapers.lat.

---

Independent tool, not affiliated with Gumtree. Accesses only publicly available classified listings.