Gumtree Similar Listings API
The similar listings a listing page shows, usually ten, in the same shape as search results.
GET /v1/gumtree/listings/{listingId}/similar1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/listings/{listingId}/similar returns data.listings, the similar listings the listing page shows, usually ten, each with id, title, url, price, location, postcodeDistrict, photos and attributes. The listing itself is never in the list.
Use it to find comparable items and prices for a listing. An expired or removed listing answers lookupStatus: not_found with 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 Similar Listings API FAQ
How many similar listings come back?
The ones the listing page shows, usually ten. There is no paging.
Are similar listings in the same category?
Usually, as the site picks them by category and keywords; check categoryId on each row.
Can I get full details of a similar listing?
Yes. Pass its id to GET /v1/gumtree/listings/{listingId}.
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}
- 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