Gumtree Scraper

An Apify actor for scraping listings from Gumtree. It extracts data from category pages, search results, and individual listing detail pages.

Overview

This actor takes Gumtree URLs and returns structured data for each listing. It handles categories, searches, filters, and sorting. You can scrape overview pages or enable detailed scraping for individual listings.

Key Features

• Scrapes all Gumtree listing categories, searches, filters, and sorting options.
• Option to scrape detailed information from individual listing pages.
• Configurable limits on the number of results per URL.
• Built-in retry logic for handling request failures or blocks.
• Proxy support for avoiding IP-based blocking.

How to Use

Configure the actor using the input fields below. The primary requirement is providing one or more Gumtree URLs.

Input

The actor is configured via these input parameters:

• Start URLs: A list of Gumtree URLs to scrape. This can be a category page, a search results page, or a specific listing URL. You can copy and paste the URL directly from your browser after applying any desired filters or sorting.
• Scrape detail pages: When enabled, the actor will navigate to and scrape additional data from each listing's individual page. This only applies when Start URLs point to category or search pages.
• Max results per URL: Limits the number of listings scraped from each provided URL. Default is 25, maximum is 1500.
• Max retries upon failure: (Optional) The number of times to retry a failed request (e.g., due to network errors or blocks).
• Proxy configuration: (Optional but recommended) Use a proxy if your requests are being blocked by Gumtree. Check the actor's log for block messages.

Output

The actor outputs an array of JSON objects, one for each scraped listing. The data structure includes metadata, core listing information, and details if the detail page was scraped.

Example Output:

[
  {
    "_startUrl": "https://www.gumtree.com/search?search_category=cars",
    "_position": 1,
    "id": 1496322781,
    "title": "2014 Land Rover Discovery 3.0 SDV6 HSE Luxury 5dr Auto ESTATE Diesel Automatic",
    "price": "£11,999.00",
    "postedDate": "2025-05-05",
    "imageUrl": "https://imagedelivery.net/.../image.jpg",
    "location": "Tile Cross, West Midlands",
    "shortDescription": "Land Rover Discovery Sdv6 Hse Luxury, 7 seats...",
    "status": "LIVE",
    "attributes": [
      { "name": "Estimated Mileage", "value": "134356" },
      { "name": "Air Conditioning", "value": "Yes" }
    ]
  }
]

Key output fields include:
* id: The Gumtree listing ID.
* title, price, location: Core listing details.
* postedDate: When the ad was posted.
* imageUrl & additionalImageUrls: Links to listing images.
* shortDescription: The main ad text.
* attributes: An array of specific details (e.g., mileage, features for vehicles).
* Metadata fields like _startUrl (source URL) and _position (rank on the page).