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. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
default:"all"
Category slug, e.g. cars, property-to-rent, jobs. Filters are category-specific, so pass the category you intend to search.
string
default:"uk"
Location slug, town name or UK postcode. Scopes the counts.
string
Optional keywords to scope the counts.

Response

string
Category slug.
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.
CategoryFacet[]
Sub-categories with counts — 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; on /search use the dedicated min_price / max_price, seller_type, with_photos and urgent_only parameters for them.
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