Gumtree Filters API
Every filter a category's search page offers, with its options.
GET /v1/gumtree/filters1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/filters?category=cars returns data.filters in the order the site shows them, each with key, label, type, options (value, label and count across the UK) and, for ranges, minOptions, maxOptions, minKey and maxKey. data.sortOptions and data.distanceOptions list the sort orders and search radii.
An unknown category slug answers lookupStatus: not_found.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Gumtree Filters API FAQ
What filter types are there?
enum (pick one), multiple_selection, boolean switches, enum_range (low and high picked from lists, such as mileage) and range_freeform (any numbers, such as price).
Can I use these filters in search?
Search takes category, location, distance, minPrice, maxPrice and sort. The other filters describe the category and its counts.
Are the counts live?
They are the counts the category's page shows across the UK; responses are cached for an hour.
How many credits does a request cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth.
Other Gumtree endpoints
- Search listingsGET /v1/gumtree/search
- ListingGET /v1/gumtree/listings/{listingId}
- Similar listingsGET /v1/gumtree/listings/{listingId}/similar
- SellerGET /v1/gumtree/sellers/{sellerId}
- Seller listingsGET /v1/gumtree/sellers/{sellerId}/listings
- Search suggestionsGET /v1/gumtree/search/suggestions
- Trending searchesGET /v1/gumtree/trending
- CategoriesGET /v1/gumtree/categories