Gumtree Seller API
A seller's public profile: rating, reviews, feedback and how much they list.
GET /v1/gumtree/sellers/{sellerId}1 credit Failed requests are free Found, empty and not-found answers are all charged
About this endpoint
GET /v1/gumtree/sellers/{sellerId} takes the 32-character id in a profile URL, also returned as seller.sellerId on every listing. data.seller carries sellerId and the numeric sellerUserId, name, postingSince, lastActiveAt, liveListings (for sale now), itemsPosted and itemsPostedByCategory (the selling history, including items no longer for sale), rating (average, total and a count per star), reviews (reviewer name, rating, date, whether they bought or sold, category and feedback tags), feedbackSummary and badges.
Use GET /v1/gumtree/sellers/{sellerId}/listings for the seller's live listings. 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 Seller API FAQ
Where do I find a seller id?
On any listing, listing.seller.sellerId, or in a profile URL: gumtree.com/profile/account/<sellerId>. The numeric sellerUserId on search results is a different id the seller routes don't take.
Are reviews from buyers or sellers?
Both. reviewerRole says whether the reviewer bought from or sold to this seller.
Does it return contact details?
No phone numbers or emails are returned; Gumtree keeps them behind a login.
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
- 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