Gumtree Location Areas API
Walk the location tree from the whole UK down to districts.
GET /v1/gumtree/locations/children1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/locations/children returns data.location and its children, each with id, name, slug and hasChildren. Start with no locationId for the whole UK (England, Scotland, Wales, Northern Ireland and the islands), then pass a child's id to go down.
The slug is what GET /v1/gumtree/search takes as location. An unknown id 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 Location Areas API FAQ
How deep does the tree go?
From the UK to nations, counties and cities, then districts such as Ancoats, Manchester, which have no children.
Which value goes into search?
The slug, for example manchester or ancoats, goes into the location parameter of search.
Does the tree change?
Rarely; responses are cached for a day.
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