Gumtree Locations API
Turn typed text into Gumtree places, postcode districts and postcodes.
GET /v1/gumtree/locations1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/locations?query=manch returns data.locations, best first, each with id, name, type (location, outcode or postcode), city, latitude and longitude of its centre.
Use the id as the locationId of trending searches and location areas, and a place's slug from location areas or a postcode as the location of a search. Text that matches nothing 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 Locations API FAQ
Can I look up a postcode?
Yes. A full postcode such as SW1A 1AA returns one postcode result, and a district such as M1 returns an outcode result.
Is there a nearest-location lookup from coordinates?
No. Gumtree offers no lookup from coordinates; search by place name or postcode instead.
How many results come back?
The few the site offers for the text, best first.
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