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

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

Output

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

API usage

Start a run with cURL:

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:

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:

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:

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

MCP JSON configuration example:

{
  "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.

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.