Skip to main content
GET
Get Search Filters
List every filter Gumtree offers for a category — make, model, fuel type, mileage range, bedrooms, job type and so on — with a live result count per value, plus the available sort orders and search radii. Feed a filter’s key and an option’s value straight back into /search as filters=key:value. Filter keys are each site’s own, so always ask with the market you will search. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
default:"uk"
uk (gumtree.com), au (gumtree.com.au) or za (gumtree.co.za).
string
default:"all"
uk: category slug, e.g. cars, property-to-rent, jobs. au: numeric category id, e.g. 18320 (cars). za: category ref, e.g. p6dnh (Cars & Bakkies). Filters are category-specific, so pass the category you intend to search.
string
uk: location slug, town name or UK postcode. au: numeric location id. za: location ref, e.g. dkp8y (Gauteng). Scopes the counts. Omit for the whole country.
string
Optional keywords to scope the counts.
string
za only: filters already applied, as key:value pairs. The counts follow them — e.g. make:toyota narrows the model filter to Toyota’s models (HILUX, COROLLA …).

Response

string
uk, au or za.
string
Category slug (uk), id (au) or ref (za).
string
e.g. Cars.
integer
Matching listings before any filter.
SearchFilter[]
Filters for the category.
SortOption[]
Sort orders Gumtree offers for the category — value, label.
number[]
Search radius values in miles (uk). Empty for au (any km value up to 1000 is accepted) and za (no radius search).
CategoryFacet[]
Sub-categories with counts — id, name, slug, count.

Example

Response
sort_options values are the ones /search accepts as sort — pass them straight back.

Using a filter in /search

price, seller_type, photos_filter and urgent_filter also appear in this list for uk; on /search use the dedicated min_price / max_price, seller_type, with_photos and urgent_only parameters for them.

South Africa

With a make applied, the counts — and the models listed — narrow to that make (Toyota cars in Gauteng). The make filter itself keeps every make’s count so you can switch:
Response (abridged)
South African keys on Cars & Bakkies (p6dnh): make, model, bodyType, driveType, transmission, fuelType, colour, and the ranges year (min_year / max_year) and mileageKm (min_mileageKm / max_mileageKm). Each key takes one value. Price and seller type are the /search parameters min_price / max_price and seller_type, so they are not listed here.

Australia

Australian keys are namespaced by category, e.g. for cars (18320): cars.carmake_s (make), cars.carbodytype_s, cars.caryear_i (a range — min_cars.caryear_i / max_cars.caryear_i), cars.fueltype_s, cars.cartransmission_s, cars.forsaleby_s (private or dealer) and priceType (FIXED, NEGOTIABLE …).
Use this endpoint to size a search before paging it: the per-value counts tell you which filters bring a result set under the 50-page ceiling of /search.

Errors