Gumtree Scraper by ScrapeBadger — Overview

​

Scraper API for Gumtree

​

Features

• Every vertical — For Sale, Motors (cars, vans, motorbikes), Property (to rent, for sale, flatshare), Jobs, Services, Pets and Community. ~25–30 listings per search page, up to 50 pages.
• Postcode-radius search — location takes a town slug, a town name or a full UK postcode (SW1A 1AA), plus a distance in miles.
• Category filters with live counts — /search/filters lists every filter Gumtree offers for a category (make, fuel type, mileage range, bedrooms …) with the result count per value; pass them back to /search as filters=key:value.
• Full vehicle spec on Motors listings — make, model, year, mileage, fuel, transmission, body type, engine size and power, MPG, CO2, insurance group, 0–62, top speed, previous keepers, the registration where shown, and the history-check flags (not stolen, not written off, not scrapped).
• Seller profile — private or trade, verified-business status with the checks Gumtree ran, rating with per-star breakdown, posting since, last active, total listings and listings by category, and the masked phone number.
• Promotion flags — is_featured, is_urgent, is_bumped_up, is_standout and favourite_count on every listing.
• Dates in both forms — every timestamp ships as Unix seconds (*_utc) and ISO 8601 (*_at). Listing detail separates created_at (first posted) from posted_at (moves on a bump).

​

Coverage

​

Credit Costs

​

Quickstart

curl "https://scrapebadger.com/v1/gumtree/search?category=cars&location=manchester&distance=30&filters=vehicle_make:bmw" \
  -H "X-API-Key: YOUR_API_KEY"

const res = await fetch(
  "https://scrapebadger.com/v1/gumtree/search?" +
    new URLSearchParams({
      category: "cars",
      location: "manchester",
      distance: "30",
      filters: "vehicle_make:bmw",
    }),
  { headers: { "X-API-Key": process.env.SCRAPEBADGER_API_KEY } },
);
const data = await res.json();
console.log(data.total_results, "listings");

import requests

res = requests.get(
    "https://scrapebadger.com/v1/gumtree/search",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "category": "cars",
        "location": "manchester",
        "distance": 30,
        "filters": "vehicle_make:bmw",
    },
)
print(res.json()["total_results"], "listings")

​

Typical workflow

1. Pick a category — /categories or /autocomplete give you the slug (cars, property-to-rent, sofas-couches …).
2. Discover its filters — /search/filters returns each filter’s key and values with live counts.
3. Search — /search with category, location + distance, price band and filters.
4. Enrich — /listings/{id} for the full description, attributes and seller, and /listings/{id}/seller-listings for everything else that seller has listed.

​

Limits

• 50 pages per result set (~1,500 listings). To go deeper, narrow by sub-category, location and distance, price band or filters.
• Price filters need a category. min_price / max_price have no effect with category=all.
• Featured ads are pinned. Gumtree places up to 5 paid featured ads (is_featured) above the chosen sort order.
• Seller listings are keyed by a listing. Pass any listing id of the seller to /listings/{id}/seller-listings; there is no separate seller lookup.

​

Errors