Gumtree Search Suggestions API
What the search box suggests as someone types, best first.
GET /v1/gumtree/search/suggestions1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/search/suggestions?query=bik returns data.suggestions, up to ten, each with text and the categories the site proposes for it (id, name and slug). Pass a suggestion's text as query and a category slug as category to GET /v1/gumtree/search.
Text with nothing to suggest returns an empty list.
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 Suggestions API FAQ
How many suggestions come back?
Up to ten, best first.
What are the categories on a suggestion?
Categories the site proposes for that search, for example Bike Racks for bike rack. Use the slug as the category of a search.
Is the list the same for everyone?
Yes; suggestions do not depend on a user or a place.
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
- Trending searchesGET /v1/gumtree/trending
- CategoriesGET /v1/gumtree/categories
- Category filtersGET /v1/gumtree/filters