Gumtree Search API
The listings Gumtree shows for a search, up to about 33 a page, with totals and narrower categories.
GET /v1/gumtree/search1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/search takes query, category (a slug such as cars), location (a place slug, a postcode district or a full postcode), distance in miles, minPrice, maxPrice and sort. Pass a query, a category, or both. Each listing has id, title, url, price, the start of its description, postedAt, location, postcodeDistrict, photos, attributes, isTrade, featured and favouriteCount.
data.totalResults is the number of matches the site reports, data.categories the narrower categories with their counts and data.relatedSearches the related searches the page suggests. Follow page.nextCursor with the same filters, up to page 50. An unknown category or place 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 Search API FAQ
Can I search one town or postcode?
Yes. Set location to a place slug such as london or manchester, a postcode district such as M1, or a full postcode, and add distance in miles for a radius. Use GET /v1/gumtree/locations to find the right place.
How do I sort by price or date?
Set sort to date for the newest first, price_lowest_first or price_highest_first for price, or distance for the nearest first when you give a location. The default is relevance.
Why does a featured listing appear on page 1?
Featured listings are paid placements the site mixes into the results; they carry featured: true. A listing shown on one page is never repeated on the next page you fetch with the cursor.
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. Each paginated page is a separate billed request.
Other Gumtree endpoints
- 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
- Category filtersGET /v1/gumtree/filters