Gumtree Trending Searches API
The popular searches the site shows for the UK or for one area.
GET /v1/gumtree/trending1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/trending returns data.searches, up to 30 search words, most popular first. Pass locationId from GET /v1/gumtree/locations for one area, for example 10000352 for Manchester; the default is the whole UK.
An unknown location id answers lookupStatus: not_found with no searches.
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 Trending Searches API FAQ
How often does the list change?
It follows what people search for, so it moves through the day; responses are cached for up to 15 minutes.
Can I get trending searches for a town?
Yes. Find the town's id with GET /v1/gumtree/locations and pass it as locationId.
How do I see listings for a trending search?
Pass the word as query to GET /v1/gumtree/search.
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
- CategoriesGET /v1/gumtree/categories
- Category filtersGET /v1/gumtree/filters