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

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

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

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

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
• Poshmark Sold Listings Scraper
• 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.