Skip to main content
GET
Search Listings
Search gumtree.com listings across every vertical — For Sale, Motors, Property, Jobs, Services, Pets and Community. Returns ~25–30 listings per page, up to 50 pages. Credits: 5

Authorization

string
required
Your ScrapeBadger API key.

Query Parameters

string
Search keywords, e.g. mountain bike. Optional — omit it to browse a whole category.
string
default:"all"
Category slug, e.g. cars, for-sale, property-to-rent, jobs, pets, bicycles. Browse every slug with /categories.
string
default:"uk"
Location slug (london, manchester), town name or full UK postcode (SW1A 1AA). uk searches nationwide. Resolve a place with /locations/autocomplete.
number
Radius in miles around location, greater than 0 and up to 1000.
integer
Minimum price in GBP. Needs a category other than all.
integer
Maximum price in GBP. Needs a category other than all.
string
default:"relevance"
Result ordering. One of relevance, date, price_asc, price_desc, distance.
string
private or trade. trade covers dealers, letting agents and recruiters.
boolean
default:"false"
Only ads the seller marked urgent.
boolean
default:"false"
Only ads with photos.
string
Category-specific filters as comma-separated key:value pairs, e.g. vehicle_make:bmw,vehicle_fuel_type:petrol,min_vehicle_mileage:10000. Repeat a key to select several values (vehicle_make:bmw,vehicle_make:audi). Discover the keys and values for a category with /search/filters.
integer
default:"1"
Result page, 1–50.

Response

string
Echo of the requested keywords.
string
Category slug the search ran in.
string
e.g. Cars.
integer
Gumtree category id.
string
Location slug or postcode searched.
string
e.g. United Kingdom.
number
Radius in miles, when one was applied.
string
The sort that was applied.
integer
The page returned.
integer
Pages available for this search (at most 50).
integer
Total matching listings Gumtree reports.
integer
Listings on this page.
string
The gumtree.com search URL equivalent to this request.
CategoryFacet[]
Sub-categories of the result set with counts — name, slug, count. Feed a slug back in as category to drill down.
ListingSummary[]
Listing cards.

Example

Response

Search behaviour

Price filters need a category. min_price / max_price have no effect when category is all — pick a category (for-sale, cars, bicycles …) to filter by price.
Gumtree pins up to 5 paid featured ads (is_featured: true) above the chosen sort order. Skip them if you need a strict date or price ordering.
A result set holds at most 50 pages (~1,500 listings), whatever total_results reports. To collect more, narrow the search — by sub-category (category_facets), location and distance, price band, or filters.

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.

Errors