Skip to main content
GET
Search Listings
Search Gumtree listings across every vertical — For Sale, Motors, Property, Jobs, Services, Pets and Community — on gumtree.com (UK), gumtree.com.au (Australia) or gumtree.co.za (South Africa). Returns 25 (UK) or 24 (AU) listings per page plus any pinned featured ads, up to 50 pages, or 20 (ZA) per page across the first 375 matches. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
default:"uk"
Which Gumtree: uk (gumtree.com, GBP), au (gumtree.com.au, AUD) or za (gumtree.co.za, ZAR). Separate sites — category, location and listing ids from one market mean nothing in another.
string
Search keywords, e.g. mountain bike. Optional — omit it to browse a whole category.
string
default:"all"
  • uk: category slug, e.g. cars, for-sale, property-to-rent, jobs, pets, bicycles.
  • au: numeric category id, e.g. 18320 (cars), 18560 (bicycles).
  • za: category ref, e.g. p6dnh (Cars & Bakkies), l4dq6 (Vehicles).
Browse the tree with /categories for the same market. An unknown id or ref is a 400.
string
Omit to search the whole country.
  • uk: location slug (london, manchester), town name or full UK postcode (SW1A 1AA).
  • au: numeric location id, e.g. 3003435 (Sydney Region).
  • za: location ref, e.g. dkp8y (Gauteng), pfw8k (Cape Town).
Resolve a place with /locations/autocomplete. An unknown location is a 400 — the sites would otherwise silently search the whole country.
number
Radius around location, greater than 0 and up to 1000: miles (uk) or km (au, needs a location). Not supported for za.
integer
Minimum price in the market’s currency. uk: needs a category other than all.
integer
Maximum price in the market’s currency. uk: needs a category other than all.
string
default:"relevance"
Result ordering. One of relevance, date, price_asc, price_desc, distance. distance needs uk, or au with a location.
string
private or trade. trade covers dealers, letting agents and recruiters. uk and za only — on au pass it as a filter instead (e.g. cars.forsaleby_s:ownr).
boolean
default:"false"
uk only: only ads the seller marked urgent.
boolean
default:"false"
uk only: only ads with photos.
string
Category-specific filters as comma-separated key:value pairs. Range filters take min_<key>:<value> / max_<key>:<value>. Keys differ per market — discover them, with their values, from /search/filters for the same market and category:
  • uk: vehicle_make:bmw,vehicle_fuel_type:petrol,min_vehicle_mileage:10000. Repeat a key to select several values (vehicle_make:bmw,vehicle_make:audi).
  • au: cars.carmake_s:toyota,min_cars.caryear_i:2015,priceType:NEGOTIABLE.
  • za: make:toyota,model:hilux,fuelType:diesel,max_mileageKm:100000,min_year:2015 — on Cars & Bakkies: make, model, bodyType, driveType, transmission, fuelType, colour, and the ranges year and mileageKm. Values are case-insensitive (toyota = TOYOTA). One value per key. A key gumtree.co.za does not know is a 400; a value it does not know matches nothing.
integer
default:"1"
Result page, 1–50 (za: results past the 375th are not reachable; such a page comes back empty).

Response

string
uk, au or za.
string
Echo of the requested keywords.
string
Category the search ran in — slug (uk), id (au) or ref (za).
string
e.g. Cars.
integer | string
Gumtree category id — an integer on uk / au, a ref string on za (e.g. p6dnh).
string
Location slug, postcode, id or ref searched.
string
e.g. United Kingdom, Sydney Region.
number
Radius (miles uk, km au), when one was applied.
string
The sort that was applied.
integer
The page returned.
integer
Pages available for this search (at most 50; za: at most 19).
integer
Total matching listings Gumtree reports.
integer
Listings on this page, featured ads included.
string
GBP, AUD or ZAR.
string
The Gumtree search URL equivalent to this request.
CategoryFacet[]
Sub-categories of the result set with counts — id, name, slug, count. Feed a slug (uk) or id (au, za — a ref like p6dnh there) back in as category to drill down.
ListingSummary[]
Listing cards.

Example

Response

Search behaviour

UK price filters need a category. gumtree.com ignores min_price / max_price when category is all, so that combination is a 400 — pick a category (for-sale, cars, bicycles …) to filter by price.
Gumtree pins paid featured ads (is_featured: true) above the chosen sort order — up to 5 in the UK and up to 6 in Australia. Skip them if you need a strict date or price ordering.
A result set holds at most 50 pages (za: the first 375 matches, 19 pages), whatever total_results reports. To collect more, narrow the search — by sub-category (category_facets), location and distance, price band, or filters. A page past the end comes back with no listings and is not billed.

Market support

A parameter a market does not support is a 400, not silently ignored.

Postcode radius

Pass a full UK postcode as location with a distance in miles:

Category filters

Range filters (type: enum_range) take min_ / max_ + the filter key, e.g. min_vehicle_mileage:10000,max_vehicle_mileage:50000. List every key and value for a category with /search/filters.

South Africa

Petrol Toyotas in Gauteng between R50,000 and R300,000, cheapest first (p6dnh = Cars & Bakkies, dkp8y = Gauteng) — 241 results on 2026-10-13:
Toyotas in Gauteng, newest first (market=za&category=p6dnh&location=dkp8y&filters=make:toyota&sort=date), abridged:
total_results is the full count, but gumtree.co.za only pages through the first 375 matches: total_pages is at most 19.

Australia

Mountain bikes in the Sydney Region (18560 = Bicycles, 3003435 = Sydney Region), within 25 km:
A listing card from an Australian cars search (market=au&category=18320), abridged:
On au, sell-by and price type are filters: filters=cars.forsaleby_s:ownr for private sellers, priceType:NEGOTIABLE for negotiable prices.

Errors